Skip to main content
GET
/
api
/
v1
/
oi
/
velocity
OI Velocity
curl --request GET \
  --url https://api.example.com/api/v1/oi/velocity
Calculates the rate of change of open interest over a given window and maps it to theoretical liquidation price levels for each leverage tier (5x, 10x, 25x, 50x, 100x). Rising OI velocity at high leverage indicates growing risk of cascading liquidations.

​
Parameters

ParameterTypeDefaultDescription
symbolstringBTCUSDTTrading pair
hoursnumber6Lookback window in hours (max 48)

​
Example Request

curl -X GET "https://krovn.io/api/v1/oi/velocity?symbol=BTCUSDT&hours=6" \
  -H "X-API-Key: your_api_key"

​
Example Response

{
  "symbol": "BTCUSDT",
  "currentPrice": 87420.50,
  "buckets": [
    {
      "price": 69936.40,
      "priceLow": 69499.30,
      "priceHigh": 70373.50,
      "leverage": 5,
      "side": "long",
      "direction": "building",
      "intensity": 20,
      "deltaPerHour": 4250000
    },
    {
      "price": 104904.60,
      "priceLow": 104467.50,
      "priceHigh": 105341.70,
      "leverage": 5,
      "side": "short",
      "direction": "building",
      "intensity": 20,
      "deltaPerHour": 4250000
    }
  ],
  "meta": {
    "snapshots": 72,
    "hours": 6,
    "totalDeltaUsd": 25500000,
    "deltaPerHourUsd": 4250000,
    "direction": "building"
  },
  "computedAt": "2026-03-21T12:30:00.000Z"
}
direction is building when OI is increasing (new positions opening) and declining when OI is decreasing (positions closing). Higher leverage buckets have higher intensity weights as they represent greater liquidation risk.