Agents

The same quotes, as JSON.

Everything the site reads from Robinhood Chain is served from this domain as plain JSON: the pool universe, the Chainlink feeds, the engine's exact quotes and the efficiency index. No key, no account. An analyst sits on top of the live quotes and runs on your own orbio credits.

Reading the chain

Overview

Orbistocks maps how far every Robinhood stock token has drifted from its true price and closes the gap in one transaction. A bot wants the same numbers without a browser. This API hands them over: the live mid of every pool, both sides' balances, the drift against the feed and the engine's own quote for the best cycles at ten sizes, profit after the fee included.

  • Live reads only. Every answer is one Multicall3 read of the pools and one of the feeds, made when you ask. When the chain does not answer inside the budget you get the last scanned snapshot with "snapshot": true, never a guess.
  • Quotes come from the engine. The quote endpoint calls the live engine's quoteMany, which runs the whole flash cycle against the current pool state and reports what the caller would keep after the 10% fee on profit.
  • Nothing about you is stored. No key, no account, no log of callers. Addresses in the JSON are the public pool and token contracts a bot needs to act on its own.

Free API

Base URL https://orbistocks.com/api/agent. GET only, answers are JSON, CORS is open so a browser agent can call it from any origin. Answers are cached for ten seconds and each IP gets sixty requests a minute. The index at the base URL lists every endpoint with its query and units.

GET /api/agentreading
curl -s https://orbistocks.com/api/agent
reading

Endpoints

Each block below shows the answer the dev server gives right now, refreshed when you open the page. Long answers are cut after the first lines; show all to read the whole thing, it scrolls inside the block.

Universe

GET /api/agent/universe. The 49 stocks with two or more Uniswap v3 pools: per stock the depth weighted mid, the spread between its pools, the best mid edge cycle; per pool the quote asset, the fee tier, the mid in dollars, both sides' balances and the depth.

GET /api/agent/universereading
curl -s https://orbistocks.com/api/agent/universe
reading

Quote

GET /api/agent/quote?symbol=NVDA. One stock: the true price and where it comes from, every pool with its drift in bps, and the best cycles quoted live by the engine at 25 to 25,000 USD. Each grid row carries the input, the output, the gross profit, the fee and what the caller keeps, in the start token and in dollars. routes=1..8 picks how many cycles to quote.

GET /api/agent/quote?symbol=NVDAreading
curl -s "https://orbistocks.com/api/agent/quote?symbol=NVDA"
reading

Feeds

GET /api/agent/feeds. The eight anchored Chainlink feeds: price, round, updatedAt, age in seconds and whether the feed is inside the three day window the book accepts. Feeds print on weekends too, so the age tells you how far the pools may have run from the last print.

GET /api/agent/feedsreading
curl -s https://orbistocks.com/api/agent/feeds
reading

Index

GET /api/agent/scores. The efficiency index behind the planet colours: per stock the true price source, the worst pool's drift, the best pool, depth, feed age and a 0 to 100 score with its parts. The method is spelled out in the answer.

GET /api/agent/scoresreading
curl -s https://orbistocks.com/api/agent/scores
reading

Analyst

Ask a model to read the live quote of a stock for you. The panel sends the current answer of the quote endpoint together with your question to the model you pick, through orbio, and shows the reply as plain text. orbio charges the credits behind your key per request; Orbistocks forwards the call and stores nothing, not the key, not the question, not the answer. The key stays in this browser.

Get a key and credits at orbio.so; the protocol for agents is on its agents page. Treat the answer as a reading of the numbers, not as advice. Profit is not guaranteed and another runner can take a gap first.

One request per question. The quote is fetched fresh each time.

Limits

Auth
none
Rate
60 requests per minute per IP
Cache
10 seconds per answer
Read budget
about 8 seconds, then the snapshot
CORS
GET from any origin
Over the limit
429 with retryAfterSec
  • A quote is a simulation against the block it was read at, not the block your transaction lands in. Another runner can take the gap first, and a cycle that no longer pays reverts and costs gas.
  • The API reads a public node through a small relay; under load an answer can arrive as the dated snapshot ("snapshot": true, "snapshotDate" set) or as the last good value ("stale": true). Check those two fields before acting.
  • Feeds and pools are third-party contracts that Orbistocks does not control. The analyst only reads the JSON it is given and can still misread it.
  • Need more than sixty calls a minute? Read the chain directly: the pool and token addresses are in every answer and the engine's quote functions are public.