CryptoGETlive
Token onchain market data
Fetch token supply, price, valuation, liquidity, volume, and optional top pools by contract address.
$0.01
per call
Success
100%
p50 latency
1.54s
p95 latency
1.59s
Calls (30d)
2
Provider contract
- Call path
- /routes/coingecko/crypto/token-market-data
- Method
- GET
- Selected provider
- coingeckodefault
- Provider price
- $0.01
- Settlement
- Base USDC · x402 · 5% h402 fee
Quickstart
Both commands call the selected provider directly.
cURL
curl '/routes/coingecko/crypto/token-market-data?network=base&address=0x833589fCD6eDb6E08f4C7C32D4f71b54bdA02913&include_composition=false&include_inactive_source=false'
CLI
h402 call 'crypto/token-market-data' --provider 'coingecko' --method GET --query '{"network":"base","address":"0x833589fCD6eDb6E08f4C7C32D4f71b54bdA02913","include_composition":false,"include_inactive_source":false}'Parameters & live test
pays real USDCFill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.
networkstringrequiredCoinGecko onchain network ID from the complete official GeckoTerminal network list captured on 2026-07-13. No default is applied because the token address is chain-specific.
addressstringrequired≥ 1 charsToken contract address in the selected network's native address format.
e.g.
includestringoptionalSet to top_pools to include the token's most liquid pools.
One of
include_compositionbooleanoptionaldefault falseInclude base/quote token balances and USD liquidity for each top pool. Requires include=top_pools; the adapter adds it when omitted.
include_inactive_sourcebooleanoptionaldefault falseAllow token data from an inactive pool using its most recent swap.
GET/routes/coingecko/crypto/token-market-data
Request query
{
"network": "base",
"address": "0x833589fCD6eDb6E08f4C7C32D4f71b54bdA02913",
"include_composition": false,
"include_inactive_source": false
}ResponseExample response
{ "data": { "data": { "id": "base_0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "type": "token", "attributes": { "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "name": "USD Coin", "symbol": "USDC", "decimals": 6, "image_url": "https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602", "banner_image_url": null, "coingecko_coin_id": "usd-coin", "total_supply": "4205233061341417.0", "normalized_total_supply": "4205233061.34142", "price_usd": "0.9977479217", "fdv_usd": "4195736891.30746", "total_reserve_in_usd": "226720685.239511055411789623233992791136", "volume_usd": { "h24": "491329710.610068" }, "market_cap_usd": "73007001463.8903" }, "relationships": { "top_pools": { "data": [ { "id": "base_0x6c561b446416e1a00e8e93e221854d6ea4171372", "type": "pool" }, { "id": "base_0x4e962bb3889bf030368f56810a9c96b83cb3e778", "type": "pool" }, { "id": "base_0xdb0e3639258327e486134e136f10b28842771044f34ef0325d455e9eaedd7814", "type": "pool" } ] } } }, "included": [ { "id": "base_0x6c561b446416e1a00e8e93e221854d6ea4171372", "type": "pool", "attributes": { "base_token_price_usd": "1935.48", "base_token_price_native_currency": "1.0", "quote_token_price_usd": "0.997747921663324", "quote_token_price_native_currency": "0.000515504123867632", "base_token_price_quote_token": "1939.848691214", "quote_token_price_base_token": "0.0005155041239", "address": "0x6c561b446416e1a00e8e93e221854d6ea4171372", "name": "WETH / USDC 0.3%", "pool_created_at": "2023-11-18T05:59:09Z", "token_price_usd": "0.997747921663324", "fdv_usd": "4195736891.30746", "market_cap_usd": "73016700301.9682", "price_change_percentage": { "m5": "0.01", "m15": "-0.52", "m30": "-0.51", "h1": "-0.09", "h6": "-0.06", "h24": "-0.92" }, "transactions": { "m5": { "buys": 3, "sells": 97, "buyers": 3, "sellers": 59 }, "m15": { "buys": 6, "sells": 100, "buyers": 5, "sellers": 62 }, "m30": { "buys": 18, "sells": 128, "buyers": 13, "sellers": 80 }, "h1": { "buys": 576, "sells": 424, "buyers": 218, "sellers": 130 }, "h6": { "buys": 892, "sells": 1035, "buyers": 326, "sellers": 401 }, "h24": { "buys": 2739, "sells": 2379, "buyers": 736, "sellers": 726 } }, "volume_usd": { "m5": "2179290.02115588", "m15": "2180457.91824635", "m30": "2477619.5213398", "h1": "14195766.6741678", "h6": "27244082.6534617", "h24": "47683733.1730902" }, "reserve_in_usd": "111554566.5033" }, "relationships": { "base_token": { "data": { "id": "base_0x4200000000000000000000000000000000000006", "type": "token" } }, "quote_token": { "data": { "id": "base_0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "type": "token" } }, "dex": { "data": { "id": "uniswap-v3-base", "type": "dex" } } } }, { "id": "base_0x4e962bb3889bf030368f56810a9c96b83cb3e778", "type": "pool", "attributes": { "base_token_price_usd": "65697.187552973", "base_token_price_native_currency": "33.9394062948014", "quote_token_price_usd": "0.997871642653053", "quote_token_price_native_currency": "0.000515504123867632", "base_token_price_quote_token": "65837.3128815477", "quote_token_price_base_token": "0.00001518895526", "address": "0x4e962bb3889bf030368f56810a9c96b83cb3e778", "name": "cbBTC / USDC 0.05%", "pool_created_at": "2024-09-12T13:56:07Z", "token_price_usd": "0.997871642653053", "fdv_usd": "4196257163.72253", "market_cap_usd": "73025754390.9138", "price_change_percentage": { "m5": "-0.59", "m15": "0.08", "m30": "0.09", "h1": "-0.68", "h6": "-0.61", "h24": "-0.3" }, "transactions": { "m5": { "buys": 104, "sells": 116, "buyers": 53, "sellers": 70 }, "m15": { "buys": 270, "sells": 305, "buyers": 123, "sellers": 126 }, "m30": { "buys": 570, "sells": 592, "buyers": 196, "sellers": 202 }, "h1": { "buys": 1264, "sells": 1227, "buyers": 329, "sellers": 345 }, "h6": { "buys": 4438, "sells": 4565, "buyers": 746, "sellers": 729 }, "h24": { "buys": 16309, "sells": 16882, "buyers": 1317, "sellers": 1378 } }, "volume_usd": { "m5": "512519.391405572", "m15": "1199374.46180605", "m30": "2502467.54460836", "h1": "6258861.79826814", "h6": "19443455.16246", "h24": "62669755.5504514" }, "reserve_in_usd": "8791504.8686" }, "relationships": { "base_token": { "data": { "id": "base_0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf", "type": "token" } }, "quote_token": { "data": { "id": "base_0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "type": "token" } }, "dex": { "data": { "id": "aerodrome-slipstream", "type": "dex" } } } }, { "id": "base_0xdb0e3639258327e486134e136f10b28842771044f34ef0325d455e9eaedd7814", "type": "pool", "attributes": { "base_token_price_usd": "0.000100887326957602", "base_token_price_native_currency": "0.000000052129123592573", "quote_token_price_usd": "0.997871642653053", "quote_token_price_native_currency": "0.000515504123867632", "base_token_price_quote_token": "0.0001011226122", "quote_token_price_base_token": "9888.9850498288", "address": "0xdb0e3639258327e486134e136f10b28842771044f34ef0325d455e9eaedd7814", "name": "Claude / USDC 0.01%", "pool_created_at": "2026-07-22T06:20:01Z", "token_price_usd": "0.997871642653053", "fdv_usd": "4196257163.72253", "market_cap_usd": "73025754390.9138", "price_change_percentage": { "m5": "-0.59", "m15": "0.08", "m30": "0.09", "h1": "-0.68", "h6": "-0.61", "h24": "-0.33" }, "transactions": { "m5": { "buys": 42, "sells": 44, "buyers": 4, "sellers": 5 }, "m15": { "buys": 121, "sells": 128, "buyers": 5, "sellers": 11 }, "m30": { "buys": 236, "sells": 244, "buyers": 6, "sellers": 13 }, "h1": { "buys": 459, "sells": 470, "buyers": 7, "sellers": 17 }, "h6": { "buys": 3405, "sells": 3422, "buyers": 17, "sellers": 31 }, "h24": { "buys": 5081, "sells": 5135, "buyers": 21, "sellers": 36 } }, "volume_usd": { "m5": "502.2050503037", "m15": "2762.2098578701", "m30": "4300.1057000537", "h1": "6998.2204495175", "h6": "94080888.8341278", "h24": "151485473.699524" }, "reserve_in_usd": "3189589.7498" }, "relationships": { "base_token": { "data": { "id": "base_0x6e97d91456c55a6097ef49234942d2c1e2ab8b07", "type": "token" } }, "quote_token": { "data": { "id": "base_0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "type": "token" } }, "dex": { "data": { "id": "uniswap-v4-base", "type": "dex" } } } } ] }, "h402": { "routeId": "crypto/token-market-data", "provider": "coingecko", "selectedCandidateId": "crypto/token-market-data/coingecko", "routing": "manual", "paidBy": "x402-exact" } }
Providers
Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.
coingecko
x402
100
- Success
- 100%
- p50
- 1.54s
- Calls
- 2
100%
$0.01$0.010/call
Last successful call: 15d ago· Aggregated by h402 — not the source provider