{"uid":"cap_GF5qi0uy-ESSKZ6crNM-F","slug":"robinhood-stock-spread-history-api-x402-bea70161","name":"Robinhood Stock Spread History API (x402)","description":"USDC pay-per-call APIs for AI agents via the x402 protocol (v2, exact, Base mainnet). Send a request, receive HTTP 402 with payment requirements, pay with @x402/fetch or any x402 client, retry with the PAYMENT-SIGNATURE header.","url":"https://call402.com/api/rh-stock-spread-history?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"hours":{"type":"integer","description":"Window length in hours, 1-720 (default 24), ending at the latest available sample"},"symbol":{"type":"string","description":"One of NVDA, TSLA, AAPL, MSFT, AMZN, META, GOOGL, AMD, COIN, PLTR, SPY, QQQ (required)"}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["chain_id","chain","symbol","granularity_minutes","points","meta"],"properties":{"meta":{"type":"object"},"chain":{"type":"string"},"points":{"type":"array"},"symbol":{"type":"string"},"chain_id":{"type":"integer"},"granularity_minutes":{"type":"integer"}}},"example":{"meta":{"to":"2026-11-04T16:01:47+00:00","from":"2026-11-03T16:01:47+00:00","stale":false,"coverage_from":"2026-10-23","requested_hours":24,"returned_points":288,"data_age_seconds":120},"chain":"robinhood-chain","points":[{"ts":"2026-11-04T16:01:47+00:00","ts_epoch":1793808107,"spread_pct":0.0704,"us_market_open":true,"token_price_usd":202.972852,"pool_liquidity_usd":2570811.04,"token_price_v4_usd":202.900774}],"symbol":"NVDA","chain_id":4663,"granularity_minutes":5}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DIiVVyzpoKYY3glk0UCx0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns time-series bid-ask spread and price data for major US stocks and ETFs via on-chain Robinhood liquidity pools, over a configurable trailing window up to 720 hours.","exampleAgentPrompt":"Pull the last 48 hours of bid-ask spread history for NVDA — I want to see how the spread percentage and pool liquidity have moved over that window.","exampleUseCases":[{"title":"Spread spike alert for trading bot","prompt":"Fetch the last 6 hours of spread history for TSLA so I can check if the spread spiked above 0.1% at any point during today's session."},{"title":"Liquidity trend analysis for COIN","prompt":"Give me 30 days of spread and pool liquidity data for COIN — I want to understand how on-chain liquidity has changed over the past month."},{"title":"Pre-trade spread check for SPY","prompt":"Before I execute a large SPY trade, can you pull the last 2 hours of spread data so I can see how tight the bid-ask is right now versus the recent average?"}],"resultDescription":"A JSON object containing an array of time-series data points (5-minute granularity) each with timestamp, spread percentage, US market open flag, token price in USD (both v3 and v4 pool), and pool liquidity in USD. Also includes metadata with the requested window, actual coverage range, number of returned points, and data freshness (age in seconds).","failureModes":["Unsupported symbol returns an error — only the 12 listed tickers (NVDA, TSLA, AAPL, MSFT, AMZN, META, GOOGL, AMD, COIN, PLTR, SPY, QQQ) are valid","Hours value outside 1-720 range may return an error or be clamped","HTTP 402 returned on first call with payment requirements — must pay 0.01 USDC via x402 protocol and retry with PAYMENT-SIGNATURE header","Stale data flag in meta indicates the latest sample may be older than expected","No data available before coverage_from date returns fewer points than requested"],"whenToPreferThis":"Use this endpoint when you need granular, time-series bid-ask spread and on-chain liquidity data for major US equities and ETFs — specifically sourced from Robinhood's on-chain tokenized stock pools on Robinhood Chain. Prefer this over generic price feeds when market microstructure metrics (spread %, pool depth) matter, such as for execution quality analysis, liquidity monitoring, or spread arbitrage signals. The pay-per-call x402 model makes it cost-effective for sporadic agent queries without a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T12:41:01.266Z","isFirstParty":false,"canonicalSlug":"robinhood-stock-spread-history-api-x402-bea70161"}