{
  "ok": true,
  "data": {
    "name": "Rialto hosted API",
    "openapi": "https://rialto.casa/openapi.json",
    "llms": "https://rialto.casa/llms.txt",
    "mcp": "https://rialto.casa/mcp",
    "docs": "https://rialto.casa/docs",
    "tiers": [
      {
        "name": "Pro",
        "minRialto": 1000000,
        "requestsPerMinute": 600
      },
      {
        "name": "Holder",
        "minRialto": 300000,
        "requestsPerMinute": 120
      },
      {
        "name": "Free",
        "minRialto": 0,
        "requestsPerMinute": 30
      }
    ],
    "endpoints": [
      {
        "method": "GET",
        "path": "/api/chain",
        "summary": "Robinhood Chain status: chain id, latest block, gas price, USDG supply, measured vitals (blocks per second, block time, transfer fee in ETH and USD)",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/stocks",
        "summary": "Seed registry of official stock tokens, or search by ticker with ?q=.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/stocks/{symbol}",
        "summary": "USD price of a tokenized stock (ticker or contract).",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/wallet/{address}",
        "summary": "Wallet report: ETH, USDG, Rialto, stock tokens, tx count, contract flag.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/portfolio/{address}",
        "summary": "Holder tier. Every known asset priced in USD with a total.",
        "tier": "Holder"
      },
      {
        "method": "GET",
        "path": "/api/pools",
        "summary": "Top pools on Robinhood Chain by 24h volume.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/token",
        "summary": "Rialto token stats: price, FDV, liquidity, 24h volume, main pool, volume since launch summed over every pool.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/token/burns",
        "summary": "Every burn of the Rialto token, from the chain logs.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/token/holders",
        "summary": "Holder statistics replayed from the full transfer history.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/token/history",
        "summary": "Day-by-day growth replayed from every transfer: holders, cumulative burned, transfers, wallets ever; plus the current wallet distribution by tier bucket.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/token/wallet/{address}",
        "summary": "Where a wallet stands on the Rialto ledger: rank among holders, share, tier, wallet number since launch, first seen, days held, received, sent, burned, day-one and diamond-hands flags, badge URL, share text.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/token/leaderboard",
        "summary": "Top Rialto holders with rank, share, first day, wallet number, diamond-hands and day-one flags; cohort figures (diamond hands, day-one wallets still holding, exited, median balance).",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/badge/{address}.svg",
        "summary": "Embeddable SVG badge of a wallet: rank, balance, never-sold and day-one flags. image/svg+xml, not a JSON envelope.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/token/ohlcv",
        "summary": "Hourly candles for the Rialto pool.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/live/pulse",
        "summary": "One-shot live summary: latest block, USDG flow, Rialto tape.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/live/transfers",
        "summary": "USDG transfers over the last N blocks: count, volume, largest, latest.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/live/trades",
        "summary": "Recent trades for RIALTO, AAPL, TSLA, NVDA, a ticker or a pool.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/access",
        "summary": "Your tier from the access token you send (x-rialto-auth, Bearer, or ?auth=).",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/access/{address}",
        "summary": "The tier an address would get from its Rialto balance.",
        "tier": "Free"
      },
      {
        "method": "POST",
        "path": "/api/batch",
        "summary": "Pro tier. Up to 20 tool calls in one request.",
        "tier": "Pro"
      },
      {
        "method": "POST",
        "path": "/api/chat",
        "summary": "Forward one Venice chat request signed by the caller's wallet (SIGN-IN-WITH-X). The server keeps nothing.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/check/{address}",
        "summary": "Token check for any contract on Robinhood Chain: identity, supply, age, holders, concentration, liquidity, flags.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/flywheel",
        "summary": "Treasury revenue from x402 payments, Rialto bought back and burned, balances, pay-per-call prices.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/x402/check/{address}",
        "summary": "Pay-per-call token check, 0.02 USDG on Robinhood Chain via x402 (answers 402 with PAYMENT-REQUIRED; send PAYMENT-SIGNATURE).",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/x402/portfolio/{address}",
        "summary": "Pay-per-call portfolio, 0.01 USDG via x402, no Holder tier needed.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/x402/pulse",
        "summary": "Pay-per-call live pulse, 0.005 USDG via x402.",
        "tier": "Free"
      },
      {
        "method": "POST",
        "path": "/x402/batch",
        "summary": "Pay-per-call batch of up to 20 tool calls, 0.05 USDG via x402, no Pro tier needed.",
        "tier": "Free"
      },
      {
        "method": "GET",
        "path": "/api/status",
        "summary": "Health of the RPC pool, GeckoTerminal, Venice, the bridges and the explorer.",
        "tier": "Free"
      }
    ]
  }
}