Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/history

Long/short ratio time-series

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/longshortratio-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/longshortratio-api/v1/history" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/longshortratio-api/v1/history", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/longshortratio-api/v1/history");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/longshortratio-api/v1/history",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "count": 50,
        "period": "1h",
        "symbol": "BTCUSDT",
        "history": [
            {
                "symbol": "BTCUSDT",
                "long_pct": 62.32,
                "short_pct": 37.68,
                "timestamp": "2026-06-07T02:00:00.000Z",
                "long_ratio": 0.6232,
                "short_ratio": 0.3768,
                "long_short_ratio": 1.6539
            },
            {
                "symbol": "BTCUSDT",
                "long_pct": 62.45,
                "short_pct": 37.55,
                "timestamp": "2026-06-07T03:00:00.000Z",
                "long_ratio": 0.6245,
                "short_ratio": 0.3755,
                "long_short_ratio": 1.6631
            },
            {
                "symbol": "BTCUSDT",
                "long_pct": 62.75,
                "short_pct": 37.25,
                "timestamp": "2026-06-07T04:00:00.000Z",
                "long_ratio": 0.6275,
                "short_ratio": 0.3725,
                "long_short_ratio": 1.6846
            },
            {
                "symbol": "BTCUSDT",
                "long_pct": 62.94,
                "short_pct": 37.06,
                "timestamp": "2026-06-07T05:00:00.000Z",
                "long_ratio": 0.6294,
                "short_ratio": 0.3706,
                "long_short_ratio": 1.6983
            },
            {
                "symbol": "BTCUSDT",
                "long_pct": 63.21,
                "short_pct": 36.79,
                "timestamp": "2026-06-07T06:00:00.000Z",
                "long_ratio": 0.6321,
                "short_ratio": 0.3679,
                "long_short_ratio": 1.7181
            },
            {
                "symbol": "BTCUSDT",
                "long_pct": 63.43,
                "short_pct": 36.57,
                "timestamp": "2026-06-07T07:00:00.000Z",
                "long_ratio": 0.6343,
                "short_ratio": 0.3657,
                "long_short_ratio": 1.7345
            },
            {
                "symbol": "BTCUSDT",
                "long_pct": 63.85,
                "short_pct": 36.15,
                "timestamp": "2026-06-07T08:00:00.000Z",
                "long_ratio": 0.6385,
                "short_ratio": 0.3615,
                "long_short_ratio": 1.7663
            },
            {
                "symbol": "BTCUSDT",
                "long_pct": 64.58,
                "short_pct": 35.42,
                "timestamp": "2026-06-07T09:00:00.000Z",
                "long_ratio": 0.6458,
                "short_ratio": 0.3542,
                "long_short_ratio": 1.8233
            },
            {
                "symbol": "BTCUSDT",
                "long_pct": 63.8,
                "short_pct": 36.2,
                "timestamp": "2026-06-07T10:00:00.000Z",
                "long_ratio": 0.638,
                "short_ratio": 0.362,
                "long_short_ratio": 1.7624
            },
            {
                "symbol": "BTCUSDT",
                
…