Skip to main content

Send Quote

API used to send convert quote.

*This API is only available for whitelisted merchants. If you need any help, you can contact us: merchant@binance.com

EndPoint#

POST /binancepay/openapi/otc-portal/get-quote

Request Parameters#

AttributesTypeRequiredLimitationDescription
walletstringYEnum stringBinance wallet to query, currently supported enum valus:

FUNDING_WALLET
SPOT_WALLET
fromAssetstringYValid currency, must be in uppercase. Only require either fromAsset or toAsset.Currency to query, for e.g, BUSD
toAssetstringYValid currency, must be in uppercase. Only require either fromAsset or toAsset.Currency to query, for e.g, BUSD
fromAmountstringYAmount Range: 0.00000001 - 999999999999999.99999999; Max Unit Range: 8 decimal placesFrom asset amount
toAmountstringYAmount Range: 0.00000001 - 999999999999999.99999999; Max Unit Range: 8 decimal placesTo asset amount

Sample Request Body#

{    "wallet": "FUNDING_WALLET",    "fromAsset": "BUSD",    "toAsset": "BNB",    "fromAmount": null,    "toAmount": 0.8}

Response Parameters#

AttributesTypeRequiredLimitationDescription
statusstringY"SUCCESS" or "FAIL"status of the API request
codestringY-request result code, refer to
dataSendQuoteRespN-response body, refer to
errorMessagestringNmaximum length 256

Child Attribute#

SendQuoteResp#

AttributesTypeRequiredLimitationDescription
quoteIdstringNQuote ID for execute quote. If not returned, there is insufficient balance to convert.
ratiodecimalYFrom:To quote price
inverseRatiodecimalYTo:From quote price
validTimestampdecimalYExpire timestamp
expireTimedecimalYExpire time (second)
toAmountdecimalYWhen specified, it is the amount you will be credited after the conversion
toCoinstringYTo Asset
fromAmountdecimalYWhen specified, it is the amount you will be debited after the conversion
fromCoinstringYFrom Asset

Sample Response#

{  "status": "SUCCESS",  "code": "000000",  "data": {    "quoteId": "2d7b7439c540479999ec367a701bf5f6",    "ratio": 0.00445577,    "inverseRatio": 224.428,    "validTimestamp": 1666949735947,    "expireTime": 4,    "toAmount": 0.8,    "toCoin": "BNB",    "fromAmount": 179.54201695,    "fromCoin": "BUSD"  }}
{    "status": "FAIL",    "code": "400003",    "errorMessage": "Timestamp for this request is outside of the recvWindow."}

Result Code#

NameCodeReasonSolution
UNKNOWN_ERROR400000An unknown error occurred while processing the request.Try again later
INVALID_REQUEST400001Parameter format is wrong or parameter transferring doesn't follow the rules.Please check whether the parameters are correct.
INVALID_SIGNATURE400002Incorrect signature resultCheck whether the signature parameter and method comply with signature algorithm requirements.
INVALID_TIMESTAMP400003Timestamp for this request is outside of the time window.Sync server clock
INVALID_API_KEY_OR_IP400004API identity key not found or invalid.Check API identity key
BAD_API_KEY_FMT400005API identity key format invalid.Check API identity key.
BAD_HTTP_METHOD400006Request method not supported.Check Request method.
MEDIA_TYPE_NOT_SUPPORTED400007Media type not supported.Check Request Media type.
INVALID_REQUEST_BODY400008Request body is not a valid json object.Check Request body
MANDATORY_PARAM_EMPTY_OR_MALFORMED400100A parameter was missing/empty/null, or malformed.
INVALID_PARAM_WRONG_LENGTH400101A parameter was not valid, was empty/null, or too long/short, or wrong format.
INVALID_PARAM_WRONG_VALUE400102A parameter was not valid, the value is out of range.
INVALID_PARAM_ILLEGAL_CHAR400103A parameter was not valid, contains illegal characters
INVALID_REQUEST_TOO_LARGE400104Invalid request, content length too large