Search
K
Comment on page

Markets Configuration

The configuration for each market on Carbon can be viewed at the following API / RPC endpoint: https://api.carbon.network/carbon/market/v1/markets
The following list describes how each parameter is used:
  • "name": The unique ID for the market
  • "display_name": A human-friendly name for the market
  • "description": The description for the market
  • "market_type": The type of market, either spot or futures
  • "base": The denom of the base token for the market
  • "quote": The denom of the quote token for the market
  • "base_precision": The precision of the base token for the market
  • "quote_precision": The precision of the quote token for the market
  • "lot_size": The lot size for the market in base token quantity - order quantities must be a multiple of this value
  • "tick_size": The tick size for the market in quote token - order price must be a multiple of this value
  • "min_quantity": The minimum order quantity
  • "risk_step_size": The risk step size shows when at which the required initial / maintenance margin (futures only)
  • "initial_margin_base": The margin required for opening a position (of qty < risk_step_size)
  • "initial_margin_step": The additional margin required each time a position increases in size by risk_step_size
  • "maintenance_margin_ratio": The ratio between maintenance and initial margin requirments
  • "max_liquidation_order_ticket": The maximum size of each quote made by the liquidation engine
  • "max_liquidation_order_duration": The maximum duration the liquidation engine will maintain a quote before proceeding to ADL
  • "impact_size": The quantity of orders used to calculate the impact price (used in mark price calculations)
  • "mark_price_band": The band in bps at which the mark price is bound to (around the index price) during fair price marking - for e.g. a value of 500 means that the mark price cannot never be more than 10% away from the index price
  • "last_price_protected_band": The band in bps at which the mark price is bound to (around the last traded price) during last price protected marking - for e.g. a value of 500 means that the mark price cannot never be more than 10% away from the last price
  • "index_oracle_id": The ID for the oracle for this market (futures only),
  • "expiry_time": The time where this market will expire and execute settlement of all contracts (dated futures only)
  • "is_active": true if the market is enabled, false if it is disabled, meaning that positions are unaffected but trading cannot be done
  • "is_settled": true if this is a dated futures market that has completed the settlement process
  • "closed_block_height": The block height at which the settlement process for the market concluded
  • "trading_bandwidth": The band in bps at which trading can occur (around the mark price) - trades that would have executed outside this band is cancelled instead - for e.g. a value of 50 means that trades can never execute more than 1% away from the mark price
  • "created_block_height": The block height where this market was created at