v1

latestOpenAPI 3.1.02026-07-21152963.1 KB

Get OTC Off-ramp Quote

Get a fiat-to-crypto quote for the OTC off-ramp flow.

post/withdraw/open/otc/api/v1/quote

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

Unix timestamp used for replay protection and signature verification.

X-GatePay-Noncestring required

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

X-GatePay-On-Behalf-Ofstring

Institutional sub-account UID. Only required when an institution submits a request on behalf of a sub-account; not required for direct merchant requests.

Request body

cryptoCurrencystring required

Cryptocurrency code used in the quote request. On-ramp supports: USDT, USDC. Off-ramp supports: USDT, USDC.

fiatCurrencystring required

Fiat currency code used in the quote request. Currently supported: USD.

cryptoAmountstring

Cryptocurrency amount used when quoting by crypto amount.

fiatAmountstring

Fiat amount used when quoting by fiat amount.

sidestring required

Quote direction. Use CRYPTO to quote by crypto amount or FIAT to quote by fiat amount.

promotionCodestring

Optional promotion code if supported by the OTC business flow.

typestring required

OTC business type. Use BUY for on-ramp and SELL for off-ramp.

Example request

{
  "cryptoCurrency": "USDT",
  "fiatCurrency": "USD",
  "fiatAmount": "1000",
  "side": "FIAT",
  "type": "BUY"
}

Response

Success

codestring

Business response code.

statusstring

Top-level request status.

errorMessagestring

Error message when the request fails.

Example response

{
  "code": "0",
  "status": "success",
  "errorMessage": "",
  "data": {
    "quoteToken": "qt_01JXYZABCDEF",
    "validPeriod": 60,
    "cryptoAmount": "1088.42",
    "fiatAmount": "1000",
    "fiatRate": "0.918762",
    "cryptoRate": "1.088420"
  }
}

All 16 operations