Get one market in full
/v1/chains/{chain}/perpl/markets/{market}Call this for one market. The item has every field of the market list, and four more groups:
initial_margin_fraction: the share of notional that a new position must post, 100 divided by the contract's initial-margin divisor.max_leverageis its inverse.funding_interval: the contract'sgetFundingInterval()value, 8571 on Monad. The unit is not stated in the contract's interface. Sona reads it as blocks, because the funding start is a block number.funding_rate_clamp: the largest absolute funding rate per interval, as a fraction.ref_price_max_age_s: the age after which the exchange stops trusting a reference price.liquidation: how a liquidation's proceeds are split, as fractions:insurance,user(the liquidated trader) andprotocol, plusbtl, the settings that the contract keeps for liquidations below a price threshold (price_threshold, the shares ofinsurance,user,buyerandprotocol, andrestrict_buyers). Thebtlnames are the contract's.
{market} is a symbol in any case or a perp id.
Path parameters
| Name | Type | Description |
|---|---|---|
chainRequired | string | The chain, as a CAIP-2 chain ID. Only Monad, |
marketRequired | string | A market, as its symbol in any case ( |
Response
The answer, wrapped in the {data, meta, links} envelope. data.kind is perpl_market. meta.as_of names the snapshot block.
| Field | Type | Description |
|---|---|---|
| chain | string | The CAIP-2 id of the chain. |
| coverage | array of strings | The codes of the limits that apply to this answer, in a fixed order. It is empty when none applies. The status route explains each code. |
| funding_interval | integer | The contract's |
| funding_rate | number | The funding rate of one funding interval as a fraction of notional. |
| funding_rate_clamp | number | The largest absolute funding rate per interval, as a fraction. |
| initial_margin_fraction | number | The share of notional that a new position must post. |
| insurance_fund_usd | string | An amount in US dollars as a decimal string with up to 6 decimals and no trailing zeros. It can be negative for a PnL. |
| kind | string | perpl_market |
| liquidation | object | |
| long_oi | object | |
| maint_margin_fraction | number | The share of notional that must stay as margin. |
| mark | string | A price, or a size in the base asset, as a decimal string with no trailing zeros. Values read straight from the chain are exact, and computed values have at most 15 significant digits. |
| max_leverage | number | The largest leverage that a new position may take. |
| name | string | The name that the contract gives the market, such as |
| no_bad_debt_m10 | boolean | Whether a fall of 10% causes no bad debt. |
| no_bad_debt_p10 | boolean | Whether a rise of 10% causes no bad debt. |
| oracle | string | A price, or a size in the base asset, as a decimal string with no trailing zeros. Values read straight from the chain are exact, and computed values have at most 15 significant digits. |
| oracle_age_s | integer | The whole seconds between the oracle's own timestamp and the snapshot time. |
| oracle_gap_bps | number | null | The mark against the oracle in basis points, positive when the mark is above. |
| perp_id | integer | The id of the perp on the exchange. |
| positions | integer | The number of open positions. |
| ref_price_max_age_s | integer | The age in seconds after which a reference price is no longer trusted. |
| scr_m10 | number | null | The Shock Cover Ratio when the mark falls by 10%, |
| scr_p10 | number | null | The Shock Cover Ratio when the mark rises by 10%, |
| short_oi | object | |
| status | integer | The raw status number from the contract. |
| symbol | string | The symbol, such as |
Cost
1 credit. The time limit is 5 seconds.
Errors
| Status | Code |
|---|---|
| 400 | invalid_idinvalid_query |
| 404 | not_foundunsupported_chain |
| 429 | rate_limitedcredits_exhausted |
| 500 | internal |
| 503 | upstream_unavailable |
| 504 | deadline_exceeded |
404 not_found for an unknown market or one without a mark price, 400 invalid_id for a malformed market and invalid_query for a query parameter, 404 unsupported_chain, 503 and 504 as on the list.