---
title: "Get daily funding/OI/price/liquidation history for a pair"
method: GET
path: "/history/derivatives"
tags: ["market"]
---

# Get daily funding/OI/price/liquidation history for a pair

`GET /history/derivatives`

## Request

- Base URL: `https://coinlobster.com/api/ai/v1`
- URL: `https://coinlobster.com/api/ai/v1/history/derivatives`
- Auth: HTTP bearer

Daily derivatives history compacted from the recorded archive (since 2026-03-18; 120+ days on major pairs): funding rate avg/min/max per day, end-of-day open interest USD, daily OHLCV, and daily liquidation totals with the long/short split. Every point carries coverage evidence (n snapshots or hours of candles); absent days had no recorded data. Costs 30 credits.

## Query parameters

- `pair` string
- `days` integer

## Response `200`

Daily series: { pair, funding: [{d, avg, min, max, n}], open_interest: [{d, usd, n}], price: [{d, o, h, l, c, v, hours}], liquidations: [{d, usd, n, longUsd, shortUsd}], coverage_note }

- object
  - `success` true, required
  - `data` object, required: Endpoint-specific payload. Every field it carries is documented in llms-full.txt and returned by /discover.
  - `meta` Meta: Present on every /api/ai/v1 response.
    - `timestamp` string, date-time: When this response was assembled, not when the data was measured.
    - `credits_used` integer: Credits this call spent. Absent on free surfaces and on keyless calls.
    - `credits_remaining` integer: Account balance after this call.
    - `deprecation` string: Present when the request used a deprecated form, e.g. the key in the query string.

## Other responses

- `404`: No archived history for this pair

---

[API](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api.md) · [All operations](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/revisions/a62c3a47523a?raw)