# x402 Token Quotes API

> x402 Token Quotes API is a paid API for AI agents from call402.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Returns DEX trading pair data and current USD price for a given EVM or Solana token contract address, paid per-call via USDC over the x402 protocol.

## Facts

- Endpoint: POST https://call402.com/api/token-quotes?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-token-quotes-api-585d9e00
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OAyaev41rf8P6MZidY03s

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 x402-token-quotes-api-585d9e00 -d '<json body>'
```

Example prompt: What's the current USD price and DEX trading data for the token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?

## When to prefer this

Choose this endpoint when you need real-time DEX market data (price, liquidity, volume, pairs) for a specific EVM or Solana token contract address, and you are operating in an x402-compatible agent environment that can handle micropayments in USDC on Base mainnet. Prefer this over manual DexScreener scraping or other price feeds when you need structured, API-ready data with no API key management overhead — just pay $0.005 USDC per call.

## Known failure modes

- Invalid or malformed contract address returns an error or found:false
- Token not listed on DexScreener returns empty pairs array
- Solana address format may not be supported depending on DexScreener coverage
- Payment failure via x402 results in HTTP 402 with payment requirements and no data returned
- Network or upstream DexScreener outage may cause timeouts or incomplete data

## How this service works

USDC pay-per-call APIs for AI agents via the x402 protocol (v2, exact, Base mainnet). Send a request, receive HTTP 402 with payment requirements, pay with @x402/fetch or any x402 client, retry with the PAYMENT-SIGNATURE header.

## Output

Returns a JSON object with a list of DEX trading pairs for the queried token, including: the token's current USD price, DEX name, chain, pair address, quote symbol, liquidity in USD, 1h and 24h volume in USD, 24h transaction count, FDV, market cap, pair creation date, and a DexScreener URL. Also includes metadata about the data source and total number of pairs found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "description": "Token contract address (EVM 0x... or Solana)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "note": "Pairs where the token is the base asset rank first; price_usd is always the queried token's price.",
   "source": "dexscreener",
   "pairs_total": 1
  },
  "found": true,
  "pairs": [
   {
    "dex": "aerodrome",
    "url": "https://dexscreener.com/base/0x...",
    "chain": "base",
    "fdv_usd": null,
    "txns_24h": 1200,
    "price_usd": 1,
    "base_token": {
     "name": "USD Coin",
     "symbol": "USDC",
     "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
    },
    "token_role": "base",
    "pair_address": "0x...",
    "quote_symbol": "WETH",
    "liquidity_usd": 5000000,
    "volume_1h_usd": 40000,
    "market_cap_usd": null,
    "volume_24h_usd": 900000,
    "pair_created_at": "2024-01-01T00:00:00.000Z"
   }
  ],
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-token-quotes-api-585d9e00/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from call402.com](https://www.zero.xyz/host/call402.com/llms.txt)