Skip to main content
GET
/
api
/
v1
/
options
/
summary
Options Summary
curl --request GET \
  --url https://api.example.com/api/v1/options/summary
Returns options market summary data sourced from Deribit, including put/call ratio, max pain price, and average implied volatility. Options flow provides insights into institutional positioning and expected price ranges.

​
Parameters

ParameterTypeDefaultDescription
currencystringBTCCurrency: BTC or ETH
hoursnumber24Lookback window in hours (max 168)

​
Example Request

curl -X GET "https://krovn.io/api/v1/options/summary?currency=BTC&hours=24" \
  -H "X-API-Key: your_api_key"

​
Example Response

{
  "currency": "BTC",
  "data": [
    {
      "timestamp": "2026-03-21T08:00:00.000Z",
      "callOI": 185400,
      "putOI": 142300,
      "putCallRatio": 0.768,
      "maxPain": 85000,
      "avgIV": 52.3
    },
    {
      "timestamp": "2026-03-21T12:00:00.000Z",
      "callOI": 186200,
      "putOI": 143100,
      "putCallRatio": 0.769,
      "maxPain": 85000,
      "avgIV": 51.8
    }
  ],
  "dataPoints": 2,
  "current": {
    "timestamp": "2026-03-21T12:00:00.000Z",
    "callOI": 186200,
    "putOI": 143100,
    "putCallRatio": 0.769,
    "maxPain": 85000,
    "avgIV": 51.8
  },
  "signal": "NEUTRAL"
}
Signals: BULLISH_OPTIONS (put/call < 0.7), BEARISH_OPTIONS (put/call > 1.2), NEUTRAL (between). Max pain is the strike price at which the most options expire worthless — price tends to gravitate toward this level near expiry.