# Robinhood Chain RH Stock Spreads API

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

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.

## Facts

- Endpoint: POST https://call402.com/api/rh-stock-spreads?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/robinhood-chain-rh-stock-spreads-api-532ffb9c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jWIw294auXs0OJ-CBXxw8

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-chain-rh-stock-spreads-api-532ffb9c -d '<json body>'
```

Example prompt: What are the current bid-ask spreads and pool liquidity for tokenized stocks on Robinhood Chain, and is the US market open right now?

## When to prefer this

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.

## Known failure modes

- 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

## 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: 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.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/robinhood-chain-rh-stock-spreads-api-532ffb9c/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)
