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" }}GETList Midnight offer groups for a user
Cursor-paginated list of a user's offer groups with nested offers. The statuses filter accepts one or more lifecycle states with OR semantics.
GETGet book
Returns one active book whose maturity is admitted by the current policy, with market metadata and both sides.