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

# Read the order book

> List LP offers, market depth, provider stats and order status.

The order book API is public and read-only. Offers come from on-chain rail terms (rate, currency) and each LP's free escrow balance.

## List offers

```bash theme={null}
curl "https://api.pesapay.xyz/api/v1/orderbook?rail=wise&currency=VND&direction=onramp"
```

```json theme={null}
[
  {
    "provider": "GD7I...",
    "direction": "onramp",
    "availableUsdc": "1500.0000000",
    "lockedUsdc": "20.0000000",
    "acceptedRails": ["wise"],
    "paymentHandles": {},
    "trustTier": 1,
    "feeRateBps": 0,
    "rate": "26150",
    "currency": "VND",
    "minAmount": "1",
    "maxAmount": "20",
    "completedOrders": 42,
    "avgFulfillmentSeconds": 310,
    "lastActiveAt": "2026-10-16T08:12:00Z"
  }
]
```

Filters: `rail`, `currency`, `direction`, `minAmount`, `maxAmount`.

Only offer a rail the LP has terms for. An order on a rail with no registered payee cannot settle, and the user would find out only after paying.

## Depth

```bash theme={null}
curl "https://api.pesapay.xyz/api/v1/orderbook/summary"
```

Returns `totalAvailableUsdc`, `totalLockedUsdc`, `offerCount`, and the same per rail in `byRail`.

## One provider

```bash theme={null}
curl "https://api.pesapay.xyz/api/v1/providers/GD7I..."
```

Returns available and locked USDC, completed orders, average fulfilment time, accepted rails and active orders.

## One order

```bash theme={null}
curl "https://api.pesapay.xyz/api/v1/intents/<intent hash>"
```

Returns the order's parties, rail, currency, USDC and fiat amounts, status, creation and expiry times, and, once settled, the nullifier and transaction hash.

See the [order book API reference](/api-reference/order-book) for every field.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.