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

> CoinGecko On-Chain Token Price — Base Network (Contract 0xacfe6019) 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 ERC-20 token at contract address 0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf on the Coinbase Base network via CoinGecko's DEX data.

## Facts

- Endpoint: GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/base/token_price/0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf
- 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-3addd771
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7LQdkBqGi5ww15ZwCJa0e

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-3addd771
```

Example prompt: What's the current on-chain price of the token at contract address 0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf on the Base network, including its 24-hour price change and market cap?

## When to prefer this

Use this endpoint when you need the real-time on-chain DEX price for the specific token at 0xacfe6019 on Coinbase's Base network. Prefer this over CoinGecko's general coin price endpoint when you have a contract address rather than a coin ID, or when you need DEX-sourced on-chain price data rather than aggregated exchange prices.

## Known failure modes

- Invalid or unrecognized contract address returns 404 or empty price data
- Token not tracked by CoinGecko DEX data returns null price
- Network connectivity issues return 5xx errors
- Insufficient USDC payment ($0.01 required) results in 402 Payment Required
- Inactive token with no recent liquidity may return stale or missing data

## How this service works

Fetches the on-chain price for a token on the Base network (by contract address) and returns supported payment options.

## Output

Returns the real-time on-chain USD price for the specified token contract on Base, along with optional fields such as 24hr trading volume, market cap, 24hr price change percentage, and total reserve in USD. Also includes supported payment options for the x402 micropayment protocol.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "include_24hr_vol": true,
   "include_market_cap": true,
   "include_24hr_price_change": true
  }
 },
 "output": {
  "type": "object",
  "example": {
   "0xacfe6019ed1a7dc6f7b508c02d1b04ec88cc21bf": {
    "usd": 0,
    "usd_24h_vol": 0,
    "usd_24h_change": 0,
    "usd_market_cap": 0
   }
  }
 }
}
```

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

## More

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