Common
Balance
Payment
OTC
Convert
Payout
Gift Card
Subscription
curl --request POST \
--url https://openplatform.gateapi.io/payment/open/institution/v1/pay/convert/preview \
--header 'Content-Type: application/json' \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-On-Behalf-Of: <x-gatepay-on-behalf-of>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
--data '
{
"buyCurrency": "USDT",
"sellCurrency": "GT"
}
'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"sellCurrency": "GT",
"buyCurrency": "USDT",
"buyAmount": "1",
"sellAmount": "0.04466796",
"rate": "22.38741462",
"quoteId": "PAY-16991c65"
}
}Preview Convert Quote
Preview quote.
curl --request POST \
--url https://openplatform.gateapi.io/payment/open/institution/v1/pay/convert/preview \
--header 'Content-Type: application/json' \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-On-Behalf-Of: <x-gatepay-on-behalf-of>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
--data '
{
"buyCurrency": "USDT",
"sellCurrency": "GT"
}
'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"sellCurrency": "GT",
"buyCurrency": "USDT",
"buyAmount": "1",
"sellAmount": "0.04466796",
"rate": "22.38741462",
"quoteId": "PAY-16991c65"
}
}Documentation Index
Fetch the complete documentation index at: https://docs.gate.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
This page documents thePOST /payment/open/institution/v1/pay/convert/preview endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.
Notes
- Authentication uses the standard GatePay signed headers.
- This page documents the standard merchant endpoint.
- For shared signing rules, see /api-reference/version/100/en/common/securityAndSignature.
Headers
Merchant client ID assigned when registering the application
"mZ96D37oKk-HrWJc"
Request signature for verification
"8504fe097f7297f8952c76e628ce59dbc93d1df64c95f26c73140ef365d4aa1471826ada0534315461682ec35c131d7e133c51d2ab0822fe7366650a111887ba"
UTC timestamp in milliseconds
"1740019013818"
Random string, recommended length within 32 characters
"9722139164"
Required delegated-subject header. Provide the initiating account ID for this request. For institution merchant APIs, this is typically the target sub-account ID; for institution charge and transfer APIs, it can be either an institution account ID or a sub-account ID.