# Arkham Token Price Change

> Arkham Token Price Change 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-15).

Returns the percentage or absolute price change of a token since a specified past timestamp, using CoinGecko pricing IDs.

## Facts

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

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-change-f88562cb -d '<json body>'
```

Example prompt: Using Arkham, what's the price change for ethereum (CoinGecko ID: ethereum) since 2024-06-01T00:00:00Z?

## When to prefer this

Choose this endpoint when you need a quick, point-in-time price change calculation for a specific token relative to a past timestamp, especially within an onchain intelligence or Arkham-native workflow. It is more targeted than fetching full historical OHLCV data and cheaper than endpoints that return full transfer or balance histories. Prefer it when the only required output is how much a token's price changed since a known moment.

## Known failure modes

- Invalid or unrecognized CoinGecko token ID returns an error or empty result
- Malformed RFC3339 timestamp causes a validation error
- Timestamp too far in the past may exceed available historical data
- Payment failure (insufficient USDC balance) blocks the call
- Rate limiting or network timeouts on the Arkham API side

## How this service works

Get Arkham token price change since a timestamp. $0.20 per call.

## Output

Returns the price change of the specified token (by CoinGecko ID) from the given past RFC3339 timestamp to the current time, typically including the magnitude of price movement (e.g. absolute and/or percentage change).

## 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."
  },
  "pastTime": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Past timestamp in RFC3339 format to calculate price change from."
  }
 }
}
```

## More

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