x402basequality 0.88

Real-time token price and market cap data across 60+ chains via x402 micropayment

Price
per_call
Protocol
x402
Verified
no

What it does

Zapper's token-price endpoint returns real-time pricing, market cap, 24h volume, liquidity, and short-term price changes (5m, 1h, 24h) for any ERC-20 or gas token identified by its contract address and chain ID. It is one tool in the broader Zapper API suite, which covers portfolios, NFTs, DeFi balances, transaction history, and social identity across 60+ EVM chains.

The endpoint accepts a POST request with a JSON body containing the token's 0x contract address, a numeric chain ID (e.g., 8453 for Base, 1 for Ethereum mainnet), and an optional currency parameter (defaults to USD). The response includes the token's name, symbol, decimals, image URL, and a priceData object with fields for price, marketCap, priceChange5m, priceChange1h, priceChange24h, volume24h, totalLiquidity, and totalGasTokenLiquidity.

Payment is handled via the x402 protocol on Base using USDC. Each call costs 1,125 base units of USDC (6 decimals), which equals $0.001125 per request. The endpoint returned a valid 402 challenge during probing, confirming it is live. The full OpenAPI 3.1 schema is published with request/response definitions and example payloads for all 16+ tools in the Zapper x402 suite.

Capabilities

token-pricemarket-capprice-change-trackingmulti-chainerc20-metadatareal-time-datax402-paymentusdc-settlementbase-network

Use cases

  • Look up the current USD price and market cap of any ERC-20 token by contract address and chain
  • Monitor short-term price movements (5-minute, 1-hour, 24-hour changes) for trading bots or alerts
  • Enrich wallet or portfolio UIs with live token pricing and liquidity data
  • Power agent workflows that need to resolve a token address to its current market value
  • Compare liquidity depth across tokens before executing swaps

Fit

Best for

  • AI agents needing per-call crypto price data without API key management
  • Developers building multi-chain portfolio dashboards
  • Automated trading or alerting systems that query token prices programmatically

Not for

  • Historical OHLCV candlestick charting (use the separate historical-token-price endpoint)
  • Non-EVM chains or tokens without a 0x contract address
  • High-frequency tick-level market data feeds (this is a request-response API, not a WebSocket stream)

Quick start

curl -X POST https://public.zapper.xyz/x402/token-price \
  -H "Content-Type: application/json" \
  -H "X-Payment: <x402-payment-token>" \
  -d '{"address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","chainId":8453}'

Example

Request

{
  "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "chainId": 8453,
  "currency": "USD"
}

Response

{
  "data": {
    "fungibleTokenV2": {
      "name": "USD Coin",
      "symbol": "USDC",
      "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "decimals": 6,
      "priceData": {
        "price": 1.0001,
        "marketCap": 44000000000,
        "volume24h": 5200000000,
        "priceChange1h": -0.0002,
        "priceChange5m": 0.0001,
        "priceChange24h": 0.0003,
        "totalLiquidity": 350000000,
        "totalGasTokenLiquidity": 120000
      },
      "imageUrlV2": "https://storage.zapper.xyz/..."
    }
  }
}

Endpoint

Transporthttp
Protocolx402
Pay to0x43a2a720cd0911690c248075f4a29a5e7716f758
CurrencyUSD COIN

Quality

0.88/ 1.00

Full OpenAPI 3.1 schema with request/response structure, live 402 challenge confirmed, clear pricing ($0.001125/call in Base USDC), and example payloads provided. Docked slightly because no actual 200 response sample was captured (response structure is inferred from the output schema example) and crawled docs pages returned 404.

Warnings

  • The /docs and /pricing pages on public.zapper.xyz return 404; the legacy Swagger UI at /api carries a deprecation notice pointing to build.zapper.xyz
  • Example response JSON is inferred from the output schema, not captured from a live 200 response

Citations

Provenance

Indexed fromx402_bazaar
Enriched2026-04-22 01:07:48Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-21
Last seen2026-04-22

Agent access