Long/Short Ratio History - Surf API Documentation

{ "data": [ { "exchange": "<string>", "long_short_ratio": 123, "pair": "<string>", "timestamp": 123 } ], "meta": { "cached": true, "credits_used": 123 }, "$schema": "<string>" }

Query Parameters

pair

string

required

Trading pair (e.g. BTC/USDT)

Example:

"BTC/USDT"

interval

enum<string>

default:1h

Data interval

Available options:

1h,

4h,

1d

Example:

"1h"

from

string

Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD, ISO8601). Not all exchanges support historical queries; some only return recent data regardless of this value.

Example:

"2026-03-01"

limit

integer<int64>

default:50

Max number of records. For longer history, paginate using the last returned timestamp as the next from value.

Required range: 1 <= x <= 500

Example:

50

exchange

enum<string>

default:binance

Exchange identifier

Available options:

binance,

okx,

bybit,

bitget

Example:

"binance"

Response

data

object[] | null

required

Show child attributes

API Reference

Query Parameters

Response