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

# GetMarketConfigs

`POST /market_service.v1.MarketService/GetMarketConfigs`

Returns the full configuration for one market, resolved by numeric
 `market_id` or by `market_symbol`.

## 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

- MarketServiceV1GetMarketconfigRequest
  - `market` union, required — Market to look up, 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

- MarketServiceV1GetMarketconfigResponse
  - `marketConfig` BaseObjectsV1MarketConfig
    - `marketId` string, int64 — On-chain market identifier.
    - `marketName` string — Human-readable market name, such as `BTC-PERP`.
    - `minLeverage` number, float — Minimum leverage multiplier allowed when opening a position in this market.
    - `maxLeverage` number, float — Maximum leverage multiplier allowed when opening a position in this market.
    - `minTradeSize` number, float — Minimum position notional allowed when opening a position in this market, in quote asset units.
    - `maxTradeSize` number, float — Maximum position notional allowed when opening a position in this market, in quote asset units.
    - `tickDecimals` integer — Number of decimal places used to convert this market's raw on-chain prices to quote asset values.
    - `lotSize` number, float — Minimum position-size increment for this market, in the underlying asset's units.
    - `sizeDecimals` integer — Number of decimal places used to convert this market's raw on-chain size values to asset units.
    - `creator` string — Address that created this market.
    - `feeConfig` BaseObjectsV1FeeConfig
      - `marketId` string, int64 — On-chain Market ID
      - `tradeFeePct` number, float — Market Fee in basis points.
      - `maxEntitlement` number, float — Max Entitlement percentage with 2 decimals (5 = 0.05%, 500 = 5%)
      - `insuranceFundEntitlementPct` number, float — Insurance Fund Entitlement percentage with 2 decimals (5 = 0.05%, 500 = 5%)
      - `maxImbalance` number, float — Max Imbalance allowed in quote asset terms
    - `adlConfig` BaseObjectsV1ADLConfig
      - `maintenanceMarginRatio` number, float — Maintenance margin ratio as a whole-number percentage (e.g. `50` = 50%)
      - `seizureThreshold` number, float — Margin-ratio threshold below which a position becomes eligible for seizure, as a whole-number percentage (e.g. `66` ≈ 2/3 = 66%)
      - `adlThreshold` number, float — Margin-ratio threshold below which a position is scanned for ADL, as a whole-number percentage (e.g. `10` = 10%)
      - `shockFactor` number, float — Shock factor used in ADL shock-test simulations, as a whole-number percentage
      - `maxIfFractionAllowed` number, float — Maximum fraction of the insurance fund allowed to be spent on this market's close-outs, as a whole-number percentage
    - `maintenanceMarginRate` string — Raw configured maintenance margin rate as a whole-number percentage string (e.g. `"50"` = 50%).
    - `tradeFeePct` integer, nullable — Same value as `feeConfig.tradeFeePct`, kept for backwards compatibility.
    - `longRevenue` number, float, nullable — Cumulative per-unit revenue accrued to long positions in this market
    - `shortRevenue` number, float, nullable — Cumulative per-unit revenue accrued to short positions in this market

---

[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)