Free API — No API Key Required

HooderScan Public Market Data API

Access real-time token market data on Robinhood Chain (4663). Read cached price, volume, and liquidity data for any indexed token. No authentication required.

Public Access

No API key, no authentication. Just make a GET request and receive JSON data.

Cached Data

Reads from HooderScan's verified cache. Fast responses, no upstream API delays.

Rate Limited

20 requests per minute per IP. Generous for bots, dashboards, and integrations.

Endpoint

GET/api/v1/token/{contract_address}

Parametercontract_address — The 0x-prefixed ERC-20 contract address (40 hex characters)

ChainRobinhood Chain (ID: 4663)

AuthNone required

Response Fields

Field	Type	Description
chainId	number	Always 4663 (Robinhood Chain)
contractAddress	string	Token contract address
name	string	Token name
symbol	string	Token ticker symbol
priceUsd	number	Current price in USD
volume24hUsd	number	24-hour trading volume in USD
liquidityUsd	number	Total pool liquidity in USD
priceChange24h	number	24-hour price change percentage
updatedAt	string	ISO 8601 timestamp of last cache update
isStale	boolean	True if cache is older than 120 seconds
sources	string[]	Data sources used (e.g. DexScreener, GeckoTerminal)

Example Response

JSON

{
  "success": true,
  "data": {
    "chainId": 4663,
    "contractAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "name": "Example Token",
    "symbol": "TOKEN",
    "priceUsd": 0.0042,
    "volume24hUsd": 184320,
    "liquidityUsd": 93210,
    "priceChange24h": 12.4,
    "updatedAt": "2026-07-22T17:00:00Z",
    "isStale": false,
    "sources": ["DexScreener", "GeckoTerminal"]
  }
}

HTTP Status Codes

200SuccessToken data returned successfully

400Bad RequestInvalid contract address format

404Not FoundToken is not indexed by HooderScan

429Too Many RequestsRate limit exceeded (20/min)

503Service UnavailableNo verified data has ever been cached for this token

Code Examples

cURL

bash

curl -s "https://hooderscan.com/api/v1/token/0x1234567890abcdef1234567890abcdef12345678" | jq

JavaScript (fetch)

javascript

const address = "0x1234567890abcdef1234567890abcdef12345678";

const res = await fetch(`https://hooderscan.com/api/v1/token/${address}`);
const json = await res.json();

if (json.success) {
  console.log(`${json.data.symbol}: $${json.data.priceUsd}`);
  console.log(`24h Volume: $${json.data.volume24hUsd}`);
  console.log(`Liquidity: $${json.data.liquidityUsd}`);
} else {
  console.error(json.error);
}

Python (requests)

python

import requests

address = "0x1234567890abcdef1234567890abcdef12345678"
url = f"https://hooderscan.com/api/v1/token/{address}"

response = requests.get(url)
data = response.json()

if data["success"]:
    token = data["data"]
    print(f"{token['symbol']}: ${token['priceUsd']}")
    print(f"24h Volume: ${token['volume24hUsd']}")
    print(f"Liquidity: ${token['liquidityUsd']}")
    print(f"Stale: {token['isStale']}")
else:
    print(f"Error: {data['error']}")

Rate Limiting

Requests per minute20

ScopePer IP address

Cache TTL60-120 seconds (public cache headers)

Tokens per request1

Rate limit headers are included in every response.

Source Attribution

Market data is aggregated from the following sources and cached by HooderScan.

DexScreener

GeckoTerminal

Need more advanced data or higher rate limits? Premium API access is coming soon.

Back to Scanner Full Manual