# Arkham Token Market Data

> Arkham Token Market Data 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-16).

Returns real-time and historical market data for a cryptocurrency token, including price, market cap, supply, and volume metrics

## Facts

- Endpoint: POST https://api.arkm.com/x402/token/market
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-token-market-data-7ef63790
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AvuafjD9d6c2qcADcwSHv

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-market-data-7ef63790 -d '<json body>'
```

Example prompt: Pull up the current market data for USDC — price, market cap, circulating supply, and how the price has moved over the last 24 hours, 7 days, and 30 days.

## When to prefer this

Choose this endpoint when you need comprehensive market data for a specific token in a single call — especially when you need multiple timeframe comparisons (24h, 7d, 30d, 180d) alongside supply metrics and all-time records. Prefer Arkham's endpoint over generic market data APIs when you need wallet-intelligence-grade data quality or are already using Arkham's ecosystem. The x402 pay-per-request model makes it cost-effective for occasional lookups without subscription commitment.

## Known failure modes

- Invalid or unrecognized token identifier returns an error response
- Insufficient USDC payment via x402 results in 402 Payment Required
- Network timeout for real-time price data
- Token with no market data available returns empty or null fields
- Malformed POST body causes 400 Bad Request

## How this service works

Get Arkham current market data for a token. $0.20 per call.

## Output

A JSON object containing the token's current price, market cap, all-time low, all-time high, price 24 hours ago, price 7 days ago, price 30 days ago, price 180 days ago, max and min price in the last 24 hours, total supply, circulating supply, fully diluted value, and total trading volume.

## 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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "price": 0.999831,
  "marketCap": 73340976893,
  "allTimeLow": 0.877647,
  "price7dAgo": 0.999852,
  "allTimeHigh": 1.043,
  "maxPrice24h": 0.999979,
  "minPrice24h": 0.999745,
  "price24hAgo": 0.999797,
  "price30dAgo": 0.999724,
  "totalSupply": 73355068862.08713,
  "totalVolume": 7539296441,
  "price180dAgo": 0.999812,
  "circulatingSupply": 73354602419.50252,
  "fullyDilutedValue": 73342671855.44943
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-token-market-data-7ef63790/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)