---
title: "Windowed stats"
method: GET
path: "/tokens/stats/{address}"
tags: ["Tokens and charts"]
---

# Windowed stats

`GET /tokens/stats/{address}`

## Request

- Base URL: `https://api.getchord.xyz/v1`
- URL: `https://api.getchord.xyz/v1/tokens/stats/{address}`
- Auth: none declared

DexScreener-style windows (5 m, 1 h, 6 h, 24 h): change, transactions, buys/sells, buy/sell volume, makers, buyers, sellers — plus all-time high, 24-hour range, first trade, total transactions and the markets (pools) the token trades on. Cached with stale-while-revalidate, so it answers fast and refreshes in the background.

## Path parameters

- `address` string, required: EVM address, hex, case-insensitive.

## Response `200`

- object
  - `priceUsd` number, nullable
  - `windows` object
    - `m5` StatsWindow
      - `change` number: Percent.
      - `txns` integer
      - `buys` integer
      - `sells` integer
      - `buyVol` number
      - `sellVol` number
      - `makers` integer
      - `buyers` integer
      - `sellers` integer
    - `h1` StatsWindow
      - `change` number: Percent.
      - `txns` integer
      - `buys` integer
      - `sells` integer
      - `buyVol` number
      - `sellVol` number
      - `makers` integer
      - `buyers` integer
      - `sellers` integer
    - `h6` StatsWindow
      - `change` number: Percent.
      - `txns` integer
      - `buys` integer
      - `sells` integer
      - `buyVol` number
      - `sellVol` number
      - `makers` integer
      - `buyers` integer
      - `sellers` integer
    - `h24` StatsWindow
      - `change` number: Percent.
      - `txns` integer
      - `buys` integer
      - `sells` integer
      - `buyVol` number
      - `sellVol` number
      - `makers` integer
      - `buyers` integer
      - `sellers` integer
  - `liquidityUsd` number, nullable
  - `ath` object, nullable
    - `priceUsd` number
    - `ts` integer: Unix time, seconds, UTC.
  - `range24h` object, nullable
    - `high` number
    - `low` number
  - `firstTradeTs` integer, nullable: Unix time, seconds, UTC.
  - `totalTxns` integer
  - `markets` object[]
    - `dex` string
    - `pool` string: A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.
    - `txns24h` integer
    - `vol24h` number
    - `makers24h` integer

## Other responses

- `400`: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).
- `404`: Nothing at this identity (`NOT_FOUND`, `UNKNOWN_TOKEN`, `NO_ROUTE`).

---

[API](https://skmtc.dev/getchord/apis/chord-api.md) · [All operations](https://skmtc.dev/getchord/apis/chord-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getchord/apis/chord-api/revisions/d3bc4640fea0?raw)