# Token Price History: Daily or Hourly USD Series

> Token Price History: Daily or Hourly USD Series is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-28).

Returns a time series of USD prices for a cryptocurrency token, at daily or hourly resolution, for up to 1 year

## Facts

- Endpoint: POST https://twin.unykorn.org/defi/token-price-history?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-price-history-daily-or-hourly-usd-series-bde38b3a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ARt6xXaCp3iSx_jczL7KU

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 token-price-history-daily-or-hourly-usd-series-bde38b3a -d '<json body>'
```

Example prompt: Pull me the daily USD price history for Ethereum (coingecko:ethereum) over the last 90 days so I can analyze its trend.

## When to prefer this

Choose this endpoint when you need historical USD price time series for a specific cryptocurrency token at daily or hourly granularity, especially for DeFi/on-chain analysis workflows. It is well-suited for backtesting, charting, trend analysis, and portfolio performance review, and supports up to 1 year of history. Prefer this over general market data APIs when operating in an x402 micropayment-native agent environment.

## Known failure modes

- Invalid or unrecognized coin identifier (e.g. missing coingecko: prefix) returns an error
- days value outside 2–365 range is rejected
- Unsupported period value (not '1d' or '1h') causes a validation error
- Token not tracked by the underlying data source returns no data or 404
- Payment failure (x402) if USDC is not provided or insufficient

## How this service works

Token price history: daily or hourly USD series up to 1 year — Genesis402 / UnyKorn Operator Network

## Output

A time series of USD price data points for the specified token, indexed by timestamp, at either daily (1d) or hourly (1h) granularity, covering the requested number of days up to a maximum of 365.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "coin": {
     "type": "string",
     "description": "required: e.g. coingecko:ethereum"
    },
    "days": {
     "type": "integer",
     "maximum": 365,
     "minimum": 2,
     "description": "optional 2-365, default 30"
    },
    "period": {
     "enum": [
      "1d",
      "1h"
     ],
     "type": "string",
     "description": "optional: 1d (default) | 1h"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-price-history-daily-or-hourly-usd-series-bde38b3a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)