# CoinGecko Coin History

> CoinGecko Coin History 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 historical market data (price, market cap, volume) for a specific cryptocurrency on a given date

## Facts

- Endpoint: POST https://coingecko.mpp.paywithlocus.com/coingecko/coin-history?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-coin-history-39f978da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OKP1rqLiifzOpaDppcMGh

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-coin-history-39f978da -d '<json body>'
```

Example prompt: What was Bitcoin's market cap and price on December 31, 2023? Pull the historical CoinGecko data for bitcoin on 31-12-2023 without localization.

## When to prefer this

Use this endpoint when you need cryptocurrency market data (price, market cap, volume) for a specific historical date rather than current data. Ideal for backtesting, financial reporting, historical analysis, or answering questions about past crypto valuations. Prefer over Market Chart when you need a single point-in-time snapshot rather than a time series.

## Known failure modes

- Invalid coin ID returns 404 or error response
- Date in wrong format (not DD-MM-YYYY) causes validation error
- Future dates may return no data or error
- Very old dates before coin listing may return empty market data
- Rate limiting or quota exceeded returns 429 error

## How this service works

Get historical market data snapshot for a coin on a specific date.

## Output

Returns the coin's name, symbol, image URLs, and detailed market data for the specified date including market cap, current price, and total volume in dozens of fiat and crypto currencies (USD, EUR, GBP, BTC, ETH, etc.).

## Example request

```json
{
 "id": "bitcoin",
 "date": "31-12-2023",
 "localization": false
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "id",
  "date"
 ],
 "properties": {
  "id": {
   "type": "string",
   "description": "Coin ID (e.g. \"bitcoin\")"
  },
  "date": {
   "type": "string",
   "description": "Date in DD-MM-YYYY format"
  },
  "localization": {
   "type": "boolean",
   "description": "Include localized languages"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coingecko-coin-history-39f978da/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)