# CoinGecko Onchain DEX Token Price (Ethereum Network)

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

Fetches real-time DEX token price and market data for Ethereum-network tokens by contract address via CoinGecko's onchain API.

## Facts

- Endpoint: GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/eth/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-ethereum-network-36f3c3cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OzlANaTzbURdEngG0PCZU

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-ethereum-network-36f3c3cd
```

Example prompt: What's the current DEX price, 24-hour volume, and market cap for the Ethereum token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48? Pull the data from CoinGecko's onchain API.

## When to prefer this

Use this endpoint when you need onchain DEX pricing for Ethereum tokens identified only by contract address, especially for tokens not listed on centralized exchanges. It is ideal when you want raw DEX market data including reserves and volume rather than aggregated CeFi prices. Prefer this over CoinGecko's standard /simple/price endpoint when you have a contract address but not a CoinGecko coin ID, or when you specifically need onchain liquidity metrics.

## Known failure modes

- Unknown or unsupported contract address returns empty or null data
- Token with no active DEX liquidity may return no price data unless include_inactive_source is enabled
- Invalid contract address format causes a 400 bad request error
- Rate limit exceeded returns 429 too many requests
- Authentication failure (missing or invalid API key) returns 401 unauthorized
- Network not supported at this endpoint path returns 404

## 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 containing the token's current DEX price in USD, and optionally: 24-hour trading volume, market capitalization, 24-hour price change percentage, total reserve in USD, and whether inactive liquidity sources were included — all sourced from onchain DEX pool data on the Ethereum network.

## 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-ethereum-network-36f3c3cd/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)