# CoinGecko Pro: On-Chain Token Price on Base Network

> CoinGecko Pro: On-Chain Token Price on 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 the current on-chain price for a specific token contract address on the Coinbase Base network via CoinGecko Pro.

## Facts

- Endpoint: GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b
- 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/pro-api-coingecko-com-365edd3b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nPAretIDD-YBU4DuQhVJ7

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-365edd3b
```

Example prompt: What's the current on-chain price of the token at contract address 0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b on the Base network, and can you also include its 24-hour volume and price change?

## When to prefer this

Use this endpoint when you need real-time on-chain price data specifically for a token deployed on the Coinbase Base network, identified by contract address. Prefer over CoinGecko's general simple/price endpoint when dealing with newer or DEX-traded tokens not listed by coin ID, or when on-chain accuracy is required rather than aggregated CEX pricing.

## Known failure modes

- Invalid or unknown contract address returns empty or error response
- Token not indexed on CoinGecko for Base network returns 404 or empty data
- Network connectivity or API key issues return 401/403/500 errors
- Stale or illiquid token may have missing market data fields even if price is returned

## How this service works

Fetch the current on-chain price for a token on the Base network by contract address via CoinGecko Pro.

## Output

Returns current on-chain price in fiat (e.g. USD) for the specified Base token contract, optionally including 24hr trading volume, market cap, 24hr price change percentage, total reserve in USD, and support for inactive source tokens.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "include_24hr_vol": true,
   "include_market_cap": false,
   "include_24hr_price_change": true
  }
 },
 "output": {
  "type": "object",
  "example": {
   "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b": {
    "usd": 1.25,
    "usd_24h_vol": 5000000,
    "usd_24h_change": 2.5
   }
  }
 }
}
```

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

## More

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