---
title: "GET /v2/orderbook"
method: GET
path: "/v2/orderbook"
tags: ["Orderbook V2"]
---

# GET /v2/orderbook

`GET /v2/orderbook`

Fetch the denormalized orderbook for a fiat currency, including maker details when available. Set publicOnly=true to exclude whitelist-gated deposits.

## Query parameters

- `currency` string, required — Fiat currency code
- `paymentPlatform` string — Optional payment platform filter
- `sortBy` 'price' | 'available' | 'limits' | 'apr' — Sort field
- `sortDirection` 'asc' | 'desc' — Optional sort direction. Defaults to asc for price and desc for available/limits/apr.
- `chainId` integer, nullable — Destination chain ID
- `token` string — Destination token address
- `publicOnly` boolean — When true, exclude whitelist-gated deposits from the orderbook response
- `limit` integer — Maximum number of orderbook rows to return
- `offset` integer, nullable — Number of matching rows to skip before returning entries
- `amount` string — Optional requested USDC amount used to filter rows by min, max, and available limits
- `showSmallOrders` boolean — When true, include rows whose available notional value is below the dust threshold
- `hideExtremeSpread` boolean — When true, hide rows whose absolute spread exceeds the extreme-spread threshold
- `sellerAutomatedRelease` 'include' | 'exclude' | 'only' — Seller automated release filter. include returns all rows, exclude omits SAR rows, only returns SAR rows.

## Response `200`

Success

- object
  - `success` boolean, required
  - `message` string, required
  - `responseObject` object
    - `chainId` integer, required
    - `token` string, required
    - `currency` string, required
    - `paymentPlatform` string, nullable, required
    - `publicOnly` boolean, required — Whether whitelist-gated deposits were excluded from this response
    - `sortBy` 'price' | 'available' | 'limits' | 'apr', required
    - `sortDirection` 'asc' | 'desc', required
    - `sellerAutomatedRelease` 'include' | 'exclude' | 'only', required
    - `internalDetailsIncluded` boolean, required
    - `generatedAt` string, date-time, required — Timestamp when curator generated the current orderbook snapshot. Responses may be served from cache and can reflect data from up to 60 seconds earlier.
    - `entries` object[], required
      - `chainId` integer, required
      - `depositIdOnContract` string, required
      - `depositId` string, required
      - `escrowAddress` string, required
      - `depositor` string, required
      - `token` string, required
      - `paymentMethodHash` string, required
      - `paymentPlatform` string, required
      - `currencyCode` string, required
      - `currency` string, required
      - `price` string, required
      - `apr` number, nullable, required
      - `spread` number, nullable, required
      - `conversionRate` string, required
      - `rateManagerId` string, nullable, required
      - `availableTokenAmount` string, required
      - `availableFiatAmount` string, required
      - `intentAmountMin` string, required
      - `intentAmountMax` string, required
      - `minFiatSupported` string, required
      - `maxFiatSupported` string, required
      - `payeeDetailsHash` string, required
      - `successRateBps` integer, required
      - `feeBps` integer, required — ZKP2P protocol fee in basis points, deducted from the delivered token amount at fulfillment. Clients can use it to show net output without recomputing it. Net token received = availableTokenAmount * (10000 - feeBps) / 10000. 0 when fee enforcement is disabled.
      - `sellerAutomatedReleaseAvailable` boolean, required
      - `sellerAutomatedReleaseEnabled` boolean, required — Whether seller automated release (autopilot) is enabled for this deposit's maker (the seller credential is active), independent of current liveness. sellerAutomatedReleaseAvailable is the stricter live check (active AND not expired).
      - `updatedAt` string, required
      - `maker` object
        - `id` number, required
        - `processorName` string, required
        - `offchainId` string, required
        - `telegramUsername` string, nullable
        - `hashedOnchainId` string, required
        - `isBusiness` boolean
        - `revoked` boolean
        - `metadata` object, nullable
        - `createdAt` string, date-time, required
  - `statusCode` number, required
  - `errorCode` string

---

[API](https://skmtc.dev/peer/apis/swagger-api.md) · [All operations](https://skmtc.dev/peer/apis/swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/peer/swagger-api/revisions/d5fcf4abb61a/schema)