Skip to Content
Blockhash Docs
Data API

Data API

Robinhood Chain's indexed data over HTTP, and real calls to start from.

https://api.blockhash.xyz
ChainRobinhood Chain, id 4663
FormatJSON over HTTPS. GET /v1/stream is server-sent events.
PricesUS dollars
AmountsRaw token amounts are decimal strings in the token's smallest unit.
KeyOptional. A key, sent as Authorization: Bearer <key> from your server, raises the rate limits: Get a key.
ReferenceAPI 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.

TokenAddress
WETH0x0bd7d308f8e1639fab988df18a8011f41eacad73
USDG0x5fc5360d0400a0fd4f2af552add042d716f1d168

Prices

curl -s https://api.blockhash.xyz/v1/prices

The 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/limits

The 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

On this page