# Robinhood Chain Tokenized Stock Liquidity Map

> Robinhood Chain Tokenized Stock Liquidity Map is a paid API for AI agents from x402-services-production.up.railway.app, paid per call via x402, $0.005/call, status healthy (last checked 2026-09-15).

Returns a real-time liquidity map for a tokenized stock or ETF on Robinhood Chain, showing order book depth, bid/ask spreads, and liquidity distribution across price levels.

## Facts

- Endpoint: POST https://x402-services-production.up.railway.app/api/rh/liquidity-map
- Price: $0.005/call
- Payment: x402
- Status: healthy
- Last checked: 2026-09-15
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/robinhood-chain-tokenized-stock-liquidity-map-274c7262
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_luNB9affhanMsI8S-U9wN

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-tokenized-stock-liquidity-map-274c7262 -d '<json body>'
```

Example prompt: Can you pull the full liquidity map for NVDA on Robinhood Chain right now — I want to see the order book depth and where the liquidity is concentrated before I size into a position.

## When to prefer this

Use this endpoint when an agent needs to assess on-chain liquidity depth for a tokenized stock or ETF specifically on Robinhood Chain before executing or sizing a trade. It is most relevant when the user's goal involves understanding slippage risk, spread conditions, or order book concentration for tokenized equities — as opposed to price alone (use a price feed) or off-chain equity liquidity (use a traditional market data provider).

## Known failure modes

- Invalid or unsupported ticker returns an error or empty result
- Ticker exists on traditional markets but has no tokenized representation on Robinhood Chain
- Network or oracle latency causes stale or missing data
- Payment not settled in an accepted stablecoin results in 402 rejection
- Rate limits exceeded due to high-frequency polling

## How this service works

Liquidity map for a tokenized stock: aggregates every indexed Robinhood Chain pool and breaks down where the liquidity lives venue by venue (Uniswap/Pleiades/Rialto/Arcus...), with each venue's liquidity, 24h volume, price, and liquidity share. Send { ticker }. Route large orders to the deepest venues and avoid thin pools.

## Output

A structured liquidity map for the requested tokenized stock or ETF on Robinhood Chain, including order book depth at various price levels, bid/ask spreads, and the concentration of liquidity across the price curve — enabling agents to assess execution quality and slippage risk before placing trades.

## Example request

```json
{
 "input": {
  "body": {
   "depth": "full",
   "ticker": "AAPL"
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json"
 }
}
```

## 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"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "note",
  "chain",
  "source",
  "ticker",
  "venues",
  "venueCount",
  "deepestVenue",
  "equityRefUsd",
  "canonicalToken",
  "totalLiquidityUsd"
 ],
 "properties": {
  "note": {
   "type": "string"
  },
  "chain": {
   "type": "string"
  },
  "source": {
   "type": "string"
  },
  "ticker": {
   "type": "string"
  },
  "venues": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "dex",
     "pools",
     "bestPriceUsd",
     "liquidityUsd",
     "volume24hUsd",
     "liquiditySharePct"
    ],
    "properties": {
     "dex": {
      "type": "string"
     },
     "pools": {
      "type": "number"
     },
     "bestPriceUsd": {
      "type": "number"
     },
     "liquidityUsd": {
      "type": "number"
     },
     "volume24hUsd": {
      "type": "number"
     },
     "liquiditySharePct": {
      "type": "number"
     }
    }
   }
  },
  "venueCount": {
   "type": "number"
  },
  "deepestVenue": {
   "type": "string"
  },
  "equityRefUsd": {
   "type": "number"
  },
  "canonicalToken": {
   "type": "string"
  },
  "totalLiquidityUsd": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/robinhood-chain-tokenized-stock-liquidity-map-274c7262/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-services-production.up.railway.app](https://www.zero.xyz/host/x402-services-production.up.railway.app/llms.txt)