# Arkham Token Price History

> Arkham Token Price History is a paid API for AI agents from api.arkm.com, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-14).

Retrieves historical price, market cap, and 24h volume data for a specific token over a given time range

## Facts

- Endpoint: POST https://api.arkm.com/x402/token/price/history
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-token-price-history-411062af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e1SaO7CmWSEDQQmO9hvkg

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 arkham-token-price-history-411062af -d '<json body>'
```

Example prompt: Pull the Arkham price history for USDC over the last 24 hours — I need the USD price, market cap, and 24h volume at each data point.

## When to prefer this

Choose this endpoint when you need structured historical time-series market data (price, market cap, volume) for a specific crypto token, particularly when Arkham's wallet intelligence data provenance or on-chain tracking is important. Prefer this over generic market data APIs (CoinGecko, CoinMarketCap) when you need Arkham's specific dataset or when integrating with other Arkham wallet/entity intelligence endpoints for a unified data pipeline.

## Known failure modes

- Invalid or unrecognized token symbol/address returns an error or empty array
- Time range too broad may result in truncated or paginated results
- Insufficient USDC balance for x402 payment causes payment failure and request rejection
- Malformed POST body (missing required token or time range fields) returns a 400-level error
- Token with no trading history in the requested range returns an empty array

## How this service works

Get Arkham token price history by pricing ID or chain/address. $0.20 per call.

## Output

Returns a JSON array of time-series data points, each containing a USD price (float), ISO 8601 timestamp, market cap in USD, and 24-hour trading volume in USD. Data points are spaced at varying intervals depending on query parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "id": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The CoinGecko pricing ID of the token."
  },
  "chain": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Blockchain network where the token is deployed."
  },
  "daily": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "If 'true', returns the full daily price history for the token. Otherwise returns every quote recorded in the last 24 ho…"
  },
  "address": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The token contract address."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": [
  {
   "usd": 0.999798,
   "time": "2026-07-13T10:26:27.747Z",
   "marketCap": 73287761995,
   "volume24h": 8228653724
  },
  {
   "usd": 0.9998,
   "time": "2026-07-13T10:27:12.877Z",
   "marketCap": 73290240682,
   "volume24h": 8232347779
  },
  {
   "usd": 0.999766,
   "time": "2026-07-13T10:29:22.977Z",
   "marketCap": 73286652112,
   "volume24h": 8252952310
  }
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-token-price-history-411062af/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arkm.com](https://www.zero.xyz/host/api.arkm.com/llms.txt)
