Create OTC Withdrawal Order

Create an OTC withdrawal order after obtaining a quote.

post/withdraw/open/otc/api/order/create

Headers

X-GatePay-Certificate-ClientIdstring required

Merchant application client ID used to identify the calling app.

X-GatePay-Signaturestring required

HMAC signature generated from the request according to GatePay signing rules.

X-GatePay-Timestampstring required

Millisecond timestamp; the difference from server time must not exceed 30 seconds.

X-GatePay-Noncestring required

Random nonce used together with the timestamp to prevent replay attacks.

Request body

quoteTokenstring required

Quote token returned by the quote API.

bankAccountIdstring required

Destination bank account ID for fiat settlement.

cryptoCurrencystring required

Cryptocurrency being sold. Currently supported: USDT, USDC.

fiatCurrencystring required

Fiat currency to be settled out. Currently supported: USD.

cryptoAmountstring required

Crypto amount for the withdrawal order.

fiatAmountstring required

Expected fiat settlement amount.

typestring required

Order type. Use SELL for off-ramp.

clientOrderIdstring required

Merchant-defined unique order ID.

Response

Success

codestring

Business response code.

statusstring

Top-level request status.

errorMessagestring

Error message when the request fails.

Example response

{
  "code": "000000",
  "status": "SUCCESS",
  "errorMessage": "",
  "data": {
    "orderId": "1234567890",
    "clientOrderId": "merchant_order_001",
    "status": "PROCESSING",
    "createTime": 1726055849126
  }
}

Changes

Changed in 1 of the 3 revisions of this API.13

Aug 25, 2026cd564245370513See the full diff
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed

Full history