---
title: "Query OTC Recharge Order List"
method: GET
path: "/open/otc/api/recharge/list"
---

# Query OTC Recharge Order List

`GET /open/otc/api/recharge/list`

List OTC recharge orders. `startTime` and `endTime` are required.

## Query parameters

- `status` 'PENDING' | 'PROCESSING' | 'DONE' | 'CANCEL' | 'ERROR'
- `startTime` integer, required
- `endTime` integer, required
- `page` integer
- `count` integer

## Headers

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

## Response `200`

Success

- OtcRechargeListResponse
  - `code` string — Business response code.
  - `status` string — Top-level request status.
  - `errorMessage` string — Error message when the request fails.
  - `data` object
    - `total` integer — Total number of matching records.
    - `page` integer — Current page number.
    - `list` OtcRechargeOrder[] — Order list data.
      - `orderId` string — Gate OTC order ID.
      - `otcOrderId` string — OTC order ID.
      - `currency` string — Cryptocurrency code.
      - `amount` string — Cryptocurrency amount.
      - `fiatCurrency` string — Fiat currency code.
      - `fiatAmount` string — Fiat amount.
      - `cfRate` string — Exchange rate.
      - `bankId` string — Bank ID.
      - `bankNumber` string — Bank number.
      - `paid` boolean — Whether the order has been paid.
      - `status` string — Current order status.
      - `card_info` OtcCardInfo
        - `id` integer — Card info record ID.
        - `uid` integer — Merchant UID.
        - `entity` string — Entity name.
        - `bank_account_name` string — Collection bank account holder name.
        - `bank_name` string — Collection bank name.
        - `bank_country` string — Collection bank country.
        - `bank_address` string — Collection bank address.
        - `bank_code` string — Bank code.
        - `branch_code` string — Branch code.
        - `iban` string — Collection IBAN or account number.
        - `swift` string — Collection SWIFT or BIC code.
        - `remittance_line_number` string — Bank routing or remittance line number.
        - `agent_bank_name` string — Agent bank name if applicable.
        - `agent_bank_swift` string — Agent bank SWIFT if applicable.
        - `transferRemark` string — Required remittance remark or payment reference.
        - `memo` string — Memo.
        - `is_default` boolean — Whether this is the default card.
        - `bank_id` string — Bank ID.
      - `createTime` integer — Order creation timestamp (epoch millis).
      - `promoCode` string — Promotion code.
      - `transferRemark` string — Required remittance remark.
      - `paymentReceiptFileUrl` string — Payment receipt file URL.

---

[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/revisions/07cd4870de6a/schema)