Использование API Quickex для Криптовалютных Операций

instruments GET

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-info GET

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

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

validate-address POST

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

create POST

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-info GET

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

FieldDescription
depositsWhen 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].txIdThe "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-email POST

Sets user email for notification user about order

Parameters

orderId
number
*required
Order ID

Example:31954

userEmail
string
*required
User email

Example:test_161871192@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

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