---
title: "GetMarketSummary"
method: POST
path: "/market_service.v1.MarketService/GetMarketSummary"
tags: ["Markets"]
---

# GetMarketSummary

`POST /market_service.v1.MarketService/GetMarketSummary`

Returns a live trading summary for one market: open interest, 24h
 price change and volume, executable order-book depth at the
 current price, rebate indicators, and whether the market is
 currently open for trading.
 
 If computing executable depth fails internally, the
 request still succeeds with `executableDepth` left at zero rather
 than failing outright.

## Headers

- `Connect-Protocol-Version` 1, required — Define the version of the Connect protocol. If omitted, use 1.
- `Connect-Timeout-Ms` number — Define the timeout, in ms

## Request body

- MarketServiceV1GetMarketSummaryRequest
  - `market` union, required — Market to summarize, by `market_id` or `market_symbol`.
    - object
      - `marketId` string, int64, required
    - object
      - `marketSymbol` BaseObjectsV1MarketSymbol, required
        - `assetSymbol` string — Underlying asset symbol, e.g. `"BTC"`. Matched case-insensitively and trimmed.
        - `quoteSymbol` string — Quote symbol, e.g. `"PERP"`. Technically optional, but omitting it looks up a market named exactly by `assetSymbol` alone (e.g. `"BTC"`) rather than `"BTC-PERP"`, which will not resolve to any real market. In practice, always set this.

## Response `200`

Success

- MarketServiceV1GetMarketSummaryResponse
  - `marketSummary` BaseObjectsV1MarketSummary
    - `marketId` string, int64 — On-chain market identifier.
    - `marketName` string — Human-readable market name, such as `BTC-PERP`.
    - `openInterest` number, float — Total open position size in this market, in the underlying asset's units.
    - `priceChange24h` number, float — Price change over the last 24 hours, as a percentage.
    - `volume24h` number, float — Total traded notional in the last 24 hours, in quote asset terms.
    - `executableDepth` BaseObjectsV1ExecutableDepth
      - `short` number, double — Deprecated. Truncated to a whole number; use `shortDouble` instead.
      - `long` number, double — Deprecated. Truncated to a whole number; use `longDouble` instead.
      - `shortDouble` number, double — Executable short-side depth at the current price, in quote asset units.
      - `longDouble` number, double — Executable long-side depth at the current price, in quote asset units.
    - `marketType` string — Market category/classification tag used for grouping markets.
    - `price` number, double — Current oracle price for this market, in quote asset terms.
    - `rebateIndicatorLong` number, double — Total rebate amount paid to long-side takers in the last 24 hours, in quote asset terms.
    - `rebateIndicatorShort` number, double — Total rebate amount paid to short-side takers in the last 24 hours, in quote asset terms.
    - `isOpen` boolean — Whether the market is currently open for trading, from the pricing service's market-hours schedule

---

[API](https://skmtc.net/fairground/apis/fairground-fi-api.md) · [All operations](https://skmtc.net/fairground/apis/fairground-fi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fairground/fairground-fi-api/versions/be66e6dc0ac0/schema)