---
title: "Query OTC Withdrawal Order List"
method: POST
path: "/withdraw/open/otc/api/order/list"
---

# Query OTC Withdrawal Order List

`POST /withdraw/open/otc/api/order/list`

Query OTC withdrawal orders in batch.

## Headers

- `X-GatePay-Certificate-ClientId` string, required
- `X-GatePay-Signature` string, required
- `X-GatePay-Timestamp` string, required
- `X-GatePay-Nonce` string, required

## Request body

- OrderListRequest
  - `status` string — Filter by order status.
  - `type` string — Filter by OTC order type.
  - `cryptoCurrency` string — Filter by cryptocurrency code.
  - `fiatCurrency` string — Filter by fiat currency code.
  - `startTime` string — Start of the query time range.
  - `endTime` string — End of the query time range.
  - `page` integer — Page number.
  - `pageSize` integer — Number of records per page.
  - `clientOrderId` string — Filter by merchant-defined order ID.

## Response `200`

Success

- OrderListResponse
  - `code` string — Business response code.
  - `status` string — Top-level request status.
  - `errorMessage` string — Error message when the request fails.
  - `data` object — Paged order list payload.
    - `page` integer — Current page number.
    - `pageSize` integer — Number of records per page.
    - `total` integer — Total number of matching records.
    - `data` OrderRecord[] — Order list data.
      - `orderId` string — Gate OTC order ID.
      - `status` string — Current order status.
      - `cryptoCurrency` string — Cryptocurrency code.
      - `fiatCurrency` string — Fiat currency code.
      - `cryptoAmount` string — Cryptocurrency amount.
      - `fiatAmount` string — Fiat amount.
      - `fiatRate` string — Settlement fiat rate.
      - `bankAccountId` string — Bank account ID associated with the order.
      - `clientOrderId` string — Merchant-defined order ID.
      - `type` string — OTC order type such as BUY or SELL.
      - `createTime` integer — Order creation timestamp.
      - `updateTime` integer — Last update timestamp.
      - `errMsg` string — Failure reason.
      - `tradeFee` string — Fee amount.
      - `finalFiatAmount` string — Final settled fiat amount.
      - `bankSlipInfo` string — Bank slip information.
      - `promCode` string — Promotion code passed when creating the order.

---

[API](https://skmtc.net/gate/apis/gatepay-otc-fiat-api.md) · [All operations](https://skmtc.net/gate/apis/gatepay-otc-fiat-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gate/gatepay-otc-fiat-api/versions/07cd4870de6a/schema)