# CoinGecko Onchain DEX Token Price (Base Network)

> CoinGecko Onchain DEX Token Price (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-14).

Returns real-time DEX token price and market data for tokens on the Base network by contract address.

## Facts

- Endpoint: GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/probe
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-onchain-dex-token-price-base-network-824fc7be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_73YBP1Y_QuhpvW41Hncdu

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-dex-token-price-base-network-824fc7be
```

Example prompt: What's the current price, 24-hour volume, and market cap for the token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on the Base network?

## When to prefer this

Choose this endpoint when you need real-time DEX-sourced token prices specifically on the Base network and you have the token contract address. Prefer this over CoinGecko's centralized price endpoints when dealing with newer or smaller tokens that may not have a CoinGecko coin ID but trade on-chain. It is especially useful for DeFi agents monitoring Base-native tokens, newly launched assets, or any token where onchain liquidity data (reserve, volume) matters.

## Known failure modes

- Unknown or unlisted contract address returns empty or null price data
- Network mismatch if the contract exists on another chain but not Base
- Rate limiting or payment failure returns 402 or 429 error
- Inactive token with no recent DEX activity may return stale or missing data
- Malformed contract address returns 400 bad request

## 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 keyed by token contract address containing real-time onchain data sourced from DEX pools, including token price in USD, optionally 24hr trading volume, market capitalization, 24hr price change percentage, total reserve in USD, and FDV/market cap fallback values.

## 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-dex-token-price-base-network-824fc7be/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)