List the markets with their risk figures

GET/v1/chains/{chain}/perpl/markets

curl -s "https://api.sonaintel.com/v1/chains/eip155:143/perpl/markets"

Response200

{
  "data": {
    "chain": "eip155:143",
    "coverage": [
      "perpl_snapshot_only",
      "perpl_bad_debt_is_floor"
    ],
    "items": [
      {
        "funding_rate": 0.00002,
        "insurance_fund_usd": "182983.039136",
        "long_oi": {
          "size": "8.28633",
          "usd": "686882.067222"
        },
        "maint_margin_fraction": 0.04,
        "mark": "82893.4",
        "max_leverage": 15,
        "name": "BTC Perp",
        "no_bad_debt_m10": false,
        "no_bad_debt_p10": false,
        "oracle": "82849.2",
        "oracle_age_s": 16,
        "oracle_gap_bps": 5.334994182200915,
        "perp_id": 1,
        "positions": 246,
        "scr_m10": 68.30880439256352,
        "scr_p10": 206.30567804874605,
        "short_oi": {
          "size": "8.28633",
          "usd": "686882.067222"
        },
        "status": 4,
        "symbol": "BTC"
      },
      {
        "funding_rate": 0.00001,
        "insurance_fund_usd": "22237.419694",
        "long_oi": {
          "size": "3543323",
          "usd": "90836.628428"
        },
        "maint_margin_fraction": 0.05,
        "mark": "0.025636",
        "max_leverage": 10,
        "name": "MON Perp",
        "no_bad_debt_m10": false,
        "no_bad_debt_p10": true,
        "oracle": "0.025649",
        "oracle_age_s": 17,
        "oracle_gap_bps": -5.06842372022301,
        "perp_id": 10,
        "positions": 98,
        "scr_m10": 217.8850359969972,
        "scr_p10": null,
        "short_oi": {
          "size": "3543323",
          "usd": "90836.628428"
        },
        "status": 4,
        "symbol": "MON"
      },
      {
        "funding_rate": 0,
        "insurance_fund_usd": "1000",
        "long_oi": {
          "size": "0",
          "usd": "0"
        },
        "maint_margin_fraction": 0.1,
        "mark": "289.565",
        "max_leverage": 5,
        "name": "TAO",
        "no_bad_debt_m10": true,
        "no_bad_debt_p10": true,
        "oracle": "289.596",
        "oracle_age_s": 15,
        "oracle_gap_bps": -1.070456774264838,
        "perp_id": 80,
        "positions": 0,
        "scr_m10": null,
        "scr_p10": null,
        "short_oi": {
          "size": "0",
          "usd": "0"
        },
        "status": 4,
        "symbol": "TAO"
      }
    ],
    "kind": "perpl_markets"
  },
  "links": {
    "self": "/v1/chains/eip155:143/perpl/markets"
  },
  "meta": {
    "as_of": {
      "eip155:143": {
        "block": 112777356,
        "block_time": "2026-10-12T14:21:57Z"
      }
    },
    "finality": "confirmed",
    "missing": [],
    "partial": false
  }
}

Call this for the headline table: one item per priced market, in ascending order of perp id. An item holds:

the identity: perp_id, symbol, name and the raw status;
mark and oracle prices, oracle_gap_bps (the mark against the oracle, null without an oracle price) and oracle_age_s, the seconds between the oracle's own timestamp and the snapshot time. A stale oracle blocks liquidations, so watch this one;
long_oi and short_oi with size in the base asset and usd at the mark. Perpl matches every trade, so both sides are equal;
positions, the number of open positions, and insurance_fund_usd;
funding_rate per funding interval, max_leverage and maint_margin_fraction;
scr_m10 and scr_p10: the Shock Cover Ratio when the mark falls or rises by 10%. A null ratio with no_bad_debt_m10 or no_bad_debt_p10 true means that the shock causes no bad debt. The stress route explains how it is computed.

Path parameters

Name	Type	Description
chainRequired	string	The chain, as a CAIP-2 chain ID. Only Monad, `eip155:143`, has Perpl data. A malformed ID answers 400 `invalid_id`, and any other well-formed ID, Ethereum's `eip155:1` included, answers 404 `unsupported_chain`.

Response

The answer, wrapped in the {data, meta, links} envelope. data.kind is perpl_markets. 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.
items	array of objects	One item per priced market, in ascending order of perp id.
kind	string	`perpl_markets`

Cost

1 credit. The time limit is 5 seconds.

Errors

Status	Code
400	`invalid_idinvalid_query`
404	`unsupported_chain`
429	`rate_limitedcredits_exhausted`
500	`internal`
503	`upstream_unavailable`
504	`deadline_exceeded`

400 for a query parameter (this route takes none) or a chain that is no CAIP-2 id, 404 unsupported_chain, 503 upstream_unavailable before the first snapshot or when the database does not answer, and 504 deadline_exceeded.

{ "data": { "chain": "eip155:143", "coverage": [ "perpl_snapshot_only", "perpl_bad_debt_is_floor" ], "items": [ { "funding_rate": 0.00002, "insurance_fund_usd": "182983.039136", "long_oi": { "size": "8.28633", "usd": "686882.067222" }, "maint_margin_fraction": 0.04, "mark": "82893.4", "max_leverage": 15, "name": "BTC Perp", "no_bad_debt_m10": false, "no_bad_debt_p10": false, "oracle": "82849.2", "oracle_age_s": 16, "oracle_gap_bps": 5.334994182200915, "perp_id": 1, "positions": 246, "scr_m10": 68.30880439256352, "scr_p10": 206.30567804874605, "short_oi": { "size": "8.28633", "usd": "686882.067222" }, "status": 4, "symbol": "BTC" }, { "funding_rate": 0.00001, "insurance_fund_usd": "22237.419694", "long_oi": { "size": "3543323", "usd": "90836.628428" }, "maint_margin_fraction": 0.05, "mark": "0.025636", "max_leverage": 10, "name": "MON Perp", "no_bad_debt_m10": false, "no_bad_debt_p10": true, "oracle": "0.025649", "oracle_age_s": 17, "oracle_gap_bps": -5.06842372022301, "perp_id": 10, "positions": 98, "scr_m10": 217.8850359969972, "scr_p10": null, "short_oi": { "size": "3543323", "usd": "90836.628428" }, "status": 4, "symbol": "MON" }, { "funding_rate": 0, "insurance_fund_usd": "1000", "long_oi": { "size": "0", "usd": "0" }, "maint_margin_fraction": 0.1, "mark": "289.565", "max_leverage": 5, "name": "TAO", "no_bad_debt_m10": true, "no_bad_debt_p10": true, "oracle": "289.596", "oracle_age_s": 15, "oracle_gap_bps": -1.070456774264838, "perp_id": 80, "positions": 0, "scr_m10": null, "scr_p10": null, "short_oi": { "size": "0", "usd": "0" }, "status": 4, "symbol": "TAO" } ], "kind": "perpl_markets" }, "links": { "self": "/v1/chains/eip155:143/perpl/markets" }, "meta": { "as_of": { "eip155:143": { "block": 112777356, "block_time": "2026-10-12T14:21:57Z" } }, "finality": "confirmed", "missing": [], "partial": false } }

Name

Type

Description

chainRequired

string

The chain, as a CAIP-2 chain ID. Only Monad, eip155:143, has Perpl data. A malformed ID answers 400 invalid_id, and any other well-formed ID, Ethereum's eip155:1 included, answers 404 unsupported_chain.

Response

The answer, wrapped in the {data, meta, links} envelope. data.kind is perpl_markets. 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.
items	array of objects	One item per priced market, in ascending order of perp id.
kind	string	`perpl_markets`

Errors

Status	Code
400	`invalid_idinvalid_query`
404	`unsupported_chain`
429	`rate_limitedcredits_exhausted`
500	`internal`
503	`upstream_unavailable`
504	`deadline_exceeded`

Path parameters#

Response#

Cost#

Errors#

Path parameters#

Response#

Cost#

Errors#

Path parameters

Response

Cost

Errors

Path parameters

Response

Cost

Errors