# Crypto Price History API (CoinGecko Free Tier)

> Crypto Price History API (CoinGecko Free Tier) is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns daily OHLC price series, market cap, and volume for a cryptocurrency over a specified window (up to 365 days)

## Facts

- Endpoint: GET https://api.x402node.dev/finance/crypto-hist
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-x402node-dev-20716fae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yQvJ-BSHMQXxkJx6M5Vye

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 api-x402node-dev-20716fae
```

Example prompt: Can you pull the daily open/close price series, market cap, and volume for bitcoin in USD over the last 30 days so I can run some technical analysis?

## When to prefer this

Use this endpoint when you need historical daily OHLC price data, market cap, or volume for a cryptocurrency for technical analysis or backtesting — especially when you want a simple, key-free CoinGecko-backed data source without managing your own API credentials.

## Known failure modes

- Invalid coin ID returns an error or empty result
- Days parameter exceeding 365 rejected on free tier
- Unsupported vs_currency returns an error
- CoinGecko upstream rate limiting may cause failures
- Missing required query parameters (id, vs, days) returns a bad request error

## How this service works

x402node — precise, deterministic developer and data tools for AI agents. Chain data, parsing, crypto, conversion. Pay-per-call over x402, settled in USDC on Base.

## Output

A daily price series object containing open and close prices per day, market capitalization, and trading volume for the requested cryptocurrency over the specified window (up to 365 days on free tier)

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Identifier (required)"
      },
      "vs": {
       "type": "string",
       "description": "Vs (optional)"
      },
      "days": {
       "type": "string",
       "description": "Days (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-x402node-dev-20716fae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)