---
title: "Get exchange statistics"
method: GET
path: "/stats"
tags: ["Market Data"]
---

# Get exchange statistics

`GET /stats`

Returns exchange statistics with optional symbol filtering.

All periods currently return 24h rolling stats. Aggregate queries (`symbol` omitted) are
cached with 600s TTL; symbol-specific queries bypass cache. The markets array is sorted by
`quoteVolume` descending.

**Period aliases accepted by server**:

| Alias | Canonical |
|---|---|
| `24h` | `1d` |
| `1w` | `7d` |
| `1m` | `30d` |
| `3m` | `90d` |
| `365d` | `1y` |

## Query parameters

- `period` '1d' | '7d' | '30d' | '90d' | '1y' | 'all'
- `symbol` string

## Response `200`

Successful response

- ExchangeStats — Aggregate exchange statistics
  - `timestamp` integer — Server timestamp (milliseconds)
  - `period` string — Requested period
  - `volume` object
    - `totalUsd` number — Total volume in USD
  - `openInterest` object
    - `totalUsd` number — Sum of per-market open interest converted to USD using mark prices
  - `funding` object
    - `rates` object — Funding rates by market symbol
  - `markets` object[] — Per-market breakdown (sorted by quoteVolume desc)
    - `symbol` string
    - `volume` number — 24h volume in base currency
    - `quoteVolume` number — 24h volume in USD
    - `openInterest` number — Open interest in native market units (base/contracts)
    - `fundingRate` number — Current 8-hour funding rate
    - `fundingRateAnnualized` number — Annualized funding rate
    - `lastPrice` number
    - `markPrice` number

## Other responses

- `500` — Internal Server Error - Database or channel error

---

[API](https://skmtc.net/bulk/apis/bulk-trade-api.md) · [All operations](https://skmtc.net/bulk/apis/bulk-trade-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bulk/bulk-trade-api/versions/087f7b45aa1a/schema)