configs: Fetch Market and Contract Configuration Data

The configs query returns all coin definitions and contract configurations available on the exchange. Use this response to look up contract IDs for the a field in orders, determine tick and step sizes for price/quantity validation, read decimal scales to convert raw values to display values, and inspect leverage tiers for margin calculations. Because this data only changes when new contracts are listed, you should cache it locally and refresh infrequently.

Request

{"type": "configs", "marketDeployerId": 0}

string

required

Must be "configs".

integer

Filter results by market deployer. Use 0 or omit to return configuration for all deployers. Pass a positive integer to restrict results to a specific deployer.

Response

{
  "type": "configs",
  "marketDeployerIdFilter": 0,
  "coins": [
    {
      "coinId": 1,
      "name": "USDT1",
      "szDecimals": 6,
      "isMargin": true,
      "status": "Active"
    }
  ],
  "contracts": [
    {
      "contractId": 1,
      "marketId": 1,
      "marketDeployerId": 1,
      "name": "SOL1",
      "baseCoinId": 1,
      "quoteCoinId": 1,
      "tickSize": "1",
      "stepSize": "1",
      "priceScale": 1,
      "qtyScale": 1,
      "defaultLeverage": "10",
      "fundingInterval": 3600,
      "minTradeNtl": "1",
      "status": "Active",
      "tiers": [
        {
          "upperBound": "9223372036854775807",
          "maxLeverage": "100",
          "imBps": 100,
          "mmBps": 100
        }
      ]
    }
  ]
}

Contract Fields

integer

The unique contract identifier. Use this as the a field when placing, modifying, or canceling orders.

string

Human-readable contract name (e.g. "SOL1").

string

Minimum price movement expressed as a raw integer string. All order prices must be multiples of this value.

string

Minimum quantity movement expressed as a raw integer string. All order quantities must be multiples of this value.

integer

Decimal exponent for prices. Divide any raw price by 10^priceScale to get the human-readable display value.

integer

Decimal exponent for quantities. Divide any raw quantity by 10^qtyScale to get the human-readable display value.

string

The initial leverage applied to new positions on this contract.

integer

Funding settlement interval in seconds (e.g. 3600 = hourly).

string

Minimum notional value per trade, expressed as a raw integer string.

Tier[]

Leverage tier schedule for this contract. Each tier applies up to upperBound position size.

Show Tier fields

string

Maximum position size (raw) to which this tier applies. The highest tier uses "9223372036854775807" (max int64) as a sentinel for “no upper limit.”

string

Maximum leverage allowed for positions up to upperBound.

integer

Initial margin rate in basis points (e.g. 100 = 1%).

integer

Maintenance margin rate in basis points. Positions are liquidated when equity falls below this threshold.

Overview

Market Data

Account

Orders

configs: Fetch Market and Contract Configuration Data

Request

Response

Contract Fields

​Request

​Response

​Contract Fields

Request

Response

Contract Fields