> ## Documentation Index
> Fetch the complete documentation index at: https://getequity.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch the order book

> Aggregate demand, cover and the demand ladder

The demand behind an offering: total demand, cover against the offer size, the number of bids,
and the ladder of demand by level. Read-only, and the same for both integration models — this
is what you show a user before they bid.

Each tranche of a combined offering is **its own book**. Omit `tranche` and the offering
answers for its default slice, listing the rest in `offering.tranches` for discovery.

<ParamField path="id" type="string" required>
  The id of the offering.
</ParamField>

<ParamField query="tranche" type="string">
  Which slice of a combined offering to answer for.
</ParamField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "message": "Order book fetched successfully",
    "data": {
      "offering": {
        "raise_amount": 40000000,
        "offering_status": "OPEN",
        "offer_closes_at": "2026-09-30T15:00:00.000Z",
        "tranche": "retail",
        "tranches": [
          { "key": "retail", "name": "Retail", "size": 40000000 },
          { "key": "institutional", "name": "Institutional", "size": 60000000 }
        ]
      },
      "summary": {
        "total_demand": 50000000,
        "cover_ratio": 1.25,
        "commitment_count": 34,
        "strike_bid_amount": 0
      },
      "ladder": [
        { "level": 19, "demand": 30000000, "cumulative": 30000000 },
        { "level": 19.5, "demand": 20000000, "cumulative": 50000000 }
      ]
    }
  }
  ```
</ResponseExample>