# Octio > Octio (https://www.octio.xyz) sells pay-per-call data endpoints to AI agents. Calls are paid in CREDIT from a prepaid balance; a call is charged only when it succeeds. Everything below works without a human. - Agent API: https://www.octio.xyz/v1 (JSON, snake_case, amounts are decimal strings, addresses EIP-55) - MCP server: https://www.octio.xyz/mcp (Streamable HTTP). Search and read endpoints without a key; the paid tools take the same API key as the API, or an app's OAuth sign-in. - Chain: Robinhood Chain (chain id 4663). Gas is ETH. - CREDIT token (6 decimals): 0xE33322DA1380e61E5Ae5DfB21e7f62924c73004C - USDG token (6 decimals): 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168 - Orbio exchange (USDG -> CREDIT): 0x6951fFd32630b05e06F50062AEA801625A58eBC0 - Deposit address: 0x75bF3FfC85D451554c31A669315d728179a807EE - Endpoints: section "Endpoints" below; every param and response schema: https://www.octio.xyz/llms-full.txt; OpenAPI 3.1: https://www.octio.xyz/openapi.json - Discovery: MCP server card https://www.octio.xyz/mcp/server-card; AI Catalog https://www.octio.xyz/.well-known/ai-catalog.json; ERC-8004 registration file https://www.octio.xyz/.well-known/agent-registration.json ## Fund, then call 1. Create a key: sign a SIWE message with your owner wallet, then POST https://www.octio.xyz/v1/auth/keys (section 1). 2. Fund it: send CREDIT from the owner wallet to the deposit address, or buy CREDIT with USDG through GET https://www.octio.xyz/v1/credit/buy (section 2). 3. Call: https://www.octio.xyz/v1 with Authorization: Bearer (section 3). Free calls: a new account's first 3 calls to the Octio house data endpoints are free, so you can try them before you hold any CREDIT (free_calls in the catalog; one counter per account, shared by every endpoint with free calls, /ask included). POST https://www.octio.xyz/v1/ask gives the first 20 questions free, so you can try it before step 2. Selling an API of your own: a key that can publish lists it under https://www.octio.xyz/v1/publish (section 4). ## Endpoints The 41 listed endpoints, from the live catalog. Call them as section 3 says; prices are in CREDIT and a failed call is not charged. Every param and response schema: https://www.octio.xyz/llms-full.txt. OpenAPI 3.1: https://www.octio.xyz/openapi.json. ### Agent data - GET https://www.octio.xyz/v1/agents/leaderboard (0.002 CREDIT per successful call; or 0.01 USDC per call with x402, no account). Agent leaderboard: Orbio agent tokens ranked by market cap, by ORBIO fees harvested in the last 24 hours (from the agent vault’s FeesSplit events on Robinhood Chain) or by share of the vault’s staked ORBIO. Query: sort (default "market_cap"), limit (default 20), graduated. Details: https://www.octio.xyz/endpoints/agents-leaderboard ### Market data - GET https://www.octio.xyz/v1/credit/discounts (0.002 CREDIT per successful call). CREDIT discounts: The live CREDIT order book of the Orbio exchange on Robinhood Chain: every price level with CREDIT for sale, its discount to $1 of face value, and the cost of one CREDIT through buy (exchange fee inc… No params. Details: https://www.octio.xyz/endpoints/credit-discounts - GET https://www.octio.xyz/v1/defi/price (0.001 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Token prices: Current USD prices of up to 10 tokens by chain:address (Ethereum, Base, Robinhood Chain as robinhood:0x…, Solana and more) or CoinGecko id, with symbol, decimals, price time and DefiLlama’s confidenc… Query: coins (required). Details: https://www.octio.xyz/endpoints/defi-price - GET https://www.octio.xyz/v1/defi/stablecoins (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Stablecoin supply and pegs: Stablecoins by circulating supply, overall or on one chain (Robinhood Chain included): price, deviation from a USD peg, 1 / 7 / 30-day supply change, peg type and mechanism, and the largest chains. Query: peg, sort (default "circulating_desc"), chain, limit (default 20), symbol, min_circulating (default 1000000). Details: https://www.octio.xyz/endpoints/defi-stablecoins - GET https://www.octio.xyz/v1/defi/tvl (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). DeFi TVL: Total value locked of a DeFi protocol (with 1 h / 1 d / 7 d change, market cap to TVL and TVL per chain) or of a chain (with 1 / 7 / 30-day change from daily values and its largest protocols), Robinh… Query: chain, protocol. Details: https://www.octio.xyz/endpoints/defi-tvl - GET https://www.octio.xyz/v1/defi/yields (0.003 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). DeFi yields: Top DeFi yield pools filtered by chain, project, asset, minimum TVL, stablecoin-only, exposure and impermanent-loss risk, sorted by APY, base APY, 30-day mean APY or TVL: base and reward APY, APY cha… Query: sort (default "apy_desc"), asset, chain, limit (default 10), il_risk, project, exposure, min_tvl_usd (default 1000000) and 2 more. Details: https://www.octio.xyz/endpoints/defi-yields - GET https://www.octio.xyz/v1/macro/calendar (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). US macro calendar: Upcoming and recent US macro events for trading agents: FOMC rate decisions (with projections), FOMC minutes and the Beige Book (Federal Reserve Board), CPI, PPI, the jobs report, JOLTS and ECI (BLS)… Query: limit (default 100), category (default "all"), days_back (default 7), days_ahead (default 14), importance (default "medium"). Details: https://www.octio.xyz/endpoints/macro-calendar - GET https://www.octio.xyz/v1/macro/series (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). US economic series: Latest values and up to 60 past observations of key US economic series, read from FRED (St. Query: series, history (default 12). Details: https://www.octio.xyz/endpoints/macro-series - GET https://www.octio.xyz/v1/macro/yields (0.001 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). US Treasury yield curve: The latest US Treasury par yield curve from 1 month to 30 years (the U.S. Query: history_days (default 0). Details: https://www.octio.xyz/endpoints/macro-yields - GET https://www.octio.xyz/v1/markets/backtest (0.005 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Market backtest: Backtests one rule from a fixed menu (RSI thresholds, EMA cross, Bollinger band touch, channel breakout; long or short; optional stop loss and take profit) on up to 600 closed candles of a crypto, US… Query: symbol (required), strategy (required), fast, side (default "long"), slow, lower, upper, period and 7 more. Details: https://www.octio.xyz/endpoints/markets-backtest - GET https://www.octio.xyz/v1/markets/candles (0.001 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Market candles: OHLCV candles with trade counts for major crypto, US stocks, indexes and commodities, 15m to 1w, up to 500 per call, newest last. Query: symbol (required), limit (default 100), interval (default "4h"). Details: https://www.octio.xyz/endpoints/markets-candles - GET https://www.octio.xyz/v1/markets/correlation (0.003 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Market correlation: Rolling correlation matrix of 2 to 10 markets (crypto, US stocks, indexes, commodities) from the log returns of closed candles aligned on candle time (default 1d, the last 30 shared returns), with ea… Query: symbols (required), window (default 30), interval (default "1d"), benchmark. Details: https://www.octio.xyz/endpoints/markets-correlation - GET https://www.octio.xyz/v1/markets/funding (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Cross-exchange funding: Perpetual funding rates on Hyperliquid next to Binance and Bybit for major crypto (and Hyperliquid alone for US stocks, indexes and commodities on trade.xyz): each venue’s predicted rate for its next… Query: sort (default "max_spread_desc"), symbol. Details: https://www.octio.xyz/endpoints/markets-funding - GET https://www.octio.xyz/v1/markets/hours (0.001 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Market hours: Whether markets are open now and when they next open or close: the US equity session (regular, extended, overnight or closed, with NYSE holidays and early closes), CME Globex futures hours for gold,… Query: symbol. Details: https://www.octio.xyz/endpoints/markets-hours - GET https://www.octio.xyz/v1/markets/indicator (0.001 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Market indicator: One technical indicator (RSI, EMA, SMA, MACD, Bollinger bands, ATR or stochastic) for a crypto, US stock, index or commodity market on 15m to 1w candles: the latest value, or a series of up to 200 wi… Query: symbol (required), indicator (required), limit (default 1), period, interval (default "4h"), closed_only (default false). Details: https://www.octio.xyz/endpoints/markets-indicator - GET https://www.octio.xyz/v1/markets/levels (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Market levels: Support and resistance for a crypto, US stock, index or commodity market: classic, Fibonacci and Camarilla pivot points from the previous complete UTC day, ISO week or month (built from daily candles… Query: symbol (required), swings (default 5), interval (default "4h"), pivot_period, swing_strength (default 3). Details: https://www.octio.xyz/endpoints/markets-levels - GET https://www.octio.xyz/v1/markets/liquidity (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Market liquidity: The visible order book of a crypto, US stock, index or commodity market: best bid and ask, spread, USD depth within 0.1%, 0.5%, 1% and 2% of mid, and for an order size from $100 to $10M the average a… Query: symbol (required), side (default "both"), size_usd (default 10000). Details: https://www.octio.xyz/endpoints/markets-liquidity - GET https://www.octio.xyz/v1/markets/patterns (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Market patterns: Candlestick patterns on the latest closed candles of a crypto, US stock, index or commodity market (doji, hammer, hanging man, inverted hammer, shooting star, engulfing, harami, morning and evening s… Query: symbol (required), interval (default "4h"), lookback (default 10), swing_strength (default 3). Details: https://www.octio.xyz/endpoints/markets-patterns - GET https://www.octio.xyz/v1/markets/position-size (0.001 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Position size: Position size for a risk budget: account size, risk percent, side, entry and stop (or a stop at a multiple of the live ATR 14) and leverage give the quantity, notional, margin, effective leverage and… Query: side (required), account_usd (required), stop, entry, symbol, fee_bps (default 0), interval (default "4h"), leverage (default 1) and 3 more. Details: https://www.octio.xyz/endpoints/markets-position-size - GET https://www.octio.xyz/v1/markets/scan (0.005 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Market scan: Screens every symbol (major crypto, US stocks, indexes and commodities), or one asset class, on one interval: price, 24 h change, volume, open interest, funding, RSI 14, MACD histogram, price against… Query: sort (default "volume_desc"), limit (default 10), interval (default "4h"), rsi_above, rsi_below, asset_class. Details: https://www.octio.xyz/endpoints/markets-scan - GET https://www.octio.xyz/v1/markets/snapshot (0.003 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Market snapshot: Price, 24 h change, volume, open interest and funding for major crypto, US stocks, indexes and commodities, with RSI 14, MACD 12/26/9, EMA 20/50/200, SMA 20/50, Bollinger 20/2 and ATR 14 on the chose… Query: symbol (required), interval (default "4h"), closed_only (default false). Details: https://www.octio.xyz/endpoints/markets-snapshot - GET https://www.octio.xyz/v1/markets/volatility (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Market volatility: Volatility of a crypto, US stock, index or commodity market from closed candles (default 1d): realized volatility over the last 10, 20, 50 and 100 returns (close-to-close sample standard deviation of… Query: symbol (required), interval (default "1d"). Details: https://www.octio.xyz/endpoints/markets-volatility - GET https://www.octio.xyz/v1/predictions/odds (0.001 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Prediction market odds: The current odds of one Polymarket market (by slug or id), or of every market in a multi-outcome event (by event slug, highest first): outcome prices as implied probabilities, best bid and ask, last… Query: event, market. Details: https://www.octio.xyz/endpoints/predictions-odds - GET https://www.octio.xyz/v1/predictions/search (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Prediction market search: Open Polymarket prediction markets by keyword and topic (crypto, politics, elections, geopolitics, macro, Fed, finance, stocks, earnings, tech, sports), sorted by 24 h volume, liquidity, end date or… Query: q, tag, sort (default "volume_24h"), limit (default 10). Details: https://www.octio.xyz/endpoints/predictions-search - GET https://www.octio.xyz/v1/robinhood/premium (0.003 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Robinhood stock-token premium: How far the Uniswap price of a Robinhood stock token (NVDA, TSLA, AAPL and nine more) on Robinhood Chain sits from the stock elsewhere: the premium in bps against the Hyperliquid perpetual (24/7) and… Query: symbol (required), sizes_usd (default "1000,10000"). Details: https://www.octio.xyz/endpoints/robinhood-premium - GET https://www.octio.xyz/v1/stocks/filings (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Company filings: Recent SEC filings of a large US stock from the SEC EDGAR filing index (public US government data, re-read every 10 minutes): form type with a plain-English name, filing and acceptance time, period d… Query: symbol (required), days (default 90), forms, limit (default 25), include_insider (default false). Details: https://www.octio.xyz/endpoints/stocks-filings - GET https://www.octio.xyz/v1/stocks/fundamentals (0.003 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Company fundamentals: Key financials of a large US stock as filed in its 10-K and 10-Q reports, from SEC EDGAR XBRL company facts (public US government data; re-read every 6 hours and soon after a new report): revenue, ne… Query: symbol (required). Details: https://www.octio.xyz/endpoints/stocks-fundamentals - GET https://www.octio.xyz/v1/stocks/insiders (0.003 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Insider trades: Recent insider trades in a large US stock from SEC Form 4 filings on SEC EDGAR (public US government data): who traded (name, officer title, director or 10% owner), when, shares, price, value, shares… Query: symbol (required), days (default 90), type (default "all"), limit (default 25), include_derivative (default false). Details: https://www.octio.xyz/endpoints/stocks-insiders ### Risk - GET https://www.octio.xyz/v1/agents/risk (0.01 CREDIT per successful call; or 0.01 USDC per call with x402, no account). Agent risk: Risk signals for one Orbio agent token: principal the owner has withdrawn from the vault, the owner’s other launches and their withdrawals, holder concentration from the token’s Transfer history, lau… Query: token (required). Details: https://www.octio.xyz/endpoints/agents-risk - GET https://www.octio.xyz/v1/chain/address-check (0.001 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Address check: What an address on Robinhood Chain or Base is before you send to it or approve it: account or contract, EIP-7702 delegation (and to what), EIP-1967 or minimal proxy (implementation and admin), token… Query: address (required), chain (default "robinhood"). Details: https://www.octio.xyz/endpoints/chain-address-check - GET https://www.octio.xyz/v1/chain/token-check (0.005 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Token risk check: Pre-trade risk check of an ERC-20 on Robinhood Chain or Base, read live from the chain RPC (cached up to 60 s): proxy and upgradeability, owner and whether ownership is renounced, paused state, suppl… Query: token (required), chain (default "robinhood"). Details: https://www.octio.xyz/endpoints/chain-token-check - GET https://www.octio.xyz/v1/chain/tx/simulate (0.005 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Simulate a transaction: Simulates a transaction on Robinhood Chain or Base at the latest block before you sign it: success or revert (with the decoded reason or custom error), gas used and a gas estimate, the decoded call (… Query: to (required), from (required), gas, data (default "0x"), chain (default "robinhood"), value (default "0"). Details: https://www.octio.xyz/endpoints/chain-tx-simulate - POST https://www.octio.xyz/v1/safety/injection-scan (0.001 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Prompt injection scan: Checks text (up to 100,000 characters) or a web page for prompt-injection attempts before an AI agent reads it: hidden instructions ("[removed]"), chat-template and role markers, tool-call bait, requ… JSON body: url, text. Details: https://www.octio.xyz/endpoints/safety-injection-scan - GET https://www.octio.xyz/v1/safety/url-check (0.001 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). URL safety check: Whether a URL is on public threat feeds of malware and phishing URLs (URLhaus by abuse.ch and PhishTank, downloaded in the background), with each matching source and when it was downloaded, plus stat… Query: url (required). Details: https://www.octio.xyz/endpoints/safety-url-check ### Answers - POST https://www.octio.xyz/v1/ask (0.01 CREDIT per successful call; 20 free calls per account). Ask: A short plain-text answer about Orbio agents and the CREDIT market, written by an LLM only from this market’s own house data (leaderboard, discounts and risk), with the datasets it used. JSON body: question (required), max_cost. Details: https://www.octio.xyz/endpoints/ask ### Other - GET https://www.octio.xyz/v1/chain/gas (0.001 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Gas prices: Current gas on Robinhood Chain or Base from the chain RPC (cached up to 5 s): base fee and next base fee, priority-fee percentiles over the last 20 blocks, slow/standard/fast EIP-1559 suggestions, an… Query: chain (default "robinhood"). Details: https://www.octio.xyz/endpoints/chain-gas - GET https://www.octio.xyz/v1/chain/tx/explain (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Explain a transaction: Explains a mined transaction on Robinhood Chain or Base: status, block time, gas and fee, the decoded call, every decoded event (token transfers, approvals, Uniswap v2/v3/v4 swaps and more) with toke… Query: hash (required), chain (default "robinhood"). Details: https://www.octio.xyz/endpoints/chain-tx-explain - GET https://www.octio.xyz/v1/chain/wallet (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Wallet balances: Balances of an address on Robinhood Chain or Base, read live from the chain RPC in one multicall (cached up to 15 s): native ETH plus a fixed token list (Robinhood Chain: WETH, USDG, CREDIT and the R… Query: address (required), chain (default "robinhood"). Details: https://www.octio.xyz/endpoints/chain-wallet - GET https://www.octio.xyz/v1/docs/pdf-text (0.003 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). PDF text: The text of a public PDF (up to 15 MB), page by page, with page count and document metadata (title, author, dates, producer). Query: url (required), pages, max_chars (default 50000). Details: https://www.octio.xyz/endpoints/docs-pdf-text - GET https://www.octio.xyz/v1/web/meta (0.0005 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Web page metadata: Title, description, Open Graph and Twitter card fields, favicon, canonical URL, site name, language, author and dates of a public web page, with its final URL after redirects, HTTP status and content… Query: url (required). Details: https://www.octio.xyz/endpoints/web-meta - GET https://www.octio.xyz/v1/web/read (0.002 CREDIT per successful call; 3 free calls per account; or 0.01 USDC per call with x402, no account). Read a web page: The main content of a public web page as clean Markdown (navigation, ads and boilerplate removed), with title, byline, published date, site name, canonical URL, language, word count and optionally it… Query: url (required), max_chars (default 20000), include_links (default false). Details: https://www.octio.xyz/endpoints/web-read ## 1. Get an API key (Sign-In with Ethereum, EIP-4361) Your account belongs to one wallet, the owner wallet. Use the same wallet for every step below. 1. GET https://www.octio.xyz/v1/auth/nonce -> {"nonce": "...", "issued_at": "..."}. A nonce works once and expires after 10 minutes. 2. Sign this exact message (personal_sign) with the owner wallet. Use the checksummed address and the server issued_at as Issued At, copied verbatim. Lines end in LF (not CRLF), with no newline after the Issued At line: the server accepts only this exact form (what viem createSiweMessage writes). ``` www.octio.xyz wants you to sign in with your Ethereum account: Create an Octio API key URI: https://www.octio.xyz Version: 1 Chain ID: 4663 Nonce: Issued At: ``` 3. POST https://www.octio.xyz/v1/auth/keys with JSON {"message": "", "signature": "0x...", "name": "