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

Last updated