---
title: "Futures Market Overview"
method: GET
path: "/gateway/v1/market/futures"
tags: ["Market"]
---

# Futures Market Overview

`GET /gateway/v1/market/futures`

Returns futures market data across all tracked tokens in a single ranked snapshot.

**Included fields:** open interest, funding rate, long/short ratio, 24h volume.

Sorted by `volume_24h` by default — use `sort_by` to change.

**No pagination** — this endpoint returns the full list in one response. Does NOT accept `limit`, `offset`, or `symbol`; to filter to one token, look it up in the response locally.

## Query parameters

- `sort_by` 'open_interest' | 'funding_rate' | 'volume_24h' | 'long_short_ratio' — Field to sort results by
- `order` 'asc' | 'desc' — Sort order

## Response `200`

OK

- SimpleListResponseMarketFuturesItem
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` MarketFuturesItem[], nullable, required
    - `funding_rate` number, double, required — Current funding rate as a decimal (`0.0001` = 0.01%)
    - `long_short_ratio` number, double, required — Ratio of long to short positions
    - `open_interest` number, double, required — Total open interest in USD
    - `project_id` string — Surf project UUID this symbol resolved to, for frontend entity linking. Empty when unmapped.
    - `symbol` string, required — Trading symbol like `BTC` or `ETH`
    - `updated_at` integer, required — Unix timestamp (seconds) of last update
    - `volume_24h` number, double, required — 24-hour trading volume in USD
    - `volume_change_24h` number, double, required — 24-hour volume change in USD (positive=increase, negative=decrease)
  - `meta` ObjectResponseMeta, required
    - `cached` boolean, required — Whether this response was served from cache
    - `credits_used` integer, required — Credits deducted for this request
    - `empty_reason` string — Hint explaining why the data array is empty, when applicable

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) · [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/revisions/0034a432f8be?raw)