{section}: Statistics

API: bitfinex.com:bitfinex
Endpoint: /stats1/{key}:{size}:{symbol}:{side}/{section}
Response format: application/json
Auth: none
Method: GET
Last Status: 200
Latency: 273ms

Description

Returns various trading statistics including position sizes, trade volumes, and funding rates. Use this for quantitative analysis of market activity and position distribution.

From spec: Returns various statistics including position sizes, volumes, and funding rates.

Usage Tips

- Key options: pos.size (position size), vol (volume), etc - Size granularity: 1m, 5m, 15m, 30m, 1h, etc - Side: long or short for position stats - Section: hist for history, last for most recent - Symbol format: tBTCUSD (t prefix for trading)

Parameters (9)

end (integer, query, optional)

End timestamp in milliseconds

key (string, path, required)

Statistic key: pos.size, vol.1d, funding.size, credits.size, credits.size.sym, etc.

limit (integer, query, optional)

Number of records

section (string, path, required)

'last' for most recent, 'hist' for historical

Constraints: {'enum': ['last', 'hist']}

side (string, path, required)

Side: long, short, or both

Constraints: {'enum': ['long', 'short', 'both']}

size (string, path, required)

Time frame: 1m, 5m, 15m, 30m, 1h, 3h, 6h, 12h, 1D, 7D, 14D, 1M

sort (integer, query, optional)

Sort order: +1 for ascending, -1 for descending

Constraints: {'enum': [-1, 1]}

start (integer, query, optional)

Start timestamp in milliseconds

symbol (string, path, required)

Symbol (e.g., tBTCUSD)

Examples (1)

Get BTC long position size statistics probe-gate

Demonstrates fetching historical position size statistics for BTC/USD long positions at 1-minute granularity

curl 'https://api-pub.bitfinex.com/v2/stats1/pos.size:1m:tBTCUSD:long/hist?limit=5'

import requests

resp = requests.get(
    "https://api-pub.bitfinex.com/v2/stats1/pos.size:1m:tBTCUSD:long/hist",
    params={
        'limit': '5',
    },
)
data = resp.json()

import zingu_apis

api = zingu_apis.api("bitfinex")
result = api.fetch("stats1/{key}:{size}:{symbol}:{side}/{section}", limit=5)

for item in result:
    print(item)

const resp = await fetch("https://api-pub.bitfinex.com/v2/stats1/pos.size:1m:tBTCUSD:long/hist?limit=5");
const data = await resp.json();

Truncate

Auto Table Raw

Probe History

Latency

Status Codes

Time	Status	Latency
2026-04-16 01:21:02.069825	200	273ms
2026-04-15 01:17:49.901337	200	307ms
2026-04-14 00:56:58.263335	200	280ms
2026-04-12 14:04:04.518584	200	246ms
2026-04-10 00:47:05.076033	200	330ms
2026-04-09 02:04:18.966176	200	394ms
2026-04-08 00:06:38.501810	200	232ms
2026-04-07 00:21:47.965195	200	240ms
2026-04-06 04:22:40.040803	200	236ms
2026-04-05 02:29:52.775269	200	350ms