---
title: "Deribit options metrics"
method: GET
path: "/api/markets/options/{currency}"
tags: ["Crypto"]
---

# Deribit options metrics

`GET /api/markets/options/{currency}`

## Request

- Base URL: `https://xoomar.com`
- URL: `https://xoomar.com/api/markets/options/{currency}`
- Auth: one of:
  - none
  - API key in header `x-api-key`

Total open interest, put/call ratio, DVOL and per-expiry max pain for BTC or ETH. Docs: https://xoomar.com/markets/api/options

## Path parameters

- `currency` 'BTC' | 'ETH', required

## Response `200`

OK

- object
  - `data` object
    - `currency` string: BTC or ETH
    - `underlyingPrice` number: Deribit index price of the underlying as of updatedAt
    - `updatedAt` string: The time the figures are as of, ISO
    - `totalOI` number: Total open interest across all strikes, in contracts
    - `pcRatio` number: Put/call open interest ratio across all expiries
    - `dvol` number, nullable: Deribit implied volatility index (crypto VIX)
    - `expiries` object[]: Per-expiry summaries for the nearest 10 expiries, nearest first
      - `expiry` string, date: Expiry date YYYY-MM-DD
      - `maxPain` number, nullable: The strike at which the total payout to option holders at expiry would be smallest
      - `totalOI` number: Open interest for that expiry
      - `pcRatio` number: Put/call ratio for that expiry
      - `canonicalUrl` string, uri: The matching page on xoomar.com
    - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `updatedAt` string, date-time: When the response was built; a few dated feeds give the date of their newest row instead
  - `source` 'xoomar.com'
  - `docs` string
  - `license` string: Data terms
  - `attribution` string
  - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `meta` object: Who publishes the data and how to credit it
    - `source` string: The publisher or publishers of the data, comma-separated
    - `sourceAttribution` string: The credit line to show wherever the data is displayed
    - `notice` string: Requests without a key only: the free key, app registration and the credit

## Other responses

- `404`: Unknown slug, ticker or country
- `429`: Rate limit: 10 requests a minute without a key, 30 with a free key

---

[API](https://skmtc.dev/xoomar/apis/xoomar-market-data-api.md) · [All operations](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/revisions/07b78401eaaa?raw)