# CurveCall Token Market Snapshot

> CurveCall Token Market Snapshot is a paid API for AI agents from curvecall.onrender.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Returns a real-time market snapshot for a token on a given chain, including price, FDV, liquidity, 24h volume, buy/sell transactions, and top trading pair data sourced from DEX aggregators.

## Facts

- Endpoint: GET https://curvecall.onrender.com/v1/token/base/0x4200000000000000000000000000000000000006?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/curvecall-token-market-snapshot-31954c03
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jzFsntdPlSpa0t4B8_UFu

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 curvecall-token-market-snapshot-31954c03
```

Example prompt: What's the current market snapshot for the WETH token at 0x4200000000000000000000000000000000000006 on Base — give me price, liquidity, FDV, and today's buy/sell counts.

## When to prefer this

Use this endpoint when you need a fast, single-call market snapshot for a specific token contract address on a supported chain, especially when you want DEX-level data like liquidity, pair age, and buy/sell pressure rather than just price. Prefer this over broader market APIs when your agent is already working with on-chain DeFi data and needs enrichment at the token level. It is particularly useful when combined with the sibling risk-screen or bonding-curve endpoints from the same CurveCall suite.

## Known failure modes

- Unknown or unlisted token contract address returns empty or error response
- Unsupported chain ID causes a 404 or validation error
- Token exists but has no active DEX pairs — may return null liquidity/volume fields
- Rate limiting or payment failure (x402) if USDC balance is insufficient
- Render.com cold-start latency may cause occasional slow or failed responses

## How this service works

Token market snapshot

## Output

A JSON object containing the token's chain, symbol, contract address, current USD price, fully diluted valuation in USD, total liquidity in USD, 24-hour volume in USD, 24-hour buy and sell transaction counts, number of trading pairs, the top DEX pair name, and the age of the primary pair in hours.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "pathParams": {
     "chain": {
      "type": "string",
      "required": true,
      "description": "Dexscreener chain id, e.g. base, solana, ethereum"
     },
     "address": {
      "type": "string",
      "required": true,
      "description": "Token contract address"
     }
    },
    "queryParams": {}
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "chain": "base",
     "symbol": "TEST",
     "address": "0x...",
     "fdv_usd": 10000000,
     "top_pair": {
      "dex": "uniswap"
     },
     "price_usd": 0.01,
     "pair_count": 2,
     "liquidity_usd": 120000,
     "txns_24h_buys": 120,
     "pair_age_hours": 30.5,
     "txns_24h_sells": 80,
     "volume_24h_usd": 5000
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/curvecall-token-market-snapshot-31954c03/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from curvecall.onrender.com](https://www.zero.xyz/host/curvecall.onrender.com/llms.txt)