Docs

Get market positions health

Private API

Cursor-paginated LTV of every position with debt in one listed Morpho Blue market, for polling liquidation risk.


Available on the private API only. Request an API key.

Freshness. ltv_computed_at is the LTV evaluation time, not the age of every input. The endpoint evaluates indexed balances with accrued market state and an oracle observation cached for up to five seconds; the market observation has its own block timestamp. Uninitialized inputs and required-read failures return 503. Responses are never cached.

Accuracy. Debt is rounded down; positions whose debt rounds to zero are omitted. Threshold membership uses the indexed borrow-shares/collateral ratio, so a returned ltv_wad can be just below ltv_wad_gte after rounding. Re-check positions onchain before acting.

Pagination. Each page uses current inputs; a walk can span updates. A position that starts matching before the cursor is seen on the next walk, not this one.

Coverage. Listed markets only (404 otherwise). A known missing oracle price returns an empty page, not an error.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Path Parameters

market-selector*string

Selector formatted as <chain_id>:<market_id>. Example: 1:0xfff1970c0ffae288764186fbb38a9171a17e98676744a1e345809cb8b9e73342.

Format<chain_id>:<market_id>

Query Parameters

ltv_wad_gte?string

Inclusive LTV threshold (1e18 = 100%). Membership is ratio-based; returned rounded ltv_wad can be just below this threshold. Omit to return every position with debt.

Match^\d{1,78}$
limit?integer

Maximum number of positions to return. Default 100, maximum 1000.

Range1 <= value <= 1000
Default100
cursor?string

Opaque pagination cursor from the previous page. It is bound to the market and ltv_wad_gte.

Length1 <= length <= 4096

Response Body

application/json

curl -X GET "https://example.com/v0/blue/markets/1:0xfff1970c0ffae288764186fbb38a9171a17e98676744a1e345809cb8b9e73342/positions/health"
{  "cursor": "string",  "data": [    {      "borrow_shares": "string",      "chain_id": 0,      "collateral_assets": "string",      "ltv_wad": "string",      "market_id": "string",      "user_address": "string"    }  ],  "last_indexed_block": "string",  "ltv_computed_at": 0,  "oracle_price_block": "string"}