Hunt Townh402
Catalog
CryptoPOSTlive

Token price by contract

Fetch a token's USD price and optional market fields by EVM contract address.

$0.01
per call
Success
100%
p50 latency
1.43s
p95 latency
1.43s
Calls (30d)
1

Provider contract

Call path
/routes/coingecko/crypto/token-price
Method
POST
Selected provider
coingeckodefault
Provider price
$0.01
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl -X POST '/routes/coingecko/crypto/token-price' \
  -H 'content-type: application/json' \
  -d '{"network":"base","addresses":"0x833589fCD6eDb6E08f4C7C32D4f71b54bdA02913","include_market_cap":false,"mcap_fdv_fallback":false,"include_24hr_vol":false,"include_24hr_price_change":false,"include_total_reserve_in_usd":false,"include_inactive_source":false}'
CLI
h402 call 'crypto/token-price' --provider 'coingecko' --method POST --json '{"network":"base","addresses":"0x833589fCD6eDb6E08f4C7C32D4f71b54bdA02913","include_market_cap":false,"mcap_fdv_fallback":false,"include_24hr_vol":false,"include_24hr_price_change":false,"include_total_reserve_in_usd":false,"include_inactive_source":false}'

Parameters & live test

pays real USDC

Fill 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.

networkstringrequired

CoinGecko onchain network id used in the request path.

e.g.
addressesstringrequired≥ 1 chars

Comma-separated token contract addresses accepted by CoinGecko.

e.g.
include_market_capbooleanoptionaldefault false
mcap_fdv_fallbackbooleanoptionaldefault false
include_24hr_volbooleanoptionaldefault false
include_24hr_price_changebooleanoptionaldefault false
include_total_reserve_in_usdbooleanoptionaldefault false
include_inactive_sourcebooleanoptionaldefault false
POST/routes/coingecko/crypto/token-price
Request body
{
  "network": "base",
  "addresses": "0x833589fCD6eDb6E08f4C7C32D4f71b54bdA02913",
  "include_market_cap": false,
  "mcap_fdv_fallback": false,
  "include_24hr_vol": false,
  "include_24hr_price_change": false,
  "include_total_reserve_in_usd": false,
  "include_inactive_source": false
}

ResponseExample response
{
  "data": {
    "data": {
      "id": "777e5dd6-6c2d-4ed1-ac83-3c6b0548caa4",
      "type": "simple_token_price",
      "attributes": {
        "token_prices": {
          "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913": "0.997747921663324"
        }
      }
    }
  },
  "h402": {
    "routeId": "crypto/token-price",
    "provider": "coingecko",
    "selectedCandidateId": "crypto/token-price/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.43s
Calls
1
100%
$0.01$0.010/call
Last successful call: 15d ago· Aggregated by h402 — not the source provider