---
title: "Coins ranked by open interest change"
method: GET
path: "/v1/open-interest/scan"
---

# Coins ranked by open interest change

`GET /v1/open-interest/scan`

## Request

- Base URL: `https://app.texttoquant.com/api`
- URL: `https://app.texttoquant.com/api/v1/open-interest/scan`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Change in open interest in coin terms over a window, like for like across Bybit, OKX, Bitget, Hyperliquid and KuCoin, with price change and the positioning regime.

## Query parameters

- `window` '1h' | '4h' | '24h' | '7d'
- `sort` 'oi_move' | 'oi_change' | 'oi_drop' | 'open_interest'
- `limit` integer
- `minOpenInterestUsd` number
- `regime` 'new_longs' | 'short_covering' | 'new_shorts' | 'long_liquidation' | 'flat'

## Response `200`

Success

- object
  - `success` true, required
  - `data` object, required

## Other responses

- `400`: validation_error
- `403`: Plan does not include marketData
- `502`: upstream

---

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