---
title: "Get Arkham token price history by pricing ID or chain/address"
method: POST
path: "/token/price/history"
tags: ["Token"]
---

# Get Arkham token price history by pricing ID or chain/address

`POST /token/price/history`

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

## Request body

- union
  - object
    - `id` union, required — The CoinGecko pricing ID of the token.
      - string
      - number
      - boolean
      - union[]
        - union
          - string
          - number
          - boolean
    - `chain` union — Blockchain network where the token is deployed.
      - string
      - number
      - boolean
      - union[]
        - union
          - string
          - number
          - boolean
    - `address` union — The token contract address.
      - string
      - number
      - boolean
      - union[]
        - union
          - string
          - number
          - boolean
    - `daily` union — If 'true', returns the full daily price history for the token. Otherwise returns every quote recorded in the last 24 ho…
      - string
      - number
      - boolean
      - union[]
        - union
          - string
          - number
          - boolean
  - object
    - `id` union — The CoinGecko pricing ID of the token.
      - string
      - number
      - boolean
      - union[]
        - union
          - string
          - number
          - boolean
    - `chain` union, required — Blockchain network where the token is deployed.
      - string
      - number
      - boolean
      - union[]
        - union
          - string
          - number
          - boolean
    - `address` union, required — The token contract address.
      - string
      - number
      - boolean
      - union[]
        - union
          - string
          - number
          - boolean
    - `daily` union — If 'true', returns the full daily price history for the token. Otherwise returns every quote recorded in the last 24 ho…
      - string
      - number
      - boolean
      - union[]
        - union
          - string
          - number
          - boolean

## Response `200`

Successful response

- unknown[]
  - unknown

## Other responses

- `400` — Fatal for the request as written: validation failed or required JSON body fields are missing. Fix the request; do not retry it unchanged. Payment is not settled.
- `402` — Payment challenge, not an application error. Read the base64 x402 v2 challenge from PAYMENT-REQUIRED, sign it, and retry the same request with PAYMENT-SIGNATURE. If a post-payment 402 omits PAYMENT-REQUIRED, verification failed: read the new challenge, re-sign, and retry once.
- `404` — The upstream Arkham resource does not exist. Fatal for the same input. Payment is not settled.
- `429` — Per-wallet endpoint rate limit exceeded. Retry with at least 1 second of backoff; keep heavy endpoints at no more than 1 request per second.
- `5XX` — Arkham failed or timed out, including 502 and 504 responses. Retry with backoff. x402 payments and MPP transaction credentials are not settled for failed requests; MPP hash credits are redeemed at admission and are not refunded automatically.

---

[API](https://skmtc.net/arkm/apis/arkham-x402.md) · [All operations](https://skmtc.net/arkm/apis/arkham-x402/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arkm/arkham-x402/revisions/7830c19a58c4/schema)