> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marketdataset.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /crypto/open-interest

> Historical open interest data for crypto futures

## Endpoint

```
GET https://api.marketdataset.ai/crypto/open-interest
```

Open interest (OI) is the total number of outstanding futures contracts. It measures market participation and conviction.

**Key patterns:**

* **Rising OI + Rising price** → Strong uptrend with new money entering
* **Rising OI + Falling price** → Strong downtrend
* **Falling OI + Rising price** → Short squeeze, potentially weak move
* **Falling OI + Falling price** → Profit-taking, trend may be ending

## Parameters

| Name         | Type    | Required | Description                                     |
| ------------ | ------- | -------- | ----------------------------------------------- |
| `symbol`     | string  | Yes      | Futures symbol, e.g. `BTCUSDT`, `ETHUSDT`       |
| `exchange`   | string  | No       | Exchange (default: `binance`)                   |
| `interval`   | string  | No       | `5m`, `1h`, `1d` (default: `1h`)                |
| `start_date` | string  | No       | ISO 8601 date                                   |
| `end_date`   | string  | No       | ISO 8601 date                                   |
| `limit`      | integer | No       | Records to return (default: `100`, max: `1000`) |
| `cursor`     | string  | No       | Pagination cursor                               |

## Credit cost

**\$0.010** per request

## Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.marketdataset.ai/crypto/open-interest?symbol=BTCUSDT&interval=1h&limit=10" \
    -H "X-API-KEY: sk_your_key"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.marketdataset.ai/crypto/open-interest",
      params={"symbol": "BTCUSDT", "interval": "1h", "limit": 10},
      headers={"X-API-KEY": "sk_your_key"},
  )
  print(response.json())
  ```
</CodeGroup>

## Example response

```json theme={null}
{
  "open_interest": [
    {
      "symbol": "BTCUSDT",
      "exchange": "binance",
      "interval": "1h",
      "open_interest": 84231.45,
      "open_interest_value": 5743821234.12,
      "timestamp": "2024-11-01T15:00:00+00:00"
    }
  ],
  "next_page_url": null,
  "meta": {
    "request_id": "req_abc123",
    "credits_used": 0.01,
    "credits_remaining": 49.99
  }
}
```

## Fields

| Field                 | Description                                       |
| --------------------- | ------------------------------------------------- |
| `open_interest`       | Total open contracts (in base currency, e.g. BTC) |
| `open_interest_value` | Total open contracts value in USD                 |