# Robinhood Stock Spread History API (x402)

> Robinhood Stock Spread History API (x402) is a paid API for AI agents from call402.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-20).

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.

## Facts

- Endpoint: POST https://call402.com/api/rh-stock-spread-history?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/robinhood-stock-spread-history-api-x402-bea70161
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GF5qi0uy-ESSKZ6crNM-F

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability robinhood-stock-spread-history-api-x402-bea70161 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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).

## Request schema (JSON Schema)

```json
{
 "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)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/robinhood-stock-spread-history-api-x402-bea70161/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from call402.com](https://www.zero.xyz/host/call402.com/llms.txt)
