{"uid":"cap_jWIw294auXs0OJ-CBXxw8","slug":"robinhood-chain-rh-stock-spreads-api-532ffb9c","name":"Robinhood Chain RH Stock Spreads API","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-spreads?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body","example"],"properties":{"body":{"type":"object","required":[],"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"example":{"type":"object","required":[],"properties":{}},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type","example","schema"],"properties":{"type":{"type":"string"},"schema":{"type":"object"},"example":{"type":"object","required":["chain_id","slot_ts","spreads","meta"],"properties":{"meta":{"type":"object"},"chain":{"type":"string"},"slot_ts":{"type":"string"},"spreads":{"type":"array"},"chain_id":{"type":"integer"},"slot_ts_epoch":{"type":"integer"},"granularity_minutes":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["chain_id","chain","slot_ts","slot_ts_epoch","granularity_minutes","spreads","meta"],"properties":{"meta":{"type":"object"},"chain":{"type":"string"},"slot_ts":{"type":"string"},"spreads":{"type":"array"},"chain_id":{"type":"integer"},"slot_ts_epoch":{"type":"integer"},"granularity_minutes":{"type":"integer"}}},"example":{"meta":{"stale":false,"coverage_from":"2026-10-23","missing_symbols":[],"data_age_seconds":120,"symbols_expected":12,"symbols_returned":12},"chain":"robinhood-chain","slot_ts":"2026-11-04T16:01:47+00:00","spreads":[{"fee":500,"pool":"0xd4EB21209C4D6093f80B5b84f5C45cc093EA14a3","quote":"USDG","symbol":"NVDA","pool_type":"uniswap_v3","spread_24h":{"samples":288,"window_hours":24,"avg_spread_pct":0.03,"max_spread_pct":0.61,"min_spread_pct":-0.42},"spread_pct":0.0704,"token_address":"0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC","us_market_open":true,"token_price_usd":202.972852,"pool_liquidity_usd":2570811.04,"token_price_v4_usd":202.900774}],"chain_id":4663,"slot_ts_epoch":1793808107,"granularity_minutes":5}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4jsJQDd-0uJi454AZhfdm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time bid-ask spread data for tokenized US equities trading on Robinhood Chain (chain ID 4663), including pool liquidity, token prices, and 24-hour spread statistics.","exampleAgentPrompt":"What are the current bid-ask spreads and pool liquidity for tokenized stocks on Robinhood Chain, and is the US market open right now?","exampleUseCases":[{"title":"Pre-trade slippage check for NVDA","prompt":"Before I swap into the NVDA token on Robinhood Chain, can you pull the current spread percentage and pool liquidity so I know what slippage to expect?"},{"title":"Monitor spread anomalies across RH stocks","prompt":"Check the latest spreads for all tokenized stocks on Robinhood Chain and flag any where the current spread is more than 5x the 24-hour average — something might be off."},{"title":"Compare token price vs reference price","prompt":"Pull the current token price and the Uniswap V4 price for the tokenized equities on Robinhood Chain and show me which ones have the biggest discrepancy between the two prices."}],"resultDescription":"A JSON object containing: chain ID and name (robinhood-chain), a slot timestamp and epoch, granularity in minutes (5), and an array of spread objects each with symbol, pool address, pool type (uniswap_v3), fee tier, token address, current spread percentage, 24h spread stats (avg/min/max spread, sample count), token price in USD, V4 token price, pool liquidity in USD, quote asset (USDG), and whether the US market is currently open. Also includes metadata with staleness flag, data age in seconds, coverage date, and symbol counts.","failureModes":["HTTP 402 returned if payment not provided — must pay 0.005 USDC via x402 protocol and retry with PAYMENT-SIGNATURE header","Stale data flag in meta if data is older than expected (data_age_seconds elevated)","Missing symbols in meta.missing_symbols if some equities have no pool data","symbols_returned < symbols_expected if some pools are unavailable","Network timeout if Robinhood Chain RPC is slow","Invalid or missing PAYMENT-SIGNATURE header results in 402 re-prompt"],"whenToPreferThis":"Use this endpoint when you need real-time spread and liquidity data specifically for tokenized US equities trading on Robinhood Chain (chain ID 4663) via Uniswap V3 pools. It is the right choice when you need to assess pre-trade cost, monitor spread anomalies, compare token prices against reference prices, or check whether the US equity market is currently open. Prefer this over generic DEX aggregators when the target chain is Robinhood Chain and assets are tokenized stocks quoted in USDG.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T12:39:39.302Z","isFirstParty":false,"canonicalSlug":"robinhood-chain-rh-stock-spreads-api-532ffb9c"}