List books
Returns books for active maturities admitted by the current policy, with market metadata and the top 3 ask/bid levels. Unlisted and past maturities are excluded, even when requested with ids. If a maturity leaves the policy, its books are hidden immediately, including books with existing offers. Supports filtering, sorting, and pagination; default sort is id ascending.
Query Parameters
Sort by comma-separated fields (id, ask, bid, maturity). Prefix a field with - for descending. Max 3 fields.
Inclusive upper maturity bound in unix seconds.
1 <= value <= 9007199254740991Inclusive lower maturity bound in unix seconds.
1 <= value <= 9007199254740991Exact maturity timestamp filter in unix seconds (comma-separated). Maximum 20 values.
Collateral token filter (comma-separated, matches any collateral). Maximum 20 values.
Loan token address filter (comma-separated). Maximum 20 values.
Chain ID filter (comma-separated). Currently accepts at most one chain id.
Market ID filter as a single comma-separated query parameter. Returns books for matching currently listed markets. Maximum 20 IDs.
Maximum number of items to return (max 20, default 10).
Opaque pagination cursor from a previous response.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v0/midnight/books?sort=-ask%2Cbid%2Cmaturity&maturity_lte=1764524800&maturity_gte=1761922800&maturities=1761922800%2C1764524800&collateral_tokens=0x34Cf890dB685FC536E05652FB41f02090c3fb751%2C0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078&loan_tokens=0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078%2C0x34Cf890dB685FC536E05652FB41f02090c3fb751&chain_ids=1&ids=0x12590ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9f67%2C0x22590ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9f68&limit=10&cursor=eyJzb3J0IjpbImlkIl0sImlkIjoiMHgxMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExIiwiYXNrIjoiMCIsImJpZCI6IjAiLCJtYXR1cml0eSI6MTc2MTkyMjgwMH0"{ "cursor": "eyJzb3J0IjpbImlkIl0sImlkIjoiMHgxMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExIiwiYXNrIjoiMCIsImJpZCI6IjAiLCJtYXR1cml0eSI6MTc2MTkyMjgwMH0", "data": [ { "market_id": "0x12590ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9f67", "chain_id": 1, "midnight": "0x2F7a3AA739ba5792Ce1b4eA046117f2C0095BCA6", "loan_token": "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078", "collaterals": [ { "token": "0x34Cf890dB685FC536E05652FB41f02090c3fb751", "lltv": "860000000000000000", "liquidation_cursor": "300000000000000000", "oracle": "0x45093658BE7f90B63D7c359e8f408e503c2D9401" } ], "maturity": 1761922800, "rcf_threshold": "0", "enter_gate": "0x0000000000000000000000000000000000000000", "liquidator_gate": "0x0000000000000000000000000000000000000000", "asks": [ { "tick": 495, "price": "500000000000000000", "units": "369216000000000000000000", "assets": "184608000000000000000000", "count": 5 } ], "bids": [ { "tick": 495, "price": "500000000000000000", "units": "369216000000000000000000", "assets": "184608000000000000000000", "count": 5 } ] } ]}{ "error": { "code": "VALIDATION_ERROR", "message": "Limit must be greater than 0.", "details": [ { "field": "limit", "issue": "Limit must be greater than 0." } ], "request_id": "req-123" }}{ "error": { "code": "VALIDATION_ERROR", "message": "Limit must be greater than 0.", "details": [ { "field": "limit", "issue": "Limit must be greater than 0." } ], "request_id": "req-123" }}