# CoinGecko On-Chain USDC Price (Ethereum)

> CoinGecko On-Chain USDC Price (Ethereum) 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).

Fetches the real-time on-chain price for the USDC ERC-20 token (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) on the Ethereum network.

## Facts

- Endpoint: GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/eth/token_price/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
- 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-503901bb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fCBGffIOb8MpUlRxQMEiv

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-503901bb
```

Example prompt: What's the current on-chain price of USDC on Ethereum right now, including its 24-hour volume and price change?

## When to prefer this

Choose this endpoint when you need real-time, on-chain sourced price data specifically for USDC on Ethereum, particularly when you want DEX-derived pricing rather than centralized exchange data. Ideal for DeFi applications, peg-monitoring bots, and agents that need Ethereum-native token prices with optional volume and market cap context.

## Known failure modes

- Invalid or unsupported contract address returns 404 or empty response
- Missing or invalid API key returns 401 Unauthorized
- Rate limit exceeded returns 429 Too Many Requests
- Network connectivity issues or CoinGecko downtime returns 500 or timeout
- Payment not processed (x402) results in 402 Payment Required

## How this service works

Fetches the real-time on-chain price for the ERC-20 token USDC (0xA0b8...6eB48) on the Ethereum network.

## Output

Returns a JSON object containing the real-time on-chain price of USDC in fiat currency, along with optional fields such as 24hr trading volume, market cap, 24hr price change percentage, and total reserve in USD, all sourced from on-chain DEX data on the Ethereum network.

## 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": {
   "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48": {
    "eth": 0.00055,
    "eth_24h_vol": 125000.5,
    "eth_24h_change": 1.25,
    "eth_market_cap": 2250000000
   }
  }
 }
}
```

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

## More

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