---
title: "Get market stats history"
method: GET
path: "/v1/market/{symbol}/stats"
tags: ["Exchange"]
---

# Get market stats history

`GET /v1/market/{symbol}/stats`

Handles `GET /v1/market/{symbol}/stats` via `get.v1.market.by_symbol.stats`.

## Path parameters

- `symbol` string, required

## Query parameters

- `start_time` string, date-time, nullable
- `end_time` string, date-time, nullable
- `limit` integer, nullable
- `timeframe` string, nullable

## Response `200`

Successfully retrieved market stats history

- MarketStatsHistoryResponse — Response for market stats history endpoint
  - `market_id` integer, required
  - `stats` MarketStatsPoint[], required
    - `mark_price` number, double, required
    - `open_interest` number, double, required
    - `slot` integer, required
    - `spot_price` number, double, required
    - `timestamp` string, date-time, required — Formatted datetime string (ISO 8601).
    - `total_maker_fees` number, double, nullable
    - `total_taker_fees` number, double, nullable
  - `symbol` string, required
  - `timeframe` string, nullable

## Other responses

- `400` — Standard JSON error payload.
- `404` — Standard JSON error payload.
- `500` — Standard JSON error payload.

---

[API](https://skmtc.net/phoenix/apis/phoenix-eternal-api.md) · [All operations](https://skmtc.net/phoenix/apis/phoenix-eternal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phoenix/phoenix-eternal-api/revisions/0f598402d680/schema)