# CoinGecko Pro: Onchain DEX Token Price & Market Data (Base Network, Specific Contract)

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

Returns real-time on-chain DEX price and market data for a specific token contract address (0x00881016b7324678f4012fbca0c0267b69ebd10e) on the Base network.

## Facts

- Endpoint: GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x00881016b7324678f4012fbca0c0267b69ebd10e
- Price: $0.010000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pro-api-coingecko-com-ef6be7b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ubTiIi19SxLwcfwFzz9kp

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 pro-api-coingecko-com-ef6be7b8
```

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

## When to prefer this

Use this endpoint when you need real-time on-chain DEX price data specifically for a known token contract address on the Coinbase Base network, and need optional enrichment like 24hr volume, market cap, or reserve data. Prefer this over CoinGecko's off-chain simple price endpoint when you need DEX-sourced prices rather than CEX aggregates, or when the token is only traded on-chain.

## Known failure modes

- Token contract address not found on Base network — returns empty or null data
- Network congestion causing stale DEX price data
- Invalid or malformed contract address returns 400 error
- Payment not completed (x402 payment required) — returns 402 Payment Required
- Rate limit exceeded — returns 429 Too Many Requests
- Token has no active liquidity pool on Base — returns no price data

## 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 current USD price of the token as traded on DEXes on the Base network, optionally including 24hr trading volume, market cap, 24hr price change percentage, and total reserve in USD — all sourced from CoinGecko's onchain data aggregation.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "include_24hr_vol": true,
   "mcap_fdv_fallback": true,
   "include_market_cap": true,
   "include_inactive_source": false,
   "include_24hr_price_change": true,
   "include_total_reserve_in_usd": true
  }
 },
 "output": {
  "type": "object",
  "example": {
   "data": {
    "id": "test-id",
    "type": "simple_token_price",
    "attributes": {
     "token_prices": {
      "0x00881016b7324678f4012fbca0c0267b69ebd10e": {
       "usd": 1.25,
       "usd_24h_vol": 500000,
       "usd_24h_change": 2.5,
       "usd_market_cap": 10000000,
       "total_reserve_in_usd": 750000
      }
     }
    }
   }
  }
 }
}
```

## 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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "id",
    "type",
    "attributes"
   ],
   "properties": {
    "id": {
     "type": "string"
    },
    "type": {
     "type": "string"
    },
    "attributes": {
     "type": "object",
     "required": [
      "token_prices",
      "h24_volume_usd",
      "market_cap_usd",
      "total_reserve_in_usd",
      "h24_price_change_percentage"
     ],
     "properties": {
      "token_prices": {
       "type": "object",
       "required": [
        "0x00881016b7324678f4012fbca0c0267b69ebd10e"
       ],
       "properties": {
        "0x00881016b7324678f4012fbca0c0267b69ebd10e": {
         "type": "null"
        }
       }
      },
      "h24_volume_usd": {
       "type": "object",
       "required": [
        "0x00881016b7324678f4012fbca0c0267b69ebd10e"
       ],
       "properties": {
        "0x00881016b7324678f4012fbca0c0267b69ebd10e": {
         "type": "string"
        }
       }
      },
      "market_cap_usd": {
       "type": "object",
       "required": [
        "0x00881016b7324678f4012fbca0c0267b69ebd10e"
       ],
       "properties": {
        "0x00881016b7324678f4012fbca0c0267b69ebd10e": {
         "type": "null"
        }
       }
      },
      "total_reserve_in_usd": {
       "type": "object",
       "required": [
        "0x00881016b7324678f4012fbca0c0267b69ebd10e"
       ],
       "properties": {
        "0x00881016b7324678f4012fbca0c0267b69ebd10e": {
         "type": "string"
        }
       }
      },
      "h24_price_change_percentage": {
       "type": "object",
       "required": [
        "0x00881016b7324678f4012fbca0c0267b69ebd10e"
       ],
       "properties": {
        "0x00881016b7324678f4012fbca0c0267b69ebd10e": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pro-api-coingecko-com-ef6be7b8/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)