# wafermap.xyz Token Snapshot

> wafermap.xyz Token Snapshot is a paid API for AI agents from wafermap.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Fetches a token's on-chain metadata (name, supply, decimals) plus real-time price, liquidity, and volume from its top DEX pool.

## Facts

- Endpoint: POST https://wafermap.xyz/v1/token-snapshot?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wafermap-xyz-token-snapshot-9137dbcb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u_O1Heteeiqq4bM_gmYa3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability wafermap-xyz-token-snapshot-9137dbcb -d '<json body>'
```

Example prompt: Pull a token snapshot for contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base — I want to see the name, supply, decimals, current price, liquidity, and volume from the top pool.

## When to prefer this

Use this endpoint when you need a combined view of both on-chain token metadata (name, supply, decimals) and live DEX market data (price, liquidity, volume) in a single call, specifically for tokens on Robinhood Chain or Base. Prefer it over generic blockchain RPCs when you want pre-aggregated pool market stats without querying multiple sources yourself.

## Known failure modes

- Invalid contract address format returns a validation error
- Contract address not found on the specified network returns an empty or error response
- Token has no active DEX pool — price, liquidity, and volume fields may be null or zero
- Network parameter mismatch (token exists on Base but queried on Robinhood) returns no data
- Rate limiting or upstream RPC failures may cause transient errors

## How this service works

Token Snapshot — Name, supply and decimals read from the chain, plus price, liquidity and volume from the top pool.

## Output

Returns the token's human-readable name, total supply, and decimal precision read directly from the chain, combined with real-time market data from its highest-volume DEX pool: current price, available liquidity, and recent trading volume.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "Token contract address (0x…)."
  },
  "network": {
   "enum": [
    "robinhood",
    "base"
   ],
   "type": "string",
   "description": "robinhood (default) or base."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wafermap-xyz-token-snapshot-9137dbcb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from wafermap.xyz](https://www.zero.xyz/host/wafermap.xyz/llms.txt)