---
title: "Get Long Short Ratio"
method: GET
path: "/v1/long-short-ratio"
tags: ["Market Data"]
---

# Get Long Short Ratio

`GET /v1/long-short-ratio`

## Request

- Base URL: `https://api.candlefeed.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.candlefeed.ai/v1/long-short-ratio`
- Auth: API key in header `X-API-Key`

Get historical long/short ratio data with optional interval downsampling.

## Query parameters

- `symbol` string, required: Trading pair symbol
- `exchange` string: Exchange name
- `interval` string: Interval for downsampling (5m, 15m, 1h, 4h, 1d)
- `ratio_type` 'top_account' | 'global_account' | 'both': Ratio type to return: top_account, global_account, or both
- `start` string, nullable: Start time (ISO 8601)
- `end` string, nullable: End time (ISO 8601)
- `limit` integer, nullable: Max rows to return. Aggregated intervals (15m+) with ratio_type=both return whole buckets: a page can exceed the limit by up to (number of ratio types - 1) extra rows so that no bucket is split across pages.
- `cursor` string, nullable: Pagination cursor

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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