---
title: "Get Oi Divergence"
method: GET
path: "/api/v1/liquidity/oi-divergence"
tags: ["Liquidity / Market Depth"]
---

# Get Oi Divergence

`GET /api/v1/liquidity/oi-divergence`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/liquidity/oi-divergence`
- Auth: API key in header `X-API-Key`

OI vs price change across 1h/4h/24h windows, ranked by 4h divergence.

Positive divergence (OI rising faster than price) = fragile positioning.
Coins without enough history for a given window report null for that window.

The free tier is scoped to BTC; full-universe coverage is Pro and Pro Plus.

## Response `200`

Successful Response

- OIDivergenceResponse
  - `as_of` integer, required
  - `universe_size` integer, required
  - `rows` OIDivergenceRow[], required
    - `coin` string, required
    - `price` number, nullable
    - `open_interest_usd` number, nullable
    - `price_change_1h_pct` number, nullable
    - `price_change_4h_pct` number, nullable
    - `price_change_24h_pct` number, nullable
    - `oi_change_1h_pct` number, nullable
    - `oi_change_4h_pct` number, nullable
    - `oi_change_24h_pct` number, nullable
    - `divergence_4h` number, nullable: oi_change_4h_pct - price_change_4h_pct (positive = OI rising faster than price)

---

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