Author profile photo
Quickex team
October 14, 2024
~10 min read

APIv1

instrumentsGET

Get public list of all active instruments

Parameters

No parameters

Response

Returns list of all active instruments

[
{
"currencyTitle": "ADA",
"networkTitle": "ADA",
"currencyFriendlyTitle": "Cardano",
"precisionDecimals": 11,
"requiresMemo": false,
"currencyLogoLink": "https://static.coinall.ltd/cdn/assets/imgs/221/5FFE6AFD21B40243.png"
}
]

rates-infoGET

Get selected pair public info

Parameters

instrumentFromCurrencyTitle

string
*required
Title of sending instrument currency

Example:BTC

instrumentFromNetworkTitle

string
*required
Title of sending instrument network

Example:BTC

instrumentToCurrencyTitle

string
*required
Title of receiving instrument currency

Example:USDT

instrumentToNetworkTitle

string
*required
Title of receiving instrument network

Example:TRC20

claimedDepositAmount

string
User amount to send

Example:1

Response

Returns pair info object

{
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"precisionDecimals": 12
},
"instrumentTo": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"precisionDecimals": 11
},
"depositRules": {
"minAmount": "72.81550376835",
"maxAmount": "0"
},
"withdrawalRules": {
"minAmount": "0.00141001",
"maxAmount": "0",
"withdrawalFeeRules": {
"maxAmount": "0.0004",
"minAmount": "0.0004"
}
},
"minConfirmationsToWithdraw": 20,
"minConfirmationsToTrade": 20,
"price": "0.00001936165401188960303",
"reversePrice": "51648.480000000003909",
"updatedAt": "2024-02-20T03:44:50.000Z",
"liquidityProviderPublicCode": "radio",
"amountToGet": "0.06389345823923569",
"marketMinAmount": "3300"
}

Error codes

422 Returns if pair is not supported
406 Returns if amount to send is too low

validate-addressPOST

Validates an address for given instrument

Parameters

currencyTitle

string
*required
Title of instrument currency

Example:BTC

networkTitle

string
*required
Title of instrument network

Example:BTC

address

string
*required
Address to validate

Example:bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

Response

Returns boolean value

true

createPOST

Creates an exchange order

Parameters

instrumentFrom

object
*required
Sending instrument info

Example:{ "currencyTitle": "USDT", "networkTitle": "TRC20" }

instrumentTo

object
*required
Receiving instrument info

Example:{ "currencyTitle": "BTC", "networkTitle": "BTC" }

destinationAddress

string
*required
Destination address

Example:bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

destinationAddressMemo

string or null
*required
Destination memo (if exists)

Example:null

refundAddress

null
Not supported right now

Example:null

refundAddressMemo

null
Not supported right now

Example:null

claimedDepositAmount

number
*required
Claimed amount to send on moment of order creation

Example:43350

userEmail

string or null
User email for notification

Example:null

referrerId

string or null
Affiliate ID for reference

Example:aff_41

Response

Returns order object

{
"createdAt": "2024-02-20T03:46:45.736Z",
"orderId": 618,
"userEmail": null,
"refundAddress": null,
"destinationAddress": "bc1qfcgrdw99lr7v2sp6at6vna7dxhwvcrgj0s887w",
"claimedNetworkFee": "0.0004",
"claimedPublicRate": {
"price": "0.00001936597539494728",
"updatedAt": "2024-02-20T03:46:45.062Z",
"reversePrice": "51636.955"
},
"claimedDepositAmount": "3300",
"amountToGet": "0.063907718803",
"rateMode": "FLOATING",
"userId": null,
"referrerAffiliateId": "aff_41",
"pair": {
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"precisionDecimals": 12
},
"instrumentTo": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"precisionDecimals": 11
}
},
"orderEvents": [
{
"createdAt": "2024-02-20T03:46:45.736Z",
"kind": "CREATION_END"
}
],
"depositAddress": {
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"depositAddress": "TJvW1jY5xUCEobvAUJrZvoMeS8R3qQ5ThX",
"depositAddressMemo": null
},
"deposits": [],
"withdrawals": [],
"KYCFormLink": null,
"liquidityProviderPublicCode": "radio"
}

order-infoGET

Returns public info about order status

Parameters

orderId

number
*required
Order ID

Example:31954

destinationAddress

string
*required
User destination address

Example:bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

Response

Returns order status object

{
"deposits": [
{
"createdAt": "2024-01-30T13:32:26.141Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de"
}
],
"withdrawals": [
{
"createdAt": "2024-01-30T13:32:26.141Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"networkFee": "1.1",
"txId": "0xdeadc0dedeadbeef"
}
],
"depositAddress": {
"orderId": 0,
"liquidityProviderTitle": "WHITEBIT_BUSINESS_ACCOUNT",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"depositAddress": "0xdeadc0de"
},
"orderId": 0,
"createdAt": "2024-01-30T13:32:26.141Z",
"claimedDepositAmount": "10.01",
"claimedPublicRate": {
"price": "1000.1",
"reversePrice": "1000.1",
"updatedAt": "2024-01-30T13:32:26.141Z",
"liquidityProviderPublicCode": "formulae",
"claimedAmountToReceive": "0.01"
},
"claimedNetworkFee": "10.01",
"KYCFormLink": "string",
"orderEvents": {
"kind": "TRACKING_STARTED",
"createdAt": "2024-01-30T13:32:26.141Z"
},
"userEmail": "test@example.com",
"destinationAddress": "0xdeadbeef"
}

Notes

Steps for Processing Exchanges

Field Description
deposits When this array is empty, it indicates that the deposit has not yet been received. We remain in the initial step, awaiting the user’s deposit. Once the array contains entries, this indicates that the deposit has been received, and we can proceed to the next step. Please note a user may make multiple deposits, and to display the correct total deposit amount, it is necessary to sum the values in the “amount” field of each array element.
withdrawals[0].txId The “withdrawals” array remains empty while trading is in progress. Receipt of an object with a “txId” indicates that the transaction has been completed, allowing us to congratulate the user on the successful completion of their order.

set-emailPOST

Sets user email for notification user about order

Parameters

orderId

number
*required
Order ID

Example:31954

userEmail

string
*required
User email

Example:test_294614693@test.com

Response

Returns order status object

{
"createdAt": "2024-01-29T22:24:37.903Z",
"orderId": 556,
"userEmail": "user@email.com",
"legacyOrderId": null,
"refundAddress": null,
"destinationAddress": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
"claimedNetworkFee": "0.0004",
"claimedPublicRate": {
"price": "0.00002319399117909321",
"updatedAt": "2024-01-29T22:24:28.573Z",
"reversePrice": "43114.615000000005"
},
"claimedDepositAmount": "3300",
"pair": {
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"precisionDecimals": 12
},
"instrumentTo": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"precisionDecimals": 11
}
},
"orderEvents": [
{
"createdAt": "2024-01-29T22:24:37.903Z",
"kind": "CREATION_END"
}
],
"depositAddress": {
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"depositAddress": "TH1V2xkH9VpoiRSGfubnqtz3GiRpjieswN",
"depositAddressMemo": null
},
"deposits": [],
"withdrawals": [],
"KYCFormLink": null,
"liquidityProviderPublicCode": "radio"
}

Error codes

400 Returns if email is not valid
403 Returns if email already set (it can not be set twice)
404 Returns if order not found
422 Returns if order is already processed
Share article: