# CoinGecko Onchain Token Price & Market Data (Base Network)

> CoinGecko Onchain Token Price & Market Data (Base Network) is a paid API for AI agents from pro-api.coingecko.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns real-time DEX price and market data for multiple token contract addresses on the Base network using CoinGecko's onchain data.

## Facts

- Endpoint: GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b,0x22af33fe49fd1fa80c7149773dde5890d3c76f3b,0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-onchain-token-price-market-data-base-network-50f686b2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1hCqW14F-ITDS-fWqrjA9

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 coingecko-onchain-token-price-market-data-base-network-50f686b2
```

Example prompt: What are the current prices, 24-hour volume, and market caps of these three Base network tokens: 0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b, 0x22af33fe49fd1fa80c7149773dde5890d3c76f3b, and 0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf?

## When to prefer this

Use this endpoint when you need real-time onchain DEX price data for specific token contract addresses on the Base network, especially when you have multiple tokens to price simultaneously. Prefer this over CoinGecko's standard coin price endpoints when you have contract addresses rather than coin IDs, and when you need onchain/DEX-specific data rather than aggregated CEX prices.

## Known failure modes

- Invalid or unrecognized contract address returns empty or null data for that token
- Network not supported returns 404 or error response
- Too many contract addresses in one request may result in partial data or timeout
- Inactive tokens may return no data unless include_inactive_source flag is set
- Rate limit exceeded returns 429 error

## How this service works

Query onchain DEX token price & market data based on the provided token contract addresses on a network.

## Output

Returns a JSON object mapping each token contract address to its current USD price, and optionally 24hr trading volume, market cap, 24hr price change percentage, and total reserve in USD — all sourced from onchain DEX data on the Base network.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "include_24hr_vol": true,
   "include_market_cap": true,
   "include_24hr_price_change": true
  }
 },
 "output": {
  "type": "object",
  "example": {
   "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b": {
    "usd": 1.25,
    "usd_24h_vol": 5000000,
    "usd_24h_change": 2.5,
    "usd_market_cap": 250000000
   },
   "0x22af33fe49fd1fa80c7149773dde5890d3c76f3b": {
    "usd": 0.85,
    "usd_24h_vol": 3000000,
    "usd_24h_change": -1.2,
    "usd_market_cap": 170000000
   },
   "0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf": {
    "usd": 2.1,
    "usd_24h_vol": 8000000,
    "usd_24h_change": 5.3,
    "usd_market_cap": 420000000
   }
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "include_24hr_vol": {
       "type": "boolean"
      },
      "mcap_fdv_fallback": {
       "type": "boolean"
      },
      "include_market_cap": {
       "type": "boolean"
      },
      "include_inactive_source": {
       "type": "boolean"
      },
      "include_24hr_price_change": {
       "type": "boolean"
      },
      "include_total_reserve_in_usd": {
       "type": "boolean"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coingecko-onchain-token-price-market-data-base-network-50f686b2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pro-api.coingecko.com](https://www.zero.xyz/host/pro-api.coingecko.com/llms.txt)