---
title: "Get Open Interest"
method: GET
path: "/v1/open-interest"
tags: ["Market Data"]
---

# Get Open Interest

`GET /v1/open-interest`

## Request

- Base URL: `https://api.candlefeed.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.candlefeed.ai/v1/open-interest`
- Auth: API key in header `X-API-Key`

Get historical open interest data with optional interval downsampling.

## Query parameters

- `symbol` string, required: Trading pair symbol
- `exchange` string: Exchange name
- `interval` string: 5m, 15m, 1h, 4h or 1d: the last reading in each bucket, stamped with the bucket's start
- `start` string, nullable: Start time (ISO 8601)
- `end` string, nullable: End time (ISO 8601)
- `limit` integer, nullable: Max rows to return
- `cursor` string, nullable: Pagination cursor

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/candlefeed/apis/candlefeed-api.md) · [All operations](https://skmtc.dev/candlefeed/apis/candlefeed-api/llms.txt) · [OpenAPI document](https://skmtc.dev/candlefeed/apis/candlefeed-api/revisions/8dc15dc4e380?raw)