# Arkham Token Market Data by ID

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

Returns current and historical market data for a specific token by ID, including price, market cap, supply, and volume metrics.

## Facts

- Endpoint: POST https://api.arkm.com/x402/token/market/by-id
- 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-market-data-by-id-04af78fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7-pgRiGQzkcVCySH714FQ

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-by-id-04af78fd -d '<json body>'
```

Example prompt: Pull up the current market data for USDT from Arkham — I want to see the price, market cap, all-time high and low, and how the price has changed over the last 7, 30, and 180 days.

## When to prefer this

Choose this endpoint when you need comprehensive market metrics for a specific token — including historical price snapshots, supply data, and all-time extremes — especially when integrating with Arkham's broader wallet intelligence ecosystem. Prefer this over generic market data APIs when working within Arkham's on-chain analytics infrastructure or when paying per-request via x402 is acceptable.

## Known failure modes

- Invalid or unknown token ID returns an error or empty response
- Insufficient USDC balance for x402 payment causes request to fail
- Rate limiting if too many requests are made in a short window
- Network or API downtime returns a 5xx error
- Malformed POST body missing the token ID field

## How this service works

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

## Output

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

## 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-by-id-04af78fd/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)