Data API
Robinhood Chain's indexed data over HTTP, and real calls to start from.
https://api.blockhash.xyz| Chain | Robinhood Chain, id 4663 |
| Format | JSON over HTTPS. GET /v1/stream is server-sent events. |
| Prices | US dollars |
| Amounts | Raw token amounts are decimal strings in the token's smallest unit. |
| Key | Optional. A key, sent as Authorization: Bearer <key> from your server, raises the rate limits: Get a key. |
| Reference | API reference, and the OpenAPI document to generate a client from |
A token is named by its address. Symbols are not unique: many tokens call themselves USDG or WETH.
| Token | Address |
|---|---|
| WETH | 0x0bd7d308f8e1639fab988df18a8011f41eacad73 |
| USDG | 0x5fc5360d0400a0fd4f2af552add042d716f1d168 |
Prices
curl -s https://api.blockhash.xyz/v1/pricesThe answer, trimmed to WETH:
{
"prices": {
"0x0bd7d308f8e1639fab988df18a8011f41eacad73": {
"price": 1813.0395970781888,
"priceConfidence": "high",
"priceDepthUsd": 1164221.560294183,
"change24h": -0.632573081451937,
"symbol": "WETH",
"name": "WETH",
"decimals": 18,
"isStock": false,
"depthUsd": 4288458.832967621,
"volume24h": 277269997.2715788,
"marketCapUsd": 67112577.85850501
}
},
"count": 5000,
"source": "indexer",
"ageSec": 54,
"market": {
"open": true,
"phase": "open",
"nextOpen": 1794925800,
"sessionOpen": 1794839400,
"nextClose": 1794862800,
"note": null
}
}One call carries the 5,000 tokens with the most volume in the last day, keyed by address.
change24h is a percentage.
market is the US stock market's session, for the tokenized stocks (isStock).
Search tokens
curl -s 'https://api.blockhash.xyz/v1/tokens?q=0x0bd7d308f8e1639fab988df18a8011f41eacad73'{
"count": 1,
"source": "indexer",
"tokens": [
{
"address": "0x0bd7d308f8e1639fab988df18a8011f41eacad73",
"symbol": "WETH",
"name": "WETH",
"decimals": 18,
"isStock": false,
"tier": 2,
"impersonator": false,
"launchpad": null,
"firstBlock": 9486,
"firstSeen": 1779484493,
"price": 1813.0395970781888,
"priceConfidence": "high",
"priceDepthUsd": 1164221.560294183,
"change24h": -0.632573081451937,
"volume24h": 277269997.2715788,
"volumeBacked": true,
"trades24h": 472882,
"pools24h": 63,
"pools": 1000040,
"depthUsd": 4288458.832967621,
"liquidityUsd": 94156951.56055503,
"marketCapUsd": 67112577.85850501,
"imageUrl": null
}
]
}q takes a symbol, a name or an address.
A search by symbol answers up to 50 matches, verified tokens first and impersonators last, so choose by address.
tier is 2 for a verified token, 1 for an issued stock and 0 for the rest.
Candles
curl -s 'https://api.blockhash.xyz/v1/tokens/0x0bd7d308f8e1639fab988df18a8011f41eacad73/candles?tf=3600&limit=3'{
"token": "0x0bd7d308f8e1639fab988df18a8011f41eacad73",
"tf": 3600,
"source": "indexer-token",
"candles": [
{ "t": 1794848400, "o": 1827.0493891341898, "h": 1835.7864605781178, "l": 1818.1343075154018, "c": 1819.382161050005, "v": 10276365.067801004 },
{ "t": 1794852000, "o": 1819.382161050005, "h": 1826.1744999603814, "l": 1808.65195679809, "c": 1819.502588843156, "v": 11359515.560787996 },
{ "t": 1794855600, "o": 1819.502588843156, "h": 1819.502588843156, "l": 1810.5974218792685, "c": 1810.6100694259483, "v": 6680476.765164 }
],
"hasMore": true,
"nextBefore": 1794848400
}tf is the bucket in seconds: 60, 300, 900, 3600, 14400 or 86400.
t is the bucket's start in Unix seconds, o, h, l and c are prices in US dollars, and v is the volume in US dollars.
Pass nextBefore as before for older buckets.
Your limits
curl -s https://api.blockhash.xyz/v1/limitsThe answer, trimmed to its first bucket:
{
"caller": { "kind": "anonymous", "proven": true },
"buckets": [
{
"name": "ip",
"scope": "ip",
"rate": 20,
"burst": 60,
"remaining": 59,
"resetSeconds": 1,
"applies": "every request from this address that names no session or key"
}
]
}With a key, send it in the header:
curl -s https://api.blockhash.xyz/v1/limits -H "Authorization: Bearer $BLOCKHASH_API_KEY"caller.kind is then key, and the key bucket holds your key's limits.
What else it serves
| Data | Routes |
|---|---|
| A token's detail, stats and windows | /v1/tokens/{address}, /summary, /stats, /windows |
| Browsing and resolving tokens | /v1/tokens/discover, POST /v1/tokens/resolve |
| A token's swaps, holders and traders | /swaps, /holders, /holders/pnl, /traders, /traders/{wallet} |
| Pools | Candles, depth, the venue of each pool factory |
| A wallet | Balances, positions, swaps, profit and loss, value over time |
| The whole chain | Latest swaps, the last minute, the token map |
| A transaction | Its token flow |
| Live | The market event stream |
| The rest | US market hours, display-currency rates, the caller's region, token images |