Skip to main content
GET
/
api
/
v1
/
markets
/
{market_id}
/
perps
/
funding
Get funding rates
curl --request GET \
  --url https://api.allium.so/api/v1/markets/{market_id}/perps/funding \
  --header 'X-API-KEY: <api-key>'
{
  "items": [
    {
      "market_id": "<string>",
      "ts": "<string>",
      "funding_rate": "<string>",
      "premium_index": "<string>",
      "interval_seconds": 123
    }
  ]
}
Alpha — The Market Data API is in alpha. Schema and response format may change. To request access, contact us or reach out to your account manager.
Returns the historical funding rate timeseries for a perpetual market, collapsed to hourly buckets. Perp markets only.
The query window is currently capped at 7 days per request.

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
market_id
string
required

Canonical market slug, {venue}:{instrument_type}:{pair}.

Query Parameters

​
from
string
required

Start of the window (ISO 8601; naive datetimes treated as UTC).

​
to
string
required

End of the window (ISO 8601).

​
limit
integer
default:168

Maximum rows to return (1–5000).

Required range: 1 <= x <= 5000

Response

200 - application/json

Funding samples, one per hour.

​
items
object[]
required