# CoinGecko Simple Token Price via Locus x402

> CoinGecko Simple Token Price via Locus x402 is a paid API for AI agents from coingecko.x402.paywithlocus.com, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-15).

Fetches current prices and optional market stats (volume, market cap, 24hr change) for ERC-20 or other chain tokens by contract address using CoinGecko data.

## Facts

- Endpoint: POST https://coingecko.x402.paywithlocus.com/coingecko/simple-token-price
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-simple-token-price-via-locus-x402-0a30fcb4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_laONKK1drEHQt3d-GMkeJ

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 coingecko-simple-token-price-via-locus-x402-0a30fcb4 -d '<json body>'
```

Example prompt: What's the current price of the MATIC token on Polygon (contract address 0x7D1AfA7B718fb893dB30A3aBc0Cfc608AaCfeBB0) in USD, and can you include its 24-hour volume and market cap?

## When to prefer this

Choose this endpoint when you need token price data by contract address on a specific blockchain platform (e.g. Ethereum, Polygon) and want optional market stats like volume, market cap, or 24hr change. Prefer it over CoinGecko coin-ID endpoints when you only have the contract address and not the CoinGecko coin slug. It uses the x402 micropayment protocol, so it's well-suited for agent-to-agent workflows that pay per call with USDC.

## Known failure modes

- Invalid or unsupported platform_id returns an error or empty data
- Unrecognized contract address returns empty object with no pricing data
- Unsupported vs_currencies value causes malformed or missing price fields
- Payment failure results in HTTP 402 before data is returned
- Rate limiting or CoinGecko upstream outage causes timeout or 5xx error

## How this service works

Cryptocurrency market data — prices, charts, market cap, exchanges, trending coins, global stats, NFTs, derivatives, and on-chain data.

## Output

Returns a JSON object keyed by contract address with the token's price in each requested currency, and optionally 24hr volume, market cap, and 24hr percentage change. Also includes payment settlement details (USDC amount) and a request status URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "platform_id": {
   "type": "string"
  },
  "vs_currencies": {
   "type": "string"
  },
  "include_24hr_vol": {
   "type": "boolean"
  },
  "contract_addresses": {
   "type": "string"
  },
  "include_market_cap": {
   "type": "boolean"
  },
  "include_24hr_change": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coingecko-simple-token-price-via-locus-x402-0a30fcb4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from coingecko.x402.paywithlocus.com](https://www.zero.xyz/host/coingecko.x402.paywithlocus.com/llms.txt)