Documentation · v0.1

How EQUINOX keeps the line.

Everything the agent reads, every formula it runs, every rule it follows and every transaction your wallet signs, down to the contract function. If this page and the code ever disagree, the code wins and this page is wrong.

01 · STARTOverview

EQUINOX is a balance agent on Robinhood Chain (chain id 4663). It splits a portfolio into two sides and keeps the line between them:

Day side · ~80%Stock tokens and USDG

Tokenized SPY, QQQ, NVDA, GLD and more, plus the USDG dollar. The steady part, traded on Uniswap v3.

Night side · ~20%Pons memecoins

Memes still on their Pons bonding curve that pass a rug scan. The loud part, traded on the curve itself.

Every five minutes six readings (memecoin volume, buying pressure, launch rate, ETH, the stock tokens and the tone of the news) become a season score from 1 to 10. The score decides when to move money between the sides. A target you choose decides how much.

  • Midsummer (≥ 8): the night market is hot. Harvest night-side profit into the day side, down to the target.
  • Long Night (≤ 3): the night market is cold. Plant the night side back with day money, up to the target.
  • Equinox (in between): hold. Move only if the split drifts far from the target.

The idea is old and simple: sell some of what ran hot, buy back when it is cold, and keep a fixed amount of risk. EQUINOX adds a measured view of how hot, so it harvests when there is froth and plants when there is fear, instead of on a calendar.

i

EQUINOX never holds funds. It reads your wallet, builds a plan, and your own wallet signs every step. Code computes the score, the rule and the picks; an AI model only writes the short note under the number.

02 · STARTQuick start

Get a wallet on Robinhood Chain

Any EIP-1193 wallet (MetaMask, Rabby, Coinbase Wallet, OKX…). The terminal offers to add and switch to Robinhood Chain (chain id 4663) for you.

Fund it

Some ETH for gas (EQUINOX always leaves 0.002 ETH untouched), plus whatever you want balanced: USDG, stock tokens, Pons memecoins or plain ETH you plan to put to work.

Open the terminal and sign in

Go to /app → My balance, press Connect & sign in, pick your wallet and sign a plain text message. No transaction, no gas, no approval.

Set your rule

Pick a night target (default 20%), a drift band, your day mix and slippage. Defaults are sensible; change them only if you mean to.

Read the plan

The terminal shows your day side, night side, night share vs target, the zone and the decision (hold, harvest or plant) with every step listed in order.

Sign the steps

Press Sign the steps. Each swap is re-quoted on chain the moment before your wallet opens. Approve, swap, next. Press Stop any time.

Just curious? The Season, Record and Picks tabs are public, and Look at any wallet shows the plan for any address with no sign-in. The CLI does the same from a terminal.

03 · STARTKey terms

Day side
USDG plus Robinhood stock tokens held in the wallet, valued at each token's own pool mid price.
Night side
Pons memecoins still on their bonding curve, valued at curve mid (ETH reserve ÷ token reserve × ETH price).
Night share
night ÷ (day + night). ETH in the wallet is not part of either side.
Target
The night share you want, 0–50%. Default 20%.
Band
How far the night share may drift from target at Equinox before a move, ±2–30 points. Default ±10.
Heat
One reading mapped to 0 (cold) … 1 (hot). 0.5 is normal.
Raw score
1 + 9 × weighted mean heat, this five minutes.
Season score
The raw score smoothed with a 3 hour half-life. This is the number that sets the zone.
Harvest
Sell night side → buy day side.
Plant
Sell day side → buy night side (only memes that pass the scan).
Pick
One of the top three memes by 24 h volume with rug risk under 30 and no high flag.
Curve
A Pons bonding-curve contract. A meme trades there against ETH until it graduates to Uniswap v4.
Graduation
When a curve's ETH reserve reaches the Pons threshold (4.2 ETH) it migrates to Uniswap v4 and stops trading on the curve.
House books
Four public paper portfolios that run the rule with fake money and live quotes.

04 · STARTArchitecture

One small Node service does everything that is not your signature. It keeps its own index of the chain in SQLite, so the score never depends on a third-party indexer.

Robinhood Chain RPCRobinhood price feedUniswap v3 poolsYahoo Finance RSSCoinGecko Pons events, balancesstock token bid/askslot0, QuoterV2headlines → VADERETH 24 h change EQUINOX server indexer · trades, launchesscore · six heats, EMAscan · rug risk 0–100rule · hold / harvest / plantplanner · steps, quotesSQLite · books · note Web terminal /appCLI · APIYour wallet score, books, planread-onlysigns every tx itself signed tx goes straight to the chain, never through the server
  • Indexer. Reads every Pons TokenLaunched, CurveBuy, CurveSell and PoolGraduated event, polling about every 20 seconds, with a 72 hour backfill on first start. Trades are kept 8 days.
  • Prices. ETH from the WETH/USDG pool every 30 s; stock tokens from Robinhood's feed every 30 s and from their deepest USDG pool; 5-minute snapshots for 24 h changes.
  • Cycle. Every 5 minutes: score → scan → house books → note.
  • Planner. On request, reads a wallet, runs the rule and builds steps. Each step's calldata is built only when you ask to sign it.

05 · HOW IT THINKSThe two sides

Day side

Robinhood stock tokens are ERC-20s (18 decimals) that track a stock or ETF through a multiplier. EQUINOX trades each one on its deepest USDG pool on Uniswap v3 (found by USDG depth across the 0.01%, 0.05%, 0.3% and 1% tiers, refreshed every 6 h) and values holdings at that pool's mid price, because that is what they actually sell for on chain. If a token has no pool, Robinhood's token bid is used.

TokenTracksPool price24 hPoolDepth
loading live pools…

Live from /api/state. Default day mix when buying: SPY 50% · QQQ 30% · USDG 20%.

Night side

Pons memecoins still trading on their bonding curve against native ETH. EQUINOX only buys memes that pass the night scan. It can always sell any Pons meme you hold on its curve. Memes that graduated, are about to graduate, or are paired against another token are listed as not counted, because the terminal trades native-ETH curves only.

Why ETH is outside both sides

ETH is the bridge: night trades settle in ETH, day trades settle in USDG. Counting it on either side would make the split jump with the ETH price. So ETH is working money and gas. A harvest converts the ETH it creates into USDG in the same plan; a plant creates the ETH it needs from USDG.

06 · HOW IT THINKSThe season score

Six readings, each turned into a heat from 0 to 1, weighted into one number from 1 to 10. The live score:

1 · Long Nightreading…10 · Midsummer
ReadingWeightNowNormalHeat
loading…

From reading to heat

Each reading has its own mapping. All of them give 0.5 for "normal" and are clamped to 0…1.

σ(x) = 1 / (1 + e^-x) clamp(x) = min(1, max(0, x)) night volume heat = clamp( σ( 2 · ln(volume_6h / volume_normal) ) ) launch rate heat = clamp( σ( 2 · ln(launches_6h / launches_normal) ) ) night buying heat = clamp( 0.5 + (buy_share − 0.5) / 0.25 ) ETH heat = clamp( 0.5 + eth_24h% / 16 ) stocks heat = clamp( 0.5 + avg(SPY, QQQ)_24h% / 6 ) news heat = clamp( 0.5 + mean_VADER )
  • Volume and launches compare the last 6 hours with a baseline from up to the previous 72 hours, per hour. Twice normal gives heat ≈ 0.80, half gives ≈ 0.20, ten times gives ≈ 0.99. A log ratio means the score cares about change, not size.
  • Night buying is ETH bought ÷ (ETH bought + ETH sold) on curves over 6 h. 50% is neutral; 75% buying is fully hot, 25% fully cold.
  • ETH: ±8% in a day saturates. Stocks: ±3% saturates (index ETFs move less).
  • News: VADER compound score (−1…+1) of up to 24 recent ETH and SPY headlines, refreshed every 15 minutes. A mean of ±0.5 saturates.

From heats to the score

raw = 1 + 9 · Σ(wᵢ · heatᵢ) / Σ(wᵢ) over readings that exist α = 1 − 2^(−5 / 180) ≈ 0.01908 5-min step, 3 h half-life score = score_prev + α · (raw − score_prev)

If a reading is missing (say the news feed is down) it drops out and the rest are re-weighted. If less than half of the total weight is available, no score is published. The raw score can swing; the season score takes about 3 hours to cover half of any gap, about 6 hours for three quarters. The score history is kept 30 days.

i

Why smooth? One whale buy or one viral launch can spike the raw number for an hour. Rebalancing on that would mean trading on noise and paying fees each time. The slow average makes the zone change only when the change lasts.

07 · HOW IT THINKSScore calculator

The same formulas, in your browser. It starts from the live readings; change any number to see where the raw score would land.

Raw score lab
RAW SCORE
–
–
The live season score moves toward this number by about 1.9% every five minutes.

08 · HOW IT THINKSZones and the rule

score ≤ 3Long Night

Night side under target? Plant it up to the target with day money.

3 – 8Equinox

Hold. Move only if the night share drifts more than the band from target.

score ≥ 8Midsummer

Night side over target? Harvest it down to the target into the day side.

One function decides for the house books and for every wallet:

// total = day + night, share = night / total, gap = share - target
if total < $10                              -> hold
if zone is Midsummer  and gap > 0         -> harvest  gap x total
if zone is Long Night and gap < 0         -> plant   -gap x total
if |gap| > band                          -> back to target, any zone
else                                      -> hold
if move < $5                               -> hold

Notice the asymmetry with the band. At Midsummer any excess over target is harvested; in the Long Night any shortfall is planted. At Equinox nothing happens until the drift is large. That is the whole edge: act on extremes, sit still in between.

Worked example: Midsummer

score 8.4 · target 20% · band ±10
Day side $3,200, night side $1,300 after a meme run. Total $4,500, night share 28.9%, gap +8.9 points.
Inside the band, so at Equinox this would hold. But it is Midsummer and the gap is positive, so: harvest 0.089 × $4,500 = $400.
Steps: sell $400 of memes pro rata on their curves → swap the ETH to USDG → buy SPY $200, QQQ $120 (USDG's 20% stays as USDG). Result: $3,600 / $900, 20.0%.

Worked example: Long Night

score 2.6 · target 20%
Day $3,600, night $450 after memes bled. Total $4,050, share 11.1%, gap −8.9.
Long Night and under target: plant 0.089 × $4,050 = $360.
Steps: use USDG first, then sell stock tokens pro rata → swap USDG to ETH → buy the three current picks, $120 each, on their curves. If no meme passes the scan, nothing is planted and the plan says so.

Worked example: drift at Equinox

score 5.9 · target 20% · band ±10
One meme 5x'd: day $2,000, night $1,500, share 42.9%, gap +22.9 > 10. Even at Equinox: harvest $800 back to 20%.

09 · HOW IT THINKSRule simulator

Type in a portfolio and a score. This runs the exact rule and lists the steps a plan would contain.

Rebalance simulator
DECISION
–
–
–

    10 · HOW IT THINKSThe night scan

    Every five minutes the scan takes the busiest native-ETH Pons curves of the last 24 hours that are at least 6 hours old and still on their curve (not graduated, not ready to graduate), and scores each one for rug risk from 0 to 100 with chain data only.

    CheckHow it is measuredAddsHigh flag
    Creator taxcreatorTaxBps on the curve≥5%: 30 · ≥3%: 15 · ≥1%: 5≥ 5%
    Creator bagcreator wallet's balanceOf ÷ tokens outside the curve>40%: 30 · >20%: 18 · >10%: 8> 40%
    Creator sellingcreator's curve sells ÷ creator's curve buys>50%: 25 · any: 10> 50%
    Concentrationtop 5 real balances (12 largest net buyers re-read on chain, curve and dead address excluded) ÷ tokens out>60%: 15 · >40%: 8–
    Thin demanddistinct buyers in 24 h<10: 15 · <25: 6–
    Wash volumeshare of 24 h volume from wallets that both bought and sold>70%: 10–

    A meme passes with risk under 30 and no high flag. The top three passing memes by 24 h volume are the picks; a plant splits its money evenly across them. If no new meme passes, a plant may add to memes the wallet already holds that still pass; otherwise it plants nothing.

    Live example

    Meme24 hBuyersAgeFlagsRisk
    loading the latest scan…
    !

    A low score is not a promise. The scan catches common patterns (heavy dev bags, dev dumps, concentrated supply, wash volume). It cannot see off-chain coordination, a team's intent, or a perfectly patient rug. Memecoins can go to zero.

    11 · HOW IT THINKSThe house books

    Four public paper portfolios, opened the same moment with the same 1,000 USDG each. They are the honest test of the idea: if following the score does not beat a plain 80/20, you will see it.

    BookRuleEquityReturn
    EQUINOX80/20, the score decides when––
    Plain 80/20Same split, drift band only––
    Day onlyDay mix, bought once, held––
    Night onlyThe picks at open, bought once, held––

    How they fill

    • Day trades are priced with Uniswap v3 QuoterV2 on the same pools a wallet would use, pool fee included.
    • Meme trades use the exact curve math (constant product on the reserves, minus the curve fee and creator tax), with ETH bought or sold through the WETH/USDG pool.
    • Valuation every cycle: day tokens at pool mid, memes at curve mid.
    • A meme that graduates in a book is closed at its last curve value and logged, like a holder who did not follow it to Uniswap v4.
    • No gas is charged and fills are instant, so real results will be a little worse. That bias is the same for all four books.

    12 · HOW IT THINKSData sources and timing

    WhatSourceHow often
    Pons launches and tradesPons factory and curve events via Robinhood Chain RPC~20 s, 72 h backfill
    ETH priceWETH/USDG v3 pool slot030 s
    ETH 24 h changeCoinGecko, fallback own snapshots10 min
    Stock token pricesRobinhood /rhj/prices (token bid/ask) and each token's pool30 s
    Stock 24 h changeOwn 5-minute snapshots, seeded from pool Swap events5 min
    HeadlinesYahoo Finance RSS (ETH-USD, BTC-USD, SPY) scored with VADER15 min
    Score, scan, bookscomputed5 min
    NoteAI model (or a template without a key)hourly / every cycle
    Pool discoveryUniswap v3 factory, four fee tiers6 h

    Retention: trades 8 days, price snapshots 8 days, score history 30 days. The database is backed up hourly.

    13 · USING ITThe terminal

    TabWhat you see
    01 SeasonScore on a sun dial, zone, the note, 7-day smoothed history, 6 h buys/sells/trades/launches, the six readings with heat bars, the headlines with their tone, live day-side prices with pool depth and fee
    02 RecordThe four house books, their return curves (hover for values at any moment) and every move EQUINOX made with the reason
    03 Night picksEvery scanned meme with flags, 24 h volume, buyers, age, risk and price; pick marks the three it would buy, passes marks the rest that are allowed
    04 My balanceSign in, holdings, the plan, signing, your rule, history of your signed steps; or look at any wallet

    Deep links: /app#season, /app#record, /app#picks, /app#balance. Data refreshes every 30 seconds.

    14 · USING ITConnect and sign in

    The terminal lists every wallet extension it finds (EIP-6963), so you choose which one connects. It then asks for an account and a signature on a message like this:

    Sign in to EQUINOX
    
    This signature proves the wallet is yours. It sends nothing and costs no gas.
    EQUINOX never gets a key: every trade it plans is a transaction your wallet
    signs or refuses.
    
    Wallet: 0xYourAddress
    Chain: Robinhood Chain (4663)
    Nonce: 3f9c2a…
    Issued: 2026-11-16T09:12:00.000Z
    • It is a message (personal_sign), not a transaction. No gas, no approval, nothing leaves the wallet.
    • The nonce is single-use and expires in 5 minutes; the session lasts 12 hours in an HttpOnly, SameSite cookie. Sign out ends it.
    • A session lets EQUINOX save your rule and prepare steps for that one address. It cannot sign or send anything.

    15 · USING ITYour rule

    Saved per address on the server. Save rule rebuilds the plan at once. Out-of-range values are clamped.

    SettingRangeDefaultEffect
    Night side target0 – 50%20%The night share every move steers to. 0% = harvest everything, never plant.
    Drift band±2 – 30 pts±10Smaller = more frequent, smaller moves; larger = fewer, bigger.
    Day mixany weightsSPY 5 · QQQ 3 · USDG 2Normalized to 100%. Used when buying day side.
    Slippage · night0.5 – 15%3%Minimum out on curve trades. Curves are thin; too low and buys revert.
    Slippage · day0.1 – 5%1%Minimum out on Uniswap swaps.
    Follow the season scoreon / offonOff = a plain drift rebalancer.
    Extra Pons CAsone per line–Memes received by transfer (not traded in the last 7 days) to count on the night side.

    Choosing a target

    The target is your risk dial. With 20% on memes, a meme side that halves costs the whole portfolio 10%; a meme side that triples adds 40% before harvest. Pick the number you would be fine seeing go to zero.

    16 · USING ITRebalancing, step by step

    A plan is an ordered list. Sells always come first so the ETH or USDG exists before it is spent.

    Harvest (night → day)

    nightSell · sell memes on their curves

    Each meme sold by the same fraction (harvest ÷ night value), biggest first. Pieces under $1 are skipped.

    ethToUsdg · ETH → USDG

    Everything the sells produced above the gas reserve, capped at the plan amount + 2%, through the WETH/USDG 0.05% pool.

    dayBuy · USDG → each day token

    One swap per non-USDG token in your mix, on its deepest pool. Buys under $1 are skipped.

    Plant (day → night)

    daySell · stock tokens → USDG

    USDG already in the wallet is used first; the rest comes from stock tokens pro rata.

    usdgToEth · USDG → native ETH

    Swap and unwrap in one transaction.

    nightBuy · ETH → each pick

    Split evenly, on each curve, never touching the last 0.002 ETH.

    What happens when you press Sign

    1. The terminal asks the server for step n. The server re-reads your balance, re-quotes on chain and returns either an approve (exact amount) or the swap with a fresh minimum out.
    2. Your wallet shows it. You confirm or reject.
    3. The terminal sends the hash back; the server waits for the receipt and checks it succeeded before step n+1.
    4. After an approve, the same step is requested again and now returns the swap.

    A plan lives 30 minutes. Rejecting or pressing Stop ends the run between steps; whatever was done stays done, and the next plan starts from the new balances.

    17 · USING ITAnatomy of each transaction

    What your wallet should show for each step. If a prompt ever sends to a contract not on this list, reject it.

    StepToFunctionValue
    approvethe token you sellapprove(spender, exact amount)0
    nightSellthe meme's curvesell(tokensIn, minEthOut, you)0
    nightBuythe meme's curvebuy(ethIn, minTokensOut, you)ethIn
    ethToUsdgSwapRouter02exactInputSingle(WETH→USDG, fee 500, you)ETH in
    usdgToEthSwapRouter02multicall(deadline, [exactInputSingle(USDG→WETH, router), unwrapWETH9(min, you)])0
    daySellSwapRouter02exactInputSingle(stock→USDG, pool fee, you)0
    dayBuySwapRouter02exactInputSingle(USDG→stock, pool fee, you)0

    How minimums are set

    curve buy out = T · net / (Q + net), net = ethIn · (1 − (fee + tax)) curve sell out = Q · tokensIn / (T + tokensIn) · (1 − (fee + tax)) pools out = QuoterV2.quoteExactInputSingle(...) minOut = out · (1 − slippage) night slippage on curves, day slippage on pools Q, T = the curve's ETH and token reserves (getReserves), fee and tax in bps

    If a curve has an anti-snipe tax active for your address (currentSnipeTaxBps), the expected output is reduced by it too, so the buy does not revert.

    18 · USING ITFees and costs

    CostSizeWho gets it
    EQUINOX feenone–
    Pons curve fee1% of each curve tradePons protocol
    Creator tax0 – 10%, set per meme (picks are under 5% by rule)the meme's creator
    Uniswap v3 pool fee0.01 / 0.05 / 0.3 / 1% by poolliquidity providers
    Price impactdepends on size vs pool depth / curve reserves–
    Gassmall on Robinhood Chain; one tx per step plus approvalsthe network

    A full harvest round trip (meme → ETH → USDG → stock token) pays roughly 1% curve fee + creator tax + 0.05% + the stock pool fee. That is why the rule refuses moves under $5 and why the band exists.

    19 · USING ITLook at any wallet

    On My balance, paste any address under Or look at any wallet. You get its day side, night side, ETH, memes not counted and the plan the default rule (or a target you pass) would build, read-only. The same data is at GET /api/look and equinox look 0x….

    20 · USING ITTroubleshooting

    SymptomWhyFix
    Plan says holdInside the band, zone does not call for a move, move under $5, or under $10 on both sidesNothing to do. ETH alone is not counted.
    "No memecoin passes the scan"No pick right now and nothing held still passesWait for the next scan, or plant later
    A meme I hold is missingNot traded by this wallet on Pons in 7 daysAdd its CA under Extra Pons CAs
    Meme listed as "not counted"Graduated, about to graduate, or paired with another tokenTrade it on Uniswap v4 yourself
    Swap reverted / "too little received"Price moved past your slippage between quote and inclusionPress Sign again (fresh quote) or raise slippage a little
    "not enough ETH left after gas"Under 0.002 ETH spareAdd a little ETH
    Wallet on the wrong networkNot on chain 4663Accept the switch prompt, or add Robinhood Chain manually
    "Sign-in expired"Nonce older than 5 minutes or already usedPress Connect & sign in again
    Stock token shows no priceMarket halted or no poolIt is valued at Robinhood's bid until the pool trades
    "Too many requests"Rate limitWait a minute

    21 · BUILDERSCLI

    eqnx-agent brings EQUINOX to your terminal. It only reads the public API, holds no keys and signs nothing. Node 18+. MIT.

    Source and brand assets: github.com/equinoxagent/equinox-agent · package: npmjs.com/package/eqnx-agent.

    npx eqnx-agent                 # the season score, its six readings and the note
    npx eqnx-agent record          # the four house books and what EQUINOX did
    npx eqnx-agent picks           # memes scanned now, which are picks, and why
    npx eqnx-agent look 0x… [20]   # day, night and the plan for any wallet (optional target %)
    npx eqnx-agent watch           # the score, refreshed every minute
    # install once, run `equinox`
    npm i -g eqnx-agent
    # or straight from this site
    npm i -g https://eqnxagent.com/equinox-agent.tgz

    Sample output

      EQUINOX  season score
      5.99  Equinox  · hold the balance: rebalance only on a large drift
      1 ────────────────●───────────── 10
    
      Night volume   25%   ███████████████░░░░░ 49.85     ETH/h traded on Pons curves · normal 28.82
      Night buying   25%   ████████████░░░░░░░░ 53.1%     % of Pons volume that was buying
      Launch rate    10%   ██████████████░░░░░░ 37.8      new Pons tokens per hour · normal 23.7
      ETH 24 h       15%   █████████░░░░░░░░░░░ -1.36%
      SPY/QQQ 24 h   10%   ███████████░░░░░░░░░ +0.21%
      News tone      15%   ███████░░░░░░░░░░░░░ -0.137

    Environment: EQUINOX_URL (server, default the public site), NO_COLOR (plain output).

    22 · BUILDERSAPI reference

    JSON over HTTPS. Public endpoints need no key. CORS is same-origin; call from a server or the CLI.

    GET/api/state

    Everything the public pages show.

    FieldTypeMeaning
    score / rawnumberSeason score and this cycle's raw score (null while warming up)
    zoneobject{key: night|equinox|midsummer, label, act, max}
    zones, weightsarray, objectZone table and reading weights
    parts.<reading>object{value, unit, vs?, heat}; parts.news.headlines[] has {title, link, date, score}
    why / whyAtstring, msThe note and when it was written
    seriesarray[ts, score, raw] every 5 min, 7 days
    eth / eth24hnumberETH in USD and its 24 h % change
    day[]array{sym, name, token, price, feed, chg24h, pool:{pool, fee, depthUsd}, halt}
    marketobject6 h buys, sells, trades, launches and baselines
    scanned[] / picks[]array{token, curve, symbol, name, volEth, trades24h, buyers24h, holders, risk, high, flags[], taxBps, ageH, priceEth}
    houseobject{started, start, books:{equinox|fixed|day|night:{name, note, equity, ret, cash, day, night[], trades[], curve[]}}}
    defaultsobjectThe default rule
    healthobjectLast indexed block and any source that is currently retrying

    GET/api/look?address=0x…&target=20

    Holdings and plan for any wallet. target is a percent, optional.

    FieldTypeMeaning
    holdings.ethobject{wei, amount, usd}
    holdings.day[]array{sym, token, raw, amount, usd, priced}
    holdings.night[]array{token, curve, symbol, raw, amount, usd, passes}
    holdings.unpriced[]array{token, symbol, why}
    holdings.dayUsd / nightUsdnumberSide totals
    planobject{zone, action, usd, share, reason, steps[]} (steps as text)

    GET/api/token

    {live, ca, symbol, buy, x, telegram, explorer, totals:{burned, usd, runs}, burns[]}

    Signed-in endpoints

    Used by the terminal with the session cookie: POST/api/auth/nonce, POST/api/auth/verify, POST/api/auth/logout, GET/api/me, GET/api/portfolio, POST/api/policy, POST/api/step, POST/api/step/done. They only ever act for the signed-in address.

    Examples

    curl -s https://eqnxagent.com/api/state | jq '{score, zone: .zone.label, picks: [.picks[].symbol]}'

    Live response (trimmed)

    loading…

    Errors and limits

    CodeWhen
    400Bad address or body
    401Signed-in endpoint without a session, or an expired / mismatched signature
    429Rate limit: 600 API calls / min / IP; 20 wallet looks / min; 30 sign-in attempts / min; 120 signed-in calls / min

    Errors are {"error": "message"}.

    23 · BUILDERSRun your own

    The server is one Node 22 process with SQLite, no external database or indexer. On first start it backfills 72 hours of Pons activity (about an hour on a public RPC), then runs live.

    PORT=4300 SITE_URL=http://127.0.0.1:4300 node server.js
    # point the CLI at it
    EQUINOX_URL=http://127.0.0.1:4300 equinox
    VariableDefaultMeaning
    PORT / HOST4300 / 127.0.0.1Where it listens; put a TLS reverse proxy in front
    SITE_URLpublic siteUsed in the sign-in message, sitemap and secure cookies
    RPC_URLSRobinhood public RPCComma-separated; tried in order on failure
    BACKFILL_HOURS72History read on first start
    EQUINOX_DATA./dataDatabase and backups
    ANTHROPIC_API_KEY–Optional; enables the written note
    NOTE_MODELclaude-opus-5-5Model for the note
    TRUST_PROXY–Set behind a proxy so rate limits see the real IP

    Memory: about 150–250 MB. Disk: a few hundred MB for 8 days of trades.

    24 · BUILDERSContracts and tokens

    Robinhood Chain, chain id 4663, explorer robinhoodchain.blockscout.com. EQUINOX deploys no trading contract; your wallet talks straight to these.

    ContractAddress
    USDG (6 decimals)0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168
    WETH0x0bd7d308f8e1639fab988df18a8011f41eacad73
    WETH/USDG pool (v3 0.05%)0x69BfaF19C9f377BB306a89aEd9F6B07e2c1a8d9a
    Uniswap v3 SwapRouter020xcaf681a66d020601342297493863e78c959e5cb2
    Uniswap v3 QuoterV20x33e885ed0ec9bf04ecfb19341582aadcb4c8a9e7
    Uniswap v3 Factory0x1f7d7550b1b028f7571e69a784071f0205fd2efa
    Uniswap v4 PoolManager0x8366a39cc670b4001a1121b8f6a443a643e40951
    Pons factory0x7eD598BcEf8bd9Edd8C97A195C6d13f40801EC7e

    Day-side token addresses

    TokenAddress
    loading…

    Stock token addresses come from Robinhood's official contract list. Always compare with the explorer before you trade.

    25 · TRUSTSecurity model

    The server canRead and prepare

    Read public chain data and your balances, save your rule, build unsigned transactions for your address, check receipts.

    The server cannotMove anything

    No private key, no deposit, no unlimited approval, no contract that holds funds. Nothing reaches the chain without your wallet.

    • Exact approvals. Every approve is for that step's amount, to Uniswap's router or the meme's own curve.
    • Recipient is you. Every swap pays out to the signed-in address (the one exception: in USDG→ETH the router receives WETH for one instant to unwrap it to you inside the same transaction).
    • Fresh minimums. Re-quoted at signing; a 10-minute deadline on router multicalls.
    • Sessions. Signed nonce, 12 h HttpOnly SameSite cookie, rate limits, strict Content-Security-Policy, no third-party scripts in the terminal.
    • Worst case if the server were compromised: it could show you a bad transaction. Your wallet would still show the target and amounts. Check them against the anatomy table.
    !

    EQUINOX will never ask for a seed phrase or private key, never DM you first, and never ask you to send funds to an address. Anyone who does is not EQUINOX.

    26 · TRUSTHonest limits and risks

    • Not a forecast. The score describes the last few hours. Hot can get hotter; cold can get colder.
    • Memecoin risk. Memes can go to zero quickly, scan or no scan.
    • Stock tokens are not shares. They follow their stocks through on-chain pools; prices can drift, pools can be thin, trading can halt. Not available to US persons.
    • Paper books are optimistic. No gas and instant fills.
    • Smart contract risk in Pons, Uniswap and the tokens themselves.
    • Data risk. An RPC, the price feed or the news feed can lag or fail; missing readings drop out of the score.
    • Not financial advice. EQUINOX is independent and not affiliated with Robinhood, Uniswap, Pons, Paxos or Anthropic.

    27 · TRUST$EQNX

    $EQNX is the EQUINOX token on Pons. The contract address appears here, in the top bar and on the landing page the moment it is live. Until then, any address claiming to be $EQNX is not.

    The terminal, the CLI and the API are free and do not require holding $EQNX.

    28 · TRUSTFAQ

    Does EQUINOX trade for me automatically?

    No. It plans and prepares each step; nothing happens until your wallet signs. Only the paper house books trade by themselves, and they never send anything.

    Why does my plan say hold?

    The zone does not call for a move, your night share is inside the band, the move would be under $5, or the wallet holds under $10 on the two sides. ETH alone does not count.

    How often should I rebalance?

    Whenever the plan says so. Checking once or twice a day is plenty; the score is smoothed over hours on purpose.

    I hold a meme but it does not show.

    EQUINOX finds memes you traded on Pons in the last 7 days. Add memes you received by transfer under Extra Pons CAs. Graduated memes are listed as not counted.

    Why is a high-volume meme not a pick?

    It may be under 6 hours old, about to graduate, have risk 30+ or a high flag such as the creator selling most of their buys. The Picks tab shows each reason.

    Can I choose the memes myself?

    EQUINOX only buys picks. You can hold any meme you like; it counts on the night side and can be sold in a harvest.

    Can I change how much goes to memes?

    Yes, 0–50%. At 0% a harvest sells all memes and a plant never buys.

    What happens if I stop halfway?

    Completed steps stay done; leftover ETH or USDG sits in your wallet. The next plan is built from the new balances.

    What does the AI do?

    Writes the one-paragraph note under the score from the six readings. It has no say in the score, the rule, the picks or any transaction.

    Can I run it myself?

    Yes. See Run your own; the CLI points at any server with EQUINOX_URL.

    29 · TRUSTChangelog

    v0.1November 2026
    • Season score from six readings with a 3 h smoothed average; three zones.
    • Night scan with on-chain rug risk; top-three picks.
    • Four house books at live quotes.
    • Web terminal: sign-in, plan, step-by-step signing, rule editor, look at any wallet.
    • CLI equinox-agent, public API, these docs.