# CoinGecko Simple Token Price

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

Retrieves the current price and optional market data (market cap, 24h volume, 24h change) for a token by its smart contract address on a specified blockchain platform.

## Facts

- Endpoint: POST https://coingecko.mpp.paywithlocus.com/coingecko/simple-token-price?utm_source=zero.xyz
- Price: $0.06/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Provider: CoinGecko
- Docs: https://docs.coingecko.com
- Website: https://www.coingecko.com
- Tags: crypto, prices, market-cap, exchanges, trending, data
- Canonical page: https://www.zero.xyz/c/coingecko-simple-token-price-712703d6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6crBtxNBPIz9nHb--I82l

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-712703d6 -d '<json body>'
```

Example prompt: What's the current USD price, market cap, and 24-hour change for the token at Ethereum contract address 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48?

## When to prefer this

Use this endpoint when you have a specific token's smart contract address on a known blockchain platform (e.g. Ethereum, Polygon) and need current price data. Prefer this over the Simple Price endpoint when you identify tokens by contract address rather than by CoinGecko coin ID or ticker symbol. Ideal for DeFi applications, portfolio trackers, or any workflow that deals with on-chain token contracts.

## Known failure modes

- Invalid or unrecognized contract address returns empty data object
- Unsupported platform_id returns an error or empty result
- Invalid vs_currencies string causes a failed or incomplete response
- Comma-separated contract addresses with whitespace may cause lookup failures
- Rate limiting or service unavailability returns a non-success response

## How this service works

Get token prices by contract address on a specific platform (e.g. Ethereum).

## Output

Returns a JSON object keyed by contract address containing the token's price in the requested currency, and optionally its 24-hour trading volume, 24-hour percentage price change, and market capitalization. Includes a 'success' boolean flag.

## Example request

```json
{
 "platform_id": "ethereum",
 "vs_currencies": "usd",
 "include_24hr_vol": true,
 "contract_addresses": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
 "include_market_cap": true,
 "include_24hr_change": true
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "platform_id",
  "contract_addresses",
  "vs_currencies"
 ],
 "properties": {
  "platform_id": {
   "type": "string",
   "description": "Platform ID (e.g. \"ethereum\", \"polygon-pos\")"
  },
  "vs_currencies": {
   "type": "string",
   "description": "Comma-separated target currencies"
  },
  "include_24hr_vol": {
   "type": "boolean",
   "description": "Include 24hr volume"
  },
  "contract_addresses": {
   "type": "string",
   "description": "Comma-separated contract addresses"
  },
  "include_market_cap": {
   "type": "boolean",
   "description": "Include market cap"
  },
  "include_24hr_change": {
   "type": "boolean",
   "description": "Include 24hr change"
  }
 },
 "additionalProperties": true
}
```

## More

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