How Orbistocks works.
One site and one set of contracts on Robinhood Chain. Every tokenized stock has a true price; arbitrage is the gravity that pulls market prices back to it. This page explains each piece, what it costs and what can go wrong.
Overview
Robinhood stock tokens (NVDA, GLD, SPY and the rest) trade on Robinhood Chain in several Uniswap v3 pools each: against USDG and against WETH, at the 0.01, 0.05, 0.30 and 1.00% fee tiers. Those pools drift apart from each other, and because the tokens trade all weekend while NYSE is closed, they drift away from the stock's price feed and jump at the open.
Orbistocks gives every stock a true price: its Chainlink feed where one exists (eight stocks are anchored this way), otherwise the consensus of its pools. Everything on the site measures distance from that price and offers a way to close it:
- The orbital map draws each stock as a planet whose distance from its orbit is the mispricing in bps.
- The engine runs a flash cycle across two to four pools and keeps the difference.
- The oracle book lets holders sell at the feed price instead of into a thin pool.
- Orbits are baskets of anchored stocks, backed one to one, with flash-mint for NAV arbitrage.
- Gap rounds take positions on where the feed prints at the next open.
- The vault collects engine profit for depositors.
- The desk pays bounties to keep a stock repriced.
- The agents API serves the same quotes as JSON.
- The index scores how efficient each stock and pool is.
Every page reads chain state live through a small relay on this domain. Nothing is stored about you. Every write is a transaction you sign in your own wallet, quoted first, with a guard on the minimum outcome and a ten minute deadline.
Orbital map
The map on the home page and in the app reads every pool of each anchored stock (slot0, liquidity, token balances) and its Chainlink feed. The sun is the true price. Each stock orbits at a radius set by its worst pool's distance from the feed in bps, so a planet far from its orbit is a stock whose pools disagree with the feed. Colour follows the index score: green when pools sit on the feed, red when they are far from it and thin.
Click a planet to select the stock in the scanner. The scanner quotes the best cycle and, if it pays, lets you run it. The map pauses when the tab is hidden or scrolled away, and it stays still when your system asks for reduced motion.
Engine
The engine has been live on Robinhood Chain since 20 September 2026. It quotes a cycle of two to four pools that starts and ends in the same token (USDG or WETH), borrows the input from the first pool with a flash swap, trades around the cycle and repays the pool, all in one transaction. The caller needs no tokens. If the output does not cover the input plus your minimum profit, the whole transaction reverts and only gas is spent.
How a quote works
- The scanner lists the pools of a stock and builds candidate cycles (USDG pool to WETH pool and back, or two USDG pools at different fee tiers).
- Each cycle is quoted at ten sizes from 25 to 25,000 USD. The quote simulates the swaps against live pool state.
- The best size is the one with the largest profit after the engine fee and an estimate of gas.
- Run cycle sends the transaction with a minimum profit guard: the quoted profit less a small slippage allowance.
Who gets what
The engine keeps 10% of the profit for the treasury and sends the remaining 90% to the address you choose. No fee is taken on principal, and a cycle that does not pay takes no fee at all. The fee cannot be set above 20%.
Zero capital means the cycle borrows from the pools themselves. Your wallet pays gas and receives profit. You never hold the stock.
Oracle book
A pool is a bad place to sell a stock token when it is thin or trading below the feed. The book is a different venue: holders list stock at one of nine discount levels below the Chainlink mark, from 0 to 500 bps, and buyers fill in USDG at the mark less the discount. The mark is read from the feed at the moment of the fill, so listings stay fair while the stock moves.
- Levels: 0, 25, 50, 75, 100, 150, 200, 300, 500 bps below the mark.
- A listing must be worth at least 1 USDG at the mark. The shares sit in the book until they are bought or cancelled.
- A fill takes the deepest discount first and works up to the shallowest level the buyer accepts, first come first served inside a level. The buy fills completely or reverts.
- The buyer pays 0.25% of the cost on top as the fee; sellers receive the full level price. Every buy carries a cost ceiling and a deadline.
- Cancel returns the unsold shares at any time. It reads no feed, so it works while a market is disabled or a feed is stale. Proceeds from fills are claimed in USDG.
- The book refuses to list or fill when the feed is older than three days, or when the stock token reports its own oracle paused.
Oracle arbitrage
When a pool trades above the feed, anyone can run the oracle arbitrage: flash-sell stock into the pool, use the USDG to buy the same amount from the book at or below the mark, hand the stock to the pool and keep the difference. The book clears and the pool gets repriced, in one transaction, with no capital. The pool must be a canonical Uniswap v3 pool of the stock against USDG. 10% of that profit goes to the treasury; the fee cannot be set above 20%. The run reverts unless what you receive after the fee meets your minimum.
Orbits
An orbit is an ERC-20 backed one to one by two to twelve anchored stocks. Whoever composes it sets the stocks and the units of each per share, and gives it a name and a symbol of up to 32 characters. Only stocks the factory allows (the anchored eight) can go in. Anyone can then:
- Mint by delivering the units of every stock for the shares they want. Units are rounded up.
- Redeem any time and receive the units back, rounded down. No feed is read, so redemption works on a weekend or during a feed outage.
- Flash-mint: receive shares first, deliver the backing inside the same transaction. This is how NAV arbitrage works when an orbit trades away from the value of what it holds.
NAV per share is computed from the Chainlink feeds of the stocks inside. There is no manager, no rebalance and no fee on mint or redeem.
Gap rounds
Tokenized stocks move all weekend; the stock itself does not. At the next NYSE open the feed prints a new price and the gap between the two closes at once. A gap round is a pari-mutuel market on the direction of that print.
- Anyone opens a round on an anchored stock with a settle time between 30 minutes and 7 days ahead. The reference price is the feed at that moment. One live round per stock.
- Stake USDG (1 USDG minimum) on up or down until the settle time.
- After the settle time, once the feed has printed again, anyone settles. Up wins if the new print is above the reference, down if below. The losing pool pays the winning pool in proportion to stake, less 1% to the treasury. A stake on the losing side is lost.
- An equal print, or a side with nothing staked, refunds both sides and takes no fee. If the feed has not printed three days after the settle time, anyone can cancel and everyone is refunded.
- Winners and refunds are claimed per round. The claim pays your stake plus your share of the losing pool; a refund pays the stake back.
The gap page suggests the next NYSE open (Monday to Friday 13:30 UTC, 14:30 UTC when the US is not on daylight time) as the settle time.
Vault
The vault is a standard ERC-4626 vault over USDG. Deposit and receive ovUSDG shares; withdraw or redeem and burn them. Anyone can run an engine cycle or an oracle arbitrage through the vault. The engine borrows from the pools, not from the vault: your USDG never leaves the vault during a run. The vault is the recipient of the cycle's profit, and the runner is paid a 10% bounty from what arrived for finding it. Runs start and end in USDG only.
Share price is total USDG held divided by shares. It rises when runs pay and otherwise stays where it is; a run that does not end with a profit reverts and costs the runner gas, not the vault. There is no lock-up and no deposit or withdrawal fee. Returns depend entirely on runners finding cycles that pay. The owner can pause new deposits and runs; withdrawals and redemptions cannot be paused.
Desk
If you care about a particular stock staying priced (you hold it, you make a market in it, you built an orbit around it), post a bounty on the desk. Set a reward per run, a budget of at least one reward, and an expiry up to 30 days ahead. Every engine cycle that touches that stock and is run through the desk pays the runner the reward on top of the cycle's own profit, one run per bounty per block. A run that does not end with a profit reverts and earns nothing.
2% of each reward paid goes to the treasury and the runner receives the other 98%. Nothing is charged while a bounty waits. The last run of a budget pays whatever is left when that is less than the reward, and the bounty closes by itself at zero.
Top up a bounty while it is open and before its expiry. Cancel it after expiry, or once 24 hours have passed without a run (counted from the posting if it never ran), and the remaining budget is refunded.
Agents API
Everything the site reads is also served as JSON, free and without a key, from this domain. GET only, CORS open to any origin, answers cached for ten seconds, sixty requests a minute per IP. The agents page shows every endpoint live.
GET /api/agent this index: endpoints, units, limits, error codes
GET /api/agent/universe every stock with two or more pools, its pools and the best mid edge cycle
GET /api/agent/quote?symbol=NVDA true price, pool drifts and the best cycles quoted by the engine at ten sizes
routes=1..8 picks how many cycles to quote (default 4)
GET /api/agent/feeds the eight anchored feeds: price, update time, age, fresh flag
GET /api/agent/scores the efficiency index: source of the true price, drift, depth, feed age, score
Errors are JSON too: 400 for a bad query (the body names the field), 404 for an unknown symbol (the body lists the symbols), 429 over the rate limit (the body carries retryAfterSec), 502 when the chain read failed. When the chain does not answer inside the read budget of about eight seconds, the answer is the last scanned snapshot with "snapshot": true and a snapshotDate; a reused last good value carries "stale": true. Check both before acting.
Example answers
Read from the dev server on 4 October 2026 at block 79782574 and trimmed. Pool and token addresses are left out here; the live answers carry them.
$ curl -s https://orbistocks.com/api/agent/universe
{
"ok": true, "at": "2026-10-04T08:06:26.000Z", "block": 79780911,
"source": "live", "snapshot": false, "snapshotDate": null, "stale": false,
"ethUsd": 2704, "count": 49, "poolCount": 136, "livePoolCount": 129, "openCount": 2,
"best": { "id": "SLV.U500.W3000.E100", "label": "Buy USDG 0.05% · Sell WETH 0.30%",
"start": "USDG", "hops": 3, "midEdgeBps": 2.52, "grossBps": 38.64,
"feeBps": 36, "capacityUsd": 340.21 },
"stocks": [
{ "symbol": "NVDA", "label": "NVIDIA", "decimals": 18, "priceUsd": 234.872701,
"minPriceUsd": 234.599583, "maxPriceUsd": 237.147702, "spreadBps": 108.62,
"depthUsd": 1650366.96, "livePools": 5, "poolCount": 5, "open": false,
"pools": [ { "key": "U500", "quote": "USDG", "fee": 500, "feeLabel": "0.05%",
"priceUsd": 234.803293, "devBps": -2.96, "depthUsd": 889538.7 }, ... ] },
...
]
}
$ curl -s "https://orbistocks.com/api/agent/quote?symbol=NVDA&routes=1"
{
"ok": true, "symbol": "NVDA", "at": "2026-10-04T08:09:17.000Z", "block": 79782574,
"truePrice": { "priceUsd": 234.997119, "source": "feed", "poolMid": 234.803334,
"feedUpdatedAt": "2026-10-02T17:07:32.000Z", "feedAgeSec": 140505, "feedFresh": true },
"spreadBps": 96.19, "depthUsd": 1646827.22, "livePools": 5,
"engine": { "feeBps": 1000, "maxHops": 4, "quoted": true },
"sizesUsd": [25, 50, 100, 250, 500, 1000, 2500, 5000, 10000, 25000],
"routes": [
{ "id": "NVDA.E100.W500.U500", "label": "Buy WETH 0.05% · Sell USDG 0.05%",
"start": "USDG", "hops": 3, "midEdgeBps": -9.01, "grossBps": 1.99, "feeBps": 11,
"best": null,
"grid": [ { "sizeUsd": 25, "ok": true, "amountIn": "25", "amountOut": "24.977449",
"profit": "-0.022551", "fee": "0", "toYou": "0", "profitable": false }, ... ] }
]
}
In that answer no size of the best route pays ("best": null, every row "profitable": false), which is the honest state most of the time. toYou is what the caller keeps after the 10% fee on profit, in the start token.
$ curl -s https://orbistocks.com/api/agent/feeds
{
"ok": true, "at": "2026-10-04T08:09:17.550Z", "stale": false, "count": 8, "freshWindowSec": 259200,
"feeds": [
{ "symbol": "NVDA", "description": "RHNVDA / USD", "price": 234.99711907,
"updatedAt": "2026-10-02T17:07:32.000Z", "ageSec": 140505, "fresh": true },
{ "symbol": "AAPL", "description": "Robinhood AAPL / USD", "price": 333.82386412,
"updatedAt": "2026-10-02T16:39:40.000Z", "ageSec": 142177, "fresh": true },
...
]
}
$ curl -s https://orbistocks.com/api/agent/scores
{
"ok": true, "at": "2026-10-04T08:09:17.000Z", "block": 79782574, "feedsOk": 8,
"universeCount": 49, "poolCount": 136, "livePoolCount": 129, "openCount": 1, "avgScore": 76,
"method": "score = 100 - drift (worst live pool vs the true price, bps) - depth penalty - anchor penalty (no feed or stale feed) - cycles penalty (fewer than two live pools), clamped to 0..100",
"rows": [
{ "symbol": "NVDA", "anchored": true, "truePrice": 234.997119, "trueSource": "feed",
"livePools": 5, "worstBps": 79.11, "worstPool": "W10000", "bestBps": 4.46, "bestPool": "W3000",
"spreadBps": 96.19, "depthUsd": 1646827.22, "score": 75, "grade": "drifting",
"parts": { "drift": 19.8, "depth": 0, "anchor": 5, "cycles": 0 } },
...
]
}
The agents page also hosts an analyst: paste an orbio API key, pick a model and ask about the current quotes. orbio charges your credits; the key stays in your browser and this site stores nothing. Treat the answers as a reading of the numbers, not as advice.
Index
The efficiency index scores every stock and every pool. Per stock it shows the true price source (feed or pool consensus), the worst spread in bps, the best pool, available depth, feed age and a score; per pool, the spread to the true price, depth on each side and the fee tier. The score is 100 minus the drift of the worst live pool from the true price in bps, minus a depth penalty, minus an anchor penalty when there is no feed or the feed is older than three days, minus a cycles penalty when fewer than two pools are live, clamped to 0..100. The planet colours on the map come from these scores. Everything is computed from live reads; nothing is invented or smoothed.
Dividend watch, a companion page, lists the anchored stocks with their feed freshness and pool gaps, because pools that do not reprice around corporate actions hand the engine a predictable cycle. Dates appear only when they come from a real, dated source.
Fees
Every fee below is set in a contract and can only move within the cap written there. No fee is taken on principal. The vault row is a bounty paid to the runner, not a fee to the treasury.
| Where | Taken on | Fee | Cap |
|---|
Values read from the site's shared configuration; the deployed contracts are the authority.
Limits
The numbers written into the contracts. None of them can be changed except where the owner section says so.
| Where | Rule | Value |
|---|---|---|
| Engine | pools in a cycle | 2 to 4 |
| Engine | sizes quoted by the app | 25 to 25,000 USD |
| Book | discount levels below the mark | 0, 25, 50, 75, 100, 150, 200, 300, 500 bps |
| Book | smallest listing, valued at the mark | 1 USDG |
| Book | oldest feed print accepted | 3 days (cap 7 days) |
| Orbits | stocks per orbit | 2 to 12 |
| Orbits | name and symbol | up to 32 characters |
| Gap | smallest stake | 1 USDG |
| Gap | settle time ahead of opening | 30 minutes to 7 days |
| Gap | cancel when the feed never prints | 3 days after the settle time |
| Gap | live rounds per stock | 1 |
| Vault | start token of a run | USDG |
| Desk | longest bounty term | 30 days |
| Desk | cancel after a quiet spell of | 24 hours |
| Desk | runs per bounty per block | 1 |
| Every write | deadline set by the site | 10 minutes |
Owner
One address owns the contracts and is their treasury. Ownership moves in two steps (propose, then accept) and cannot be renounced. There are no proxies and no upgrades: the code you read is the code that runs.
The owner can: set each fee within its cap; enable or disable a stock on the book and on the gap; allow or disallow a stock on the orbit factory; change the smallest listing on the book; pause the oracle arbitrage; pause new deposits and runs on the vault; move the treasury address.
The owner cannot: take your tokens or your USDG; change what an orbit holds or stop a redemption; settle a round at a price of its choosing (only the feed does); stop a cancel on the book or the desk, a claim on the book or the gap, or a withdrawal from the vault; take a fee on principal.
Risks
Say it plainly:
- Profit is not guaranteed. A quote is a simulation against current state. Another runner can take the gap in the blocks before yours lands. When that happens your cycle reverts and you pay gas for nothing.
- The book fills only against resting listings. A buy for more shares than rest at the levels you accept reverts, and the oracle arbitrage needs enough resting shares at or below the mark to work at all.
- Feeds can be stale or wrong. The book, orbits and gap rounds trust the Chainlink feed. The book refuses stale feeds; gap rounds wait for a fresh print; orbits can be redeemed in kind without a feed. None of that helps if a feed prints a wrong price.
- Gap rounds can lose the whole stake. They are pari-mutuel: the losing side pays the winning side. Thin rounds can also pay very little.
- The vault depends on runners. If nobody runs cycles, the share price does not move. The vault holds USDG only and never holds stock between runs.
- Pools can be thin. A large size moves a pool against you; the quote already includes that, which is why the best size is often small.
- Tokenized stocks are third-party tokens issued under their own terms, which Orbistocks does not control. Their issuer can pause their own oracle, and the book stops with it.
- Contracts can have bugs. They are small, deliberately limited, and tested, and the engine has run on mainnet since September 2026, but no software is free of defects. Put in what you can afford to have stuck or lost.
FAQ
Do I need capital to run a cycle?
No. The engine borrows from the first pool with a flash swap and repays it inside the same transaction. You pay gas and receive the profit.
Why did my cycle revert?
Between the quote and the block your transaction landed in, the pools moved: someone else closed the gap, or a trade moved a pool. The minimum profit guard stopped the cycle rather than run it at a loss. Only gas was spent.
Which stocks are anchored?
The eight with a Chainlink feed on Robinhood Chain: NVDA, AAPL, TSLA, MSFT, GOOGL, AMZN, META and SPCX. The book, orbits and gap rounds work on these. The engine and the map cover every stock with two or more pools.
Why does a page show an empty state and no form?
The book, orbits, gap, vault and desk pages read their contract addresses from the site's configuration. While an address is blank, the page shows a neutral empty state, hides its write controls and still reads the feeds and the pools. Once the address is in the configuration the same page works fully with no other change.
Can I redeem an orbit if a feed is down?
Yes. Redeeming in kind returns the units of each stock and reads no feed at all.
Who settles a gap round?
Anyone, once the feed has printed after the settle time. You do not depend on a keeper; the settle button on the gap page sends the same call from your wallet.
What does Orbistocks store about me?
Nothing. No accounts, no analytics, no logs of addresses. The agents API counts requests per IP address for one minute to enforce its rate limit and keeps nothing after that. The chain stores everything you sign, forever, as it does for every transaction.
Where is the $ORBISTOCKS coin?
$ORBISTOCKS trades on the ponsfamily launchpad on Robinhood Chain. The Buy control in the nav and footer opens its launchpad page and Copy CA copies the contract address; both read from the site's configuration, and the address is shown nowhere else on the site on purpose.
Is this affiliated with Robinhood?
No. Orbistocks is an independent project built for the 2026 Robinhood Hackathon Campaign. It is not affiliated with Robinhood, Chainlink or Uniswap.