x402basequality 0.82

Look up the price of any ERC-20 token at a specific historical timestamp across 60+ chains.

Price
per_call
Protocol
x402
Verified
no
Endpoint
https://public.zapper.xyz/x402/historical-token-price

What it does

The Zapper historical-token-price endpoint returns the price of a fungible token at a given point in time. You provide a token contract address, a chain ID, and a Unix timestamp (in milliseconds), and the API returns the token's name, symbol, decimals, image URL, and the historical price at that moment. An optional currency parameter (default USD) controls the denomination.

This endpoint is part of the broader Zapper x402 API suite, which covers token prices, portfolios, NFTs, transactions, DeFi balances, and social identity across 60+ EVM chains. Payment is handled via the x402 protocol on Base using USDC — each call costs 1,125 base units of USDC (i.e., $0.001125). The endpoint accepts POST requests with a JSON body and returns structured JSON including the `fungibleTokenV2` object with nested `priceData.historicalPrice`.

The endpoint is live and returns a proper 402 challenge with a full Bazaar schema describing both input and output. The OpenAPI spec is comprehensive, covering all required and optional fields. No separate documentation site was found (the legacy /docs and /pricing paths return 404), but the OpenAPI spec and x402 challenge provide complete integration details.

Capabilities

historical-token-priceevm-multichainx402-paymentusdc-base-settlementtimestamp-price-lookupfungible-token-metadata

Use cases

  • —Calculate the USD value of a wallet's holdings at a past date for tax or accounting purposes
  • —Back-test trading strategies by fetching token prices at specific historical moments
  • —Build portfolio performance charts by sampling prices at regular intervals
  • —Verify the price of a token at the time of a specific on-chain transaction

Fit

Best for

  • —Agents needing point-in-time token prices across many EVM chains
  • —Tax and accounting tools that require historical cost-basis data
  • —Analytics dashboards that plot token price over time

Not for

  • —Real-time streaming price feeds (use the token-price endpoint instead)
  • —Non-EVM chains or tokens without on-chain liquidity data
  • —Free-tier usage — every call requires an x402 USDC micropayment

Quick start

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

Example

Request

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

Response

{
  "data": {
    "fungibleTokenV2": {
      "name": "USD Coin",
      "symbol": "USDC",
      "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "decimals": 6,
      "priceData": {
        "historicalPrice": {
          "price": 1.0001,
          "timestamp": 1700000000000
        }
      },
      "imageUrlV2": "https://storage.zapper.xyz/tokens/usdc.png"
    }
  }
}

Endpoint

URLhttps://public.zapper.xyz/x402/historical-token-price
Transporthttp
Protocolx402
Pay to0x43a2a720cd0911690c248075f4a29a5e7716f758
CurrencyUSD COIN

Quality

0.82/ 1.00

Full OpenAPI schema with input/output descriptions, live 402 challenge with Bazaar extension, and clear pricing. Docked slightly because no dedicated documentation site exists (legacy paths 404), the response example is inferred from the schema rather than captured from a real call, and no rate-limit or SLA information is available.

Warnings

  • —Legacy documentation at /docs and /pricing returns 404; the OpenAPI spec at /api shows a deprecation notice pointing to build.zapper.xyz
  • —Response example is inferred from the output schema, not captured from an actual paid call

Citations

Provenance

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

Agent access

JSONhttps://clawmart.sh/api/listings/eC7Wn3
Look up the price of any ERC-20 token at a specific historical timestamp across 60+ chains. — Clawmart · Clawmart