---
title: "GET /public/get_book_summary_by_currency"
method: GET
path: "/public/get_book_summary_by_currency"
tags: ["Market Data", "Public"]
---

# GET /public/get_book_summary_by_currency

`GET /public/get_book_summary_by_currency`

Retrieves summary information such as open interest, 24-hour volume, best bid/ask prices, last trade price, and other market statistics for all instruments in a given currency.

Results can be filtered by instrument kind (future, option, etc.). This method provides a quick overview of market activity across all instruments for a currency.

**Note:** For real-time updates, we recommend using the WebSocket subscription to `ticker.{instrument_name}.{interval}` instead of polling this endpoint.

[Try in API console](https://test.deribit.com/api_console?method=%2Fpublic%2Fget_book_summary_by_currency)

## Query parameters

- `currency` 'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR', required — Currency, i.e `"BTC"`, `"ETH"`, `"USDC"`
- `kind` 'future' | 'option' | 'spot' | 'future_combo' | 'option_combo' — Instrument kind: `"future"`, `"option"`, `"spot"`, `"future_combo"`, `"option_combo"`

## Response `200`

Success response

- PublicGetBookSummaryResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` BookSummary[], required
    - `instrument_name` string, required — Unique instrument identifier
    - `high` number, required — Price of the 24h highest trade
    - `low` number, required — Price of the 24h lowest trade, `null` if there weren't any trades
    - `base_currency` string, required — Base currency
    - `quote_currency` string, required — Quote currency
    - `volume` number, required — The total 24h traded volume (in base currency)
    - `bid_price` number, required — The current best bid price, `null` if there aren't any bids
    - `ask_price` number, required — The current best ask price, `null` if there aren't any asks
    - `mid_price` number, required — The average of the best bid and ask, `null` if there aren't any asks or bids
    - `mark_price` number, required — The current instrument market price
    - `last` number, required — The price of the latest trade, `null` if there weren't any trades
    - `open_interest` number, required — Optional (only for derivatives). The total amount of outstanding contracts in the corresponding amount units. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin.
    - `creation_timestamp` integer, required — The timestamp (milliseconds since the Unix epoch)
    - `estimated_delivery_price` number — Optional (only for derivatives). Estimated delivery price for the market.
    - `volume_usd` number — Volume in USD
    - `volume_notional` number — Volume in quote currency (futures and spots only)
    - `current_funding` number — Current instantaneous funding rate (perpetual only). Calculated as `(mark_price − index_price) / index_price` at this moment. This is the rate that would apply if a funding settlement occurred right now.
    - `funding_8h` number — Projected 8-hour funding rate for the current settlement window (perpetual only). This is the time-weighted accumulation of the funding rate since the last 8-hour settlement — i.e. the total rate that will be charged or received at the next settlement. `current_funding` shows the instantaneous rate; `funding_8h` shows what has accumulated toward the next settlement.
    - `mark_iv` number — (Only for option) implied volatility for mark price
    - `interest_rate` number — Interest rate used in implied volatility calculations (options only)
    - `underlying_index` string — Name of the underlying future, or `'index_price'` (options only)
    - `underlying_price` number — underlying price for implied volatility calculations (options only)
    - `price_change` number — 24-hour price change expressed as a percentage, `null` if there weren't any trades

---

[API](https://skmtc.net/deribit/apis/deribit-api-2.md) · [All operations](https://skmtc.net/deribit/apis/deribit-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deribit/deribit-api-2/revisions/8dfbbe9fdddf/schema)