# crypto.apitoll.cloud Historical Token Price Chart

> crypto.apitoll.cloud Historical Token Price Chart is a paid API for AI agents from crypto.apitoll.cloud, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns a historical price time series for up to 20 cryptocurrencies, identified by ticker, CoinGecko ID, or chain:address, with configurable data points and sampling period.

## Facts

- Endpoint: GET https://crypto.apitoll.cloud/v1/crypto/chart
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-apitoll-cloud-historical-token-price-chart-5fdb2c02
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__LKX_zKQv_zU55y5l93Uv

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 crypto-apitoll-cloud-historical-token-price-chart-5fdb2c02
```

Example prompt: Can you pull the daily historical price series for BTC, ETH, and SOL over the last 90 data points so I can chart and compare their trends?

## When to prefer this

Choose this endpoint when you need historical price data for charting, backtesting, or trend analysis across one or more cryptocurrencies. It supports flexible coin identification (ticker, CoinGecko ID, or chain:address) and configurable granularity. Prefer it over a live spot price endpoint when historical context or time series data is required. It complements /v1/crypto/price which only provides current spot prices.

## Known failure modes

- Unrecognized coin symbol or ID returns the coin in the unresolved array with resolved:false
- Requesting more than 20 coins returns an error or truncates the list
- span out of range (below 2 or above 365) returns a validation error
- Invalid period value (not 1d, 1h, 1w) returns a bad request error
- Missing coins parameter returns an error since no coins were specified
- Payment failure or expired x402 token returns a 402 Payment Required response

## How this service works

Historical token price time series by ticker symbol, CoinGecko id, or chain:address (BTC, ETH, SOL, or base:0x…): a dated array of prices for up to 20 coins, with selectable span (number of points) and period (1d, 1h, 1w). For charting, backtesting, and trend analysis. Pairs with /v1/crypto/price for the live spot. Sourced from DefiLlama.

## Output

A JSON object containing a series array where each coin has a key, symbol, resolved flag, confidence score, and a points array of {timestamp, price} objects, plus metadata like span, period, count, source name, and any unresolved coin queries.

## 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",
     "properties": {
      "span": {
       "type": "integer",
       "maximum": 365,
       "minimum": 2,
       "description": "Number of data points (2–365, default 30)."
      },
      "coins": {
       "type": "string",
       "description": "Comma-separated symbols/coingecko-ids/chain:address (up to 20)."
      },
      "period": {
       "enum": [
        "1d",
        "1h",
        "1w"
       ],
       "type": "string",
       "description": "Sampling period (default 1d)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "span": {
       "type": "number"
      },
      "count": {
       "type": "number"
      },
      "period": {
       "type": "string"
      },
      "series": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "key": {
          "type": "string"
         },
         "query": {
          "type": "string"
         },
         "points": {
          "type": "array",
          "items": {
           "type": "object",
           "properties": {
            "price": {
             "type": "number"
            },
            "timestamp": {
             "type": "number"
            }
           }
          }
         },
         "symbol": {
          "type": "string"
         },
         "resolved": {
          "type": "boolean"
         },
         "confidence": {
          "type": "number"
         }
        }
       }
      },
      "source": {
       "type": "object",
       "properties": {
        "name": {
         "type": "string"
        }
       }
      },
      "requested": {
       "type": "number"
      },
      "unresolved": {
       "type": "array",
       "items": {
        "type": "object"
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "span": 30,
  "count": 2,
  "period": "1d",
  "series": [
   {
    "key": "coingecko:bitcoin",
    "query": "BTC",
    "points": [
     {
      "price": 65000,
      "timestamp": 1781000000
     }
    ],
    "symbol": "BTC",
    "resolved": true,
    "confidence": 0.99
   }
  ],
  "source": {
   "name": "DefiLlama"
  },
  "requested": 2,
  "unresolved": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-apitoll-cloud-historical-token-price-chart-5fdb2c02/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crypto.apitoll.cloud](https://www.zero.xyz/host/crypto.apitoll.cloud/llms.txt)
