Docs

List book takeable offers

GET
/v0/midnight/books/{market-id}/{side}/takeable-offers

Returns up to 1,000 executable offers for one book side, sorted best price first. This endpoint is not paginated and does not accept a limit or cursor.

Path Parameters

side?string

Book side to query (asks or bids).

Value in

  • "asks"
  • "bids"
market-id?string

Market ID whose book side to read (market_id in responses).

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v0/midnight/books/0xcc9418ea594c6e658650aedd205ce4544b266b69493f56fd2adc65c14bd06738/asks/takeable-offers"
{  "data": [    {      "market_id": "0x25690ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9f67",      "units": "369216000000000000000000",      "offer": {        "market": {          "chain_id": 8453,          "midnight": "0x2F7a3AA739ba5792Ce1b4eA046117f2C0095BCA6",          "loan_token": "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078",          "collaterals": [            {              "token": "0x34Cf890dB685FC536E05652FB41f02090c3fb751",              "lltv": "860000000000000000",              "liquidation_cursor": "300000000000000000",              "oracle": "0x45093658BE7f90B63D7c359e8f408e503c2D9401"            }          ],          "maturity": 1761922799,          "rcf_threshold": "0",          "enter_gate": "0x0000000000000000000000000000000000000000",          "liquidator_gate": "0x0000000000000000000000000000000000000000"        },        "buy": false,        "maker": "0x7b093658BE7f90B63D7c359e8f408e503c2D9401",        "max_units": "369216000000000000000000",        "start": 1761922790,        "expiry": 1761922799,        "tick": 495,        "group": "0x000000000000000000000000000000000000000000000000000000000008b8f4",        "callback": "0x0000000000000000000000000000000000000000",        "callback_data": "0x",        "receiver_if_maker_is_seller": "0x7b093658BE7f90B63D7c359e8f408e503c2D9401",        "ratifier": "0x0000000000000000000000000000000000000002",        "reduce_only": false,        "max_assets": "0",        "continuous_fee_cap": "115792089237316195423570985008687907853269984665640564039457584007913129639935"      },      "ratifier_data": "0x000000000000000000000000000000000000000000000000000000000000001b12121212121212121212121212121212121212121212121212121212121212123434343434343434343434343434343434343434343434343434343434343434",      "warning": null    }  ]}
{  "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"  }}