# CoinGecko Coin History via Locus x402

> CoinGecko Coin History 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-13).

Returns historical market data (price, market cap, volume) for a specific cryptocurrency on a given date

## Facts

- Endpoint: POST https://coingecko.x402.paywithlocus.com/coingecko/coin-history
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-coin-history-via-locus-x402-86395e3d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7m1VApbK89soYs1fxCu4E

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-via-locus-x402-86395e3d -d '<json body>'
```

Example prompt: What was Bitcoin's price, market cap, and trading volume on July 4th, 2021? Pull the historical data from CoinGecko for that specific date.

## When to prefer this

Use this endpoint when you need historical cryptocurrency market data for a specific past date — not current prices. It is ideal for calculating cost basis, backtesting, auditing portfolio performance on a specific day, or researching market conditions at a point in time. Prefer this over real-time price endpoints when the date is explicitly historical. The x402 micropayment model means no API key setup is required, just USDC.

## Known failure modes

- Invalid coin ID returns an error or empty data object
- Date formatted incorrectly (not DD-MM-YYYY) causes a bad request
- Dates in the future or before coin listing return no data
- Payment failure or insufficient USDC balance blocks the request
- Rate limiting or upstream CoinGecko unavailability causes timeout

## How this service works

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

## Output

A JSON object containing the coin's historical market data for the specified date, including price in multiple currencies, market capitalization, total trading volume, and potentially localized metadata. Also includes payment settlement details and a request ID for tracking.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "id": {
   "type": "string"
  },
  "date": {
   "type": "string"
  },
  "localization": {
   "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-coin-history-via-locus-x402-86395e3d/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)