Estimate Price Query

Description

You can retrieve the estimated fiat amount you need to pay or the crypto amount you can receive through this API. However, please note that this API does not facilitate order creation.

Test environment

https://openapi-test.alchemypay.org/open/api/v4/merchant/order/quoted/result

Prod environment

https://openapi.alchemypay.org/open/api/v4/merchant/order/quoted/result

❗️This API can only be invoked on the server side.

Http method

POST

Http Header

Element	Mandatory	Data Type	Remarks
appid	Y	string	Partner unique ID, Once a merchant has been on-boarded with Alchemy Pay, the merchant will be provided with the credentials with appId and appSecret
timestamp	Y	string	UTC time with 13 digits represents time in milliseconds, expiration period is 5 minutes.
sign	Y	string	Signature, you can refer to the signature here

Body Parameter

Element	Mandatory	Data Type	Remarks
side	Y	string	Pass value: BUY, SELL
fiatAmount	N	string	The amount of fiat currency
fiatCurrency	N	string	Fiat code， USD/EUR, etc.
cryptoQuantity	N	string	The number of digits
cryptoCurrency	N	string	Crypto name. example： USDT
network	N	string	Crypto acquiring network: e.g.: ETH/BSC/BTC, etc.
payWayCode	N	string	Payment method code: For the specific value.

Response sample

{
  "success": true,
  "returnCode": "0000",
  "returnMsg": "SUCCESS",
  "extend": "",
  "data": [
        {
            "cryptoPrice": "14893.45",
            “side”: “BUY”,
            "fiatAmount”: “100.22”,
            "cryptoQuantity": "31.87514642", 
            "rampFee": "20950.00",
            "networkFee": "4319.10",
            "fiat": "IDR",
            "crypto": "USDT",
            "payWayCode": "10004"
        }
    ]
}

Return Code List

Return Code	Return Message
3102	Quote amount is out of the range, The Min purchase amount is XX, The max purchase amount is XX
81010	Merchant parameter error

Other return codes reference: https://dash.readme.com/project/alchemypay/v4.0.1/docs/response-code-list