---
title: "Get Stats"
method: GET
path: "/api/v1/market/stats"
tags: ["Market"]
---

# Get Stats

`GET /api/v1/market/stats`

## Request

- Base URL: `https://api.ekiden.fi`
- URL: `https://api.ekiden.fi/api/v1/market/stats`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ekidenfi/apis/ekiden-gateway/docs/api/v1/market/stats/get.ts> (a function with typed inputs; its response is checked against the schema)

Query for period-filtered turnover, trades, open interest, and per-market stats.

## Query parameters

- `period` '24h' | '7d' | '30d' | 'all_time', required: Stats period. `24h`, `7d`, `30d`, or `all_time`.

## Response `200`

Stats

- GetStatsResponse: Stats response.
  - `list` StatsMarket[], required
    - `avg_funding_rate` string, required: Average funding rate
    - `buy_ratio` string, required: The ratio of the number of long position
    - `last_price` string, required: Last traded price
    - `next_funding_time` string, date-time, required: Next funding time (ms)
    - `open_interest_value` string, required: Open interest value
    - `price_change` string, required: Price change
    - `sell_ratio` string, required: The ratio of the number of short position
    - `symbol` string, required
    - `turnover` string, required: Turnover
  - `period` '24h' | '7d' | '30d' | 'all_time', required: Stats period. `24h`, `7d`, `30d`, or `all_time`.
  - `summary` StatsSummary, required
    - `active_traders` string, required: Active traders
    - `active_traders_change` string, required: Active traders change
    - `open_interest_value` string, required: Open interest value
    - `open_interest_value_change` string, required: Open interest value change
    - `trades` string, required: Matched trades
    - `trades_change` string, required: Matched trades change
    - `turnover` string, required: Turnover
    - `turnover_change` string, required: Turnover change

## Other responses

- `400`: Bad Request

## Changes

- **2026-09-10** `fad9eecaba2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/changes/api/v1/market/stats/get.md)

---

[API](https://skmtc.dev/ekidenfi/apis/ekiden-gateway.md) - [All operations](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/revisions/fad9eecaba2e?raw)