# CoinGecko On-Chain Token Price — Base Network (0x00dde4d2)

> CoinGecko On-Chain Token Price — Base Network (0x00dde4d2) 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-15).

Returns the current on-chain USD price for a specific token contract address (0x00dde4d2f08497bcec6f5e0666f63e14b3a1dab9) on the Coinbase Base network.

## Facts

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

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-df5a3912
```

Example prompt: What's the current on-chain USD price for the token at contract address 0x00dde4d2f08497bcec6f5e0666f63e14b3a1dab9 on the Base network? Also include its 24-hour price change and market cap if available.

## When to prefer this

Use this endpoint when you need the live on-chain USD price for the specific Base network token at 0x00dde4d2f08497bcec6f5e0666f63e14b3a1dab9, sourced directly from DEX liquidity data via CoinGecko's on-chain API. Prefer this over CoinGecko's standard simple/price endpoint when you need DEX-sourced pricing rather than aggregated CEX/CoinGecko index prices, or when working specifically with tokens on the Base L2 network that may not have a CoinGecko coin ID.

## Known failure modes

- Invalid or unrecognized contract address returns empty or null price data
- Network identifier mismatch causes no results
- Missing or invalid API key returns 401 Unauthorized
- Rate limit exceeded returns 429 Too Many Requests
- Token not indexed by CoinGecko on-chain returns empty response
- Payment not completed (x402) results in 402 Payment Required

## How this service works

Fetches the on-chain USD price for a specified token contract address on the Base network.

## Output

Returns the current on-chain USD price for the specified token contract on Base, along with optional metrics such as 24hr trading volume, market cap, 24hr price change percentage, total reserve in USD, and FDV (fully diluted valuation) depending on which query flags are enabled.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 },
 "output": {
  "type": "object",
  "example": {
   "0x00dde4d2f08497bcec6f5e0666f63e14b3a1dab9": {
    "usd": 1.25
   }
  }
 }
}
```

## 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"
     ],
     "properties": {
      "token_prices": {
       "type": "object",
       "required": [
        "0x00dde4d2f08497bcec6f5e0666f63e14b3a1dab9"
       ],
       "properties": {
        "0x00dde4d2f08497bcec6f5e0666f63e14b3a1dab9": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## More

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