---
title: "Token Stats"
method: POST
path: "/api/v1/developer/prices/stats"
tags: ["PRICES", "DEVELOPER"]
---

# Token Stats

`POST /api/v1/developer/prices/stats`

Get the stats for the given token addresseses.

## Request body

- PayloadTokenAddress[] — List of token addresses to get stats for.
  - `token_address` string, required — Token contract address
  - `chain` string, required — Lowercase chain name

## Response `200`

Successful Response

- EnvelopeTokenStatsWithHiddenFields
  - `items` TokenStatsWithHiddenFields[], required — Response items
    - `mint` string, required — Token contract address
    - `chain` string, required — Lowercase chain name
    - `timestamp` string, date-time, required — ISO 8601 UTC timestamp
    - `latest_price` number, required — Latest price (USD)
    - `low_24h` number, required — Lowest price (USD) over last 24h
    - `high_24h` number, required — Highest price (USD) over last 24h
    - `low_1h` number, required — Lowest price (USD) over last 1h
    - `high_1h` number, required — Highest price (USD) over last 1h
    - `percent_change_24h` number, nullable, required — Price change (%) over last 24h
    - `percent_change_1h` number, nullable, required — Price change (%) over last 1h
    - `decimals` integer, nullable — Token decimal places
  - `cursor` string, nullable — Pagination cursor for next page
  - `message` string, nullable — Informational message (e.g. partial results)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/allium/apis/allium-account-api.md) · [All operations](https://skmtc.net/allium/apis/allium-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/allium/allium-account-api/versions/6c79c032c85d/schema)