# Agent Extraction API – Multi-Token Price Lookup

> Agent Extraction API – Multi-Token Price Lookup is a paid API for AI agents from freetier-agent-api.pages.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-11-01).

Returns USD prices, market cap, 24h volume, and 24h price change for up to 30 tokens on a single network in one call, sourced from GeckoTerminal DEX data.

## Facts

- Endpoint: GET https://freetier-agent-api.pages.dev/api/token-prices?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-extraction-api-multi-token-price-lookup-59b65fe4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CnhvPoqNzNklOqo6POoqm

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 agent-extraction-api-multi-token-price-lookup-59b65fe4
```

Example prompt: Can you get me the current USD prices, market cap, and 24h volume for these three tokens on Base: 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913, 0x4200000000000000000000000000000000000006, and 0x50c5725949a6f0c72e6c4a641f24049a917db0cb?

## When to prefer this

Choose this endpoint when you need to batch-fetch live DEX token prices for up to 30 tokens on a single chain in one call, especially when you also need market cap, 24h volume, and 24h change alongside price. It is ideal for DeFi portfolio tracking, arbitrage scanning, and market monitoring on Base, Ethereum, Solana, Arbitrum, BSC, Polygon, Optimism, or Avalanche. Prefer it over single-token lookups when handling multiple assets to minimize API calls and cost.

## Known failure modes

- Invalid or unrecognized token addresses return missing entries or lower found count
- Unsupported network name returns an error or empty result
- More than 30 addresses in a single call may be rejected or truncated
- GeckoTerminal data may be stale for very low-liquidity tokens or newly listed tokens
- Network parameter typo results in default fallback to Base or an error

## How this service works

Invoice-to-JSON, on-chain tools (transaction explainer + payment check, wallet profile, contract ABI, ERC-20 token risk), company contacts and web-to-RAG for AI agents. Pay per call with x402 (USDC on Base). No signup, no API key.

## Output

A JSON object with a count of requested tokens, how many were found, the network name, and an array of token objects each containing the contract address, USD price, 24h volume in USD, market cap, and 24h percentage price change.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "addresses"
     ],
     "properties": {
      "network": {
       "enum": [
        "base",
        "ethereum",
        "solana",
        "arbitrum",
        "bsc",
        "polygon",
        "optimism",
        "avalanche"
       ],
       "type": "string",
       "description": "default base"
      },
      "addresses": {
       "type": "string",
       "description": "comma-separated token addresses, max 30"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "found": 2,
  "tokens": [
   {
    "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "priceUsd": 1,
    "volume24hUsd": 95000000
   }
  ],
  "network": "base"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-extraction-api-multi-token-price-lookup-59b65fe4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from freetier-agent-api.pages.dev](https://www.zero.xyz/host/freetier-agent-api.pages.dev/llms.txt)