Read the order book - Pesa

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

curl "https://api.pesapay.xyz/api/v1/orderbook?rail=wise&currency=VND&direction=onramp"

[
  {
    "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

curl "https://api.pesapay.xyz/api/v1/orderbook/summary"

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

One provider

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

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 for every field.