[08]Docs

OrbioIndex APIRead-only JSON over HTTPS

Read-only, JSON over HTTPS, the same data as this site. Machine-readable: openapi.json · llms.txt

Fig. 08Scroll on a broken tablet. Everything, written down.

Authentication

Create a key on API & MCP after signing in with your wallet, then send it on every request:

curl https://www.orbioindex.dev/api/v1/overview -H "Authorization: Bearer oidx_YOUR_KEY"

Responses are { "data": ... }. Amounts are in whole tokens (CREDIT and USDG have 6 decimals on chain, ORBIO 18). Prices are USDG per CREDIT; discount is 1 - price since 1 CREDIT activates $1 of inference.

MCP server

https://www.orbioindex.dev/api/mcp speaks MCP over Streamable HTTP (stateless, JSON responses). Every endpoint below is a tool with the same name and arguments.

claude mcp add --transport http orbioindex https://www.orbioindex.dev/api/mcp \
  --header "Authorization: Bearer oidx_YOUR_KEY"

Limits

Plan	Per minute	Per day	Keys	Ask / day
free	60	5,000	5	10
pro	600	200,000	20	300

Each response carries X-RateLimit-Remaining, X-RateLimit-Reset and X-RateLimit-Daily-Remaining. Over the limit you get 429 with Retry-After.

Errors

Errors are { "error": code, "message": text } with status 400 (invalid_input), 401 (missing_api_key, invalid_api_key), 404 (not_found), 429 (rate_limited) or 5xx.

Market overview

GET /api/v1/overview

Snapshot of the whole Orbio CREDIT market: best ask and discount, order book depth, 24h and all-time volume, card purchases, activations (CREDIT burned into AI balance), CREDIT supply and holders, ORBIO staking totals and estimated APR, ORBIO and NVDA prices, and what $100 buys through buyAndActivate.

curl "https://www.orbioindex.dev/api/v1/overview" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · get_overview

Order book

GET /api/v1/orderbook

Live CREDIT order book on the Orbio Exchange, read from the contract: every price level (price in USDG per CREDIT, discount vs $1 of inference, CREDIT available, cumulative depth), open orders by source (sellers, staking auto-list, protocol fee recycling), the 40 cheapest open orders, and an integrity check comparing the index with the chain.

curl "https://www.orbioindex.dev/api/v1/orderbook" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · get_order_book

Recent trades

GET /api/v1/trades

Most recent CREDIT purchases: on-chain buys, buyAndActivate (buy and burn into AI balance in one call) and card purchases settled on chain from orbio.so. Amounts in CREDIT, USD paid and average price.

Parameter	Type	Description
limit	integer	Rows to return (1-200). (default 25)

curl "https://www.orbioindex.dev/api/v1/trades" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · get_recent_trades

Price history

GET /api/v1/price-history

CREDIT price history built from every order book fill: volume-weighted average price (USDG per CREDIT), low/high and volume per bucket.

Parameter	Type	Description
interval	1h \| 4h \| 1d	Bucket size. (default 1h)
days	integer	How many days back (1-90). (default 7)

curl "https://www.orbioindex.dev/api/v1/price-history" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · get_price_history

Staking

GET /api/v1/staking

ORBIO staking: total staked and share of supply, number of stakers, CREDIT minted to stakers in the last 24h, USD funding of the hourly harvests, estimated APR (at $1 face value and at the order book price), and the last 48 hourly harvests.

curl "https://www.orbioindex.dev/api/v1/staking" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · get_staking

Top stakers

GET /api/v1/stakers

Largest ORBIO staking positions with share of total stake, CREDIT earned, claimed and auto-listed, and auto-list price.

Parameter	Type	Description
limit	integer	Rows to return (1-500). (default 25)

curl "https://www.orbioindex.dev/api/v1/stakers" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · get_top_stakers

Top CREDIT holders

GET /api/v1/holders

Largest CREDIT balances (protocol contracts listed separately), with share of total supply.

Parameter	Type	Description
limit	integer	Rows to return (1-500). (default 25)

curl "https://www.orbioindex.dev/api/v1/holders" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · get_top_holders

Top sellers

GET /api/v1/sellers

Wallets that sold the most CREDIT on the order book, with USDG proceeds.

Parameter	Type	Description
limit	integer	Rows to return (1-200). (default 20)

curl "https://www.orbioindex.dev/api/v1/sellers" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · get_top_sellers

Activations

GET /api/v1/activations

CREDIT activations (tokens burned into Orbio AI balance — the real demand for inference): daily totals split by wallet activations, buyAndActivate and card purchases, plus the top activating wallets.

Parameter	Type	Description
days	integer	Days of daily history. (default 30)

curl "https://www.orbioindex.dev/api/v1/activations" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · get_activations

Activity feed

GET /api/v1/activity

Chronological feed of Orbio on-chain activity. Filter by kinds (comma separated): buy, buy_activate, card_buy, activation, list, autolist, cancel, claim_proceeds, claim_proceeds_orbio, stake, unstake, claim_rewards, harvest, transfer, fees_recycled, orbio_buy, orbio_sell, orbio_transfer. orbio_* rows are ORBIO whale moves (buys/sells through Uniswap v4 and large transfers).

Parameter	Type	Description
kinds	string	Comma-separated activity kinds to include.
minUsd	number	Only rows worth at least this many USD.
address	string	Wallet or contract address on Robinhood Chain.
before	integer	Unix timestamp; return rows older than this (pagination).
limit	integer	Rows to return (1-200). (default 50)

curl "https://www.orbioindex.dev/api/v1/activity" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · get_activity

Wallet

GET /api/v1/wallets/{address}

Everything about one wallet in the Orbio ecosystem: live CREDIT, ORBIO, USDG balances, staked ORBIO and rank, CREDIT earned from staking, open sell orders, CREDIT bought and sold, activations and recent activity.

Parameter	Type	Description
address *	string	Wallet or contract address on Robinhood Chain.

curl "https://www.orbioindex.dev/api/v1/wallets/0x121defc0f249cc66ab0522b8346c09790ec65999" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · get_wallet

Live buy quote

GET /api/v1/quote

Asks the Orbio Exchange contract right now what a USDG budget buys: CREDIT out, fee, fills and average price for a plain buy, and for buyAndActivate the AI balance credited and the effective cost per $1 of inference. Read-only, nothing is executed.

Parameter	Type	Description
usdg	number	USDG budget. (default 100)

curl "https://www.orbioindex.dev/api/v1/quote" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · quote_buy_credit

Protocol changes

GET /api/v1/protocol-events

Admin and treasury events on the Orbio contracts: upgrades, role changes, fee changes, payout routes, fee sweeps and settlement funding.

Parameter	Type	Description
limit	integer	Rows to return (1-200). (default 30)

curl "https://www.orbioindex.dev/api/v1/protocol-events" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · get_protocol_changes

Index status

GET /api/v1/status

How fresh the OrbioIndex data is: last indexed block, seconds since last sync, latest chain snapshot and row counts.

curl "https://www.orbioindex.dev/api/v1/status" -H "Authorization: Bearer oidx_YOUR_KEY"

MCP tool · get_index_status

Ask in plain language

POST /api/v1/ask

An analyst agent that calls the tools above and answers in prose. Its inference runs on Orbio's gateway. Counts against both the request quota and the daily Ask quota.

curl https://www.orbioindex.dev/api/v1/ask \
  -H "Authorization: Bearer oidx_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"Who sold the most CREDIT this week?"}'