Show how concentrated positions, volume and liquidators are

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

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

Response200

{
  "data": {
    "chain": "eip155:143",
    "coverage": [
      "perpl_snapshot_only"
    ],
    "keepers": {
      "first_block": 54774510,
      "items": [
        {
          "address": "0xb3b0f0a1745ae45224930d85e1fcc7f731d374a3",
          "liquidations": 1893,
          "share": 0.5186
        },
        {
          "address": "0x8dea7a0184076c4ca4e877f39357bfaf32aa9f33",
          "liquidations": 1757,
          "share": 0.4814
        }
      ],
      "last_block": 112770000,
      "total": 3650
    },
    "kind": "perpl_concentration",
    "markets": [
      {
        "long_notional_usd": "686882.067222",
        "perp_id": 1,
        "positions": 246,
        "short_notional_usd": "686882.067222",
        "symbol": "BTC",
        "top1": 0.19477259534679403,
        "top10": 0.6476793707226236,
        "top5": 0.5191037528073343,
        "top_accounts": [
          {
            "account_id": 4848,
            "address": "0x7e842a5d75249257036d6bde1887874131e77ad1",
            "notional_usd": "267571.60586",
            "positions": 1,
            "share": 0.19477259534679403
          },
          {
            "account_id": 2159,
            "address": null,
            "notional_usd": "142584.93734",
            "positions": 1,
            "share": 0.10379142515444108
          }
        ],
        "total_notional_usd": "1373764.134444"
      },
      {
        "long_notional_usd": "90836.628428",
        "perp_id": 10,
        "positions": 98,
        "short_notional_usd": "90836.628428",
        "symbol": "MON",
        "top1": 0.16503829879466253,
        "top10": 0.8418038660319705,
        "top5": 0.6195281942967096,
        "top_accounts": [
          {
            "account_id": 4159,
            "address": null,
            "notional_usd": "29983.045248",
            "positions": 1,
            "share": 0.16503829879466253
          },
          {
            "account_id": 5098,
            "address": null,
            "notional_usd": "27701.979604",
            "positions": 1,
            "share": 0.15248242962891048
          }
        ],
        "total_notional_usd": "181673.256856"
      }
    ],
    "overall": {
      "accounts": 453,
      "top1": 0.1691687715915103,
      "top10": 0.5828521917998443,
      "top5": 0.4475398070136747,
      "top_accounts": [
        {
          "account_id": 4848,
          "address": "0x7e842a5d75249257036d6bde1887874131e77ad1",
          "notional_usd": "523541.28026",
          "positions": 2,
          "share": 0.1691687715915103
        },
        {
          "account_id": 2159,
          "address": null,
          "notional_usd": "280291.53542",
          "positions": 2,
          "share": 0.09056893223577664
        }
      ],
      "total_notional_usd": "3094786.79389"
    },
    "volume": {
      "all": {
        "rows": 5457,
        "top1": 0.094,
        "top10": 0.43,
        "top10_volume_usd": "263363471.8075",
        "top5": 0.301,
        "total_volume_usd": "612473190.25"
      },
      "day": {
        "rows": 1186,
        "top1": 0.182,
        "top10": 0.71,
        "top10_volume_usd": "5985962.555",
        "top5": 0.527,
        "total_volume_usd": "8431220.5"
      }
    }
  },
  "links": {
    "self": "/v1/chains/eip155:143/perpl/concentration"
  },
  "meta": {
    "as_of": {
      "eip155:143": {
        "block": 112777356,
        "block_time": "2026-10-12T14:21:57Z"
      }
    },
    "finality": "confirmed",
    "missing": [],
    "partial": false
  }
}

Call this to see who holds the risk. The record has four parts besides kind, chain and coverage:

markets: per priced market, in ascending order of perp id, the number of positions, the long, short and total notional at the mark, and top1, top5 and top10, the share of the market's total notional that the largest 1, 5 and 10 accounts hold. The total is two-sided: the long notional plus the short notional, which is the total_notional_usd of the same item, so a share can be recomputed from the response. top_accounts lists up to 10 accounts, the largest first, with account_id, the wallet address (null when Sona has not seen it yet), the notional, the share and the number of positions.
overall: the same over all markets, where an account's notional is added up across markets, with the number of accounts that hold any position.
volume: the share of the trading volume that the top 1, 5 and 10 accounts hold on Perpl's public leaderboard, for the last day (day) and for all time (all). rows is the number of leaderboard rows, total_volume_usd their volume (the leaderboard counts both sides of each trade) and top10_volume_usd the volume of the 10 largest. A period is null when the leaderboard could not be read, and coverage has perpl_leaderboard_unavailable.
keepers: the liquidators. The items are the 10 addresses that sent the most liquidation transactions, with their count and their share of all total liquidations indexed, between first_block and last_block. total is 0 and items is empty before any liquidation is indexed.

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_concentration. 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.
keepers	object
kind	string	`perpl_concentration`
markets	array of objects
overall	object
volume	object

Cost

2 credits. 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 and 504 as elsewhere.

{ "data": { "chain": "eip155:143", "coverage": [ "perpl_snapshot_only" ], "keepers": { "first_block": 54774510, "items": [ { "address": "0xb3b0f0a1745ae45224930d85e1fcc7f731d374a3", "liquidations": 1893, "share": 0.5186 }, { "address": "0x8dea7a0184076c4ca4e877f39357bfaf32aa9f33", "liquidations": 1757, "share": 0.4814 } ], "last_block": 112770000, "total": 3650 }, "kind": "perpl_concentration", "markets": [ { "long_notional_usd": "686882.067222", "perp_id": 1, "positions": 246, "short_notional_usd": "686882.067222", "symbol": "BTC", "top1": 0.19477259534679403, "top10": 0.6476793707226236, "top5": 0.5191037528073343, "top_accounts": [ { "account_id": 4848, "address": "0x7e842a5d75249257036d6bde1887874131e77ad1", "notional_usd": "267571.60586", "positions": 1, "share": 0.19477259534679403 }, { "account_id": 2159, "address": null, "notional_usd": "142584.93734", "positions": 1, "share": 0.10379142515444108 } ], "total_notional_usd": "1373764.134444" }, { "long_notional_usd": "90836.628428", "perp_id": 10, "positions": 98, "short_notional_usd": "90836.628428", "symbol": "MON", "top1": 0.16503829879466253, "top10": 0.8418038660319705, "top5": 0.6195281942967096, "top_accounts": [ { "account_id": 4159, "address": null, "notional_usd": "29983.045248", "positions": 1, "share": 0.16503829879466253 }, { "account_id": 5098, "address": null, "notional_usd": "27701.979604", "positions": 1, "share": 0.15248242962891048 } ], "total_notional_usd": "181673.256856" } ], "overall": { "accounts": 453, "top1": 0.1691687715915103, "top10": 0.5828521917998443, "top5": 0.4475398070136747, "top_accounts": [ { "account_id": 4848, "address": "0x7e842a5d75249257036d6bde1887874131e77ad1", "notional_usd": "523541.28026", "positions": 2, "share": 0.1691687715915103 }, { "account_id": 2159, "address": null, "notional_usd": "280291.53542", "positions": 2, "share": 0.09056893223577664 } ], "total_notional_usd": "3094786.79389" }, "volume": { "all": { "rows": 5457, "top1": 0.094, "top10": 0.43, "top10_volume_usd": "263363471.8075", "top5": 0.301, "total_volume_usd": "612473190.25" }, "day": { "rows": 1186, "top1": 0.182, "top10": 0.71, "top10_volume_usd": "5985962.555", "top5": 0.527, "total_volume_usd": "8431220.5" } } }, "links": { "self": "/v1/chains/eip155:143/perpl/concentration" }, "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_concentration. 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.
keepers	object
kind	string	`perpl_concentration`
markets	array of objects
overall	object
volume	object

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