Real-time token price and market cap data across 60+ chains via x402 micropayment
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
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
Quality
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
- —The endpoint costs 1,125 base units of USDC (Base chain) per call, i.e. $0.001125https://public.zapper.xyz/x402/token-price
- —Zapper API covers onchain data across 60+ chains including token prices, NFTs, portfolios, and transactionshttps://public.zapper.xyz/x402/token-price
- —The legacy Zapper API at /api carries a deprecation notice directing users to build.zapper.xyzhttps://public.zapper.xyz/api
- —Payment asset is USDC at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base (eip155:8453)https://public.zapper.xyz/x402/token-price