Skip to content
ChordChordChord Docs

Tokenized stocks

GET
/rh/stocks
curl --request GET \
  --url https://api.getchord.xyz/v1/rh/stocks

Every tokenized stock and ETF on chain 4663 with its 24-hour tape, NAV basis where the issuer publishes a rate, and the share of the last seven days that traded outside the NYSE session. Chain 4663 only; takes no chain parameter. Served from Chord’s rollup tables, never from a raw scan. 503 NOT_READY until the rollup has run.

Responses

Section titled “ Responses ”

200

Section titled “200”
Media typeapplication/json
object
chain
integer
Allowed value: 4663
sinceHour
integer
tradersSince
integer
stocks
Array
object
address

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/
symbol
string
name
string
decimals
integer
logoURI
string | null
tags

stock, bridged, stablecoin, …

Array<string>
listed
boolean
priceUsd
number | null
change24hPct
number | null
liquidityUsd
number | null
volume24h
number
buyVolume24h
number
sellVolume24h
number
trades24h
integer
buys24h
integer
sells24h
integer
traders

Attributed wallets only.

integer
lastTradeTs

Unix time, seconds, UTC.

integer
navUsd

The issuer’s published exchange rate at last refresh; null when none is published.

number | null
basisPct

On-chain price versus NAV, percent.

number | null
offHours7d

Activity outside the NYSE regular session (09:30–16:00 New York, weekdays) over the last seven days.

object
volUsd
number
trades
integer
sharePct
number
note
string
updatedAt

Unix time, milliseconds — when the server built this answer.

integer
Example
{
  "chain": 4663,
  "sinceHour": 1789808400,
  "tradersSince": 1789776000,
  "stocks": [
    {
      "address": "0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC",
      "symbol": "NVDA",
      "name": "NVIDIA • Robinhood Token",
      "decimals": 18,
      "logoURI": "https://cdn.robinhood.com/ncw_assets/logos/0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec.png",
      "tags": [
        "stock"
      ],
      "listed": true,
      "priceUsd": 220.97693371148938,
      "change24hPct": -0.7107543259553206,
      "liquidityUsd": 7508320,
      "volume24h": 34504046.378991455,
      "buyVolume24h": 16798001.15787153,
      "sellVolume24h": 17706045.221119925,
      "trades24h": 103172,
      "buys24h": 52577,
      "sells24h": 50595,
      "traders": 5056,
      "lastTradeTs": 1789891401,
      "navUsd": null,
      "basisPct": null,
      "offHours7d": {
        "volUsd": 122712280.03735964,
        "trades": 365579,
        "sharePct": 57.75403042239189
      }
    },
    {
      "address": "0x4a0E65A3EcceC6dBe60AE065F2e7bb85Fae35eEa",
      "symbol": "SPCX",
      "name": "Space Exploration Technologies Corp • Robinhood Token",
      "decimals": 18,
      "logoURI": "https://cdn.robinhood.com/ncw_assets/logos/0x4a0e65a3eccec6dbe60ae065f2e7bb85fae35eea.png",
      "tags": [
        "stock"
      ],
      "listed": true,
      "priceUsd": 152.33158650694747,
      "change24hPct": -0.278639004753245,
      "liquidityUsd": 4756081,
      "volume24h": 14186052.186705315,
      "buyVolume24h": 7064922.470980956,
      "sellVolume24h": 7121129.715724356,
      "trades24h": 41993,
      "buys24h": 22090,
      "sells24h": 19903,
      "traders": 3138,
      "lastTradeTs": 1789891402,
      "navUsd": null,
      "basisPct": null,
      "offHours7d": {
        "volUsd": 75910449.80504468,
        "trades": 277274,
        "sharePct": 42.37032851899335
      }
    }
  ],
  "note": "offHours7d = volume in hour buckets outside the NYSE regular session (09:30-16:00 New York, Mon-Fri, DST-aware; exchange holidays not modelled). navUsd = Blockscout exchange_rate at last catalogue refresh.",
  "updatedAt": 1789891849578
}

503

Section titled “503”

The lane behind this endpoint is not ready or not enabled here (NOT_READY, CHAIN_NOT_ENABLED, NOT_ENABLED, *_UNAVAILABLE). Retry later; do not treat it as an empty answer.

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}