DxSpot Team
June 15, 2026
~1 min read
The Orders method group is responsible for working with orders – exchanges created by users on the DxSpot platform.
With the help of these methods you can:receive public information about a particular order and about the latest exchanges,
link an email to an order to receive notifications, accept changes in the exchange rate regime (e.g., switching from a fixed to a floating exchange rate), initiate a refund and check its status.
These methods are used at all stages of the order lifecycle – from tracking to returns.
GET
public-info
Endpoint URL
https://dxspot.io/api/v1/orders/public-info
Documentation
Returns public information about an order (exchange operation) by the destination address.
The response contains details of deposits/withdrawals, trading pair, declared rate parameters, order events, etc.
URL
https://dxspot.io/api/v1/orders/public-info
Request Parameters (Query)
| Parameter | Type | Required | Description |
|---|---|---|---|
destinationAddress |
string | yes | The destination address linked to the order. Used to search for the order. |
Request Example (cURL)
curl -X GET \
'https://dxspot.io/api/v1/orders/public-info?destinationAddress=0xdeadbeef' \
-H 'Accept: application/json'Response Example (success)
{
"orderId": 1234,
"legacyOrderId": "QX-0001234",
"pair": {
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo": { "currencyTitle": "BTC", "networkTitle": "BTC" }
},
"deposits": [
{
"createdAt": "2025-08-22T05:51:30.993Z",
"instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true
}
],
"withdrawals": [
{
"createdAt": "2025-08-22T05:51:30.993Z",
"instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"amount": "1000.1",
"networkFee": "1.1",
"txId": "0xdeadc0dedeadbeef"
}
],
"rateMode": "FLOATING",
"claimedDepositAmount": "10.01",
"amountToGet": "10.01",
"completed": false,
"userEmail": "[email protected]",
"destinationAddress": "0xdeadbeef"
}Responses
| Code | Body | Description |
|---|---|---|
200 OK |
JSON with order information | The order was found and returned. |
400 Bad Request |
{"status":"ERR_VALIDATION","message":"Validation Exception", ...} |
Validation error (for example, if destinationAddress is missing or invalid). |
5xx |
— | Internal server error. |
Notes
- The method returns public order data; private details are not available.
- If the order has not yet been created / cannot be found by the address, a validation error or empty result will be returned.
- The structure of the
deposits/withdrawalssections and auxiliary fields may vary depending on the order status and liquidity provider.
Code Sample
curl -X 'GET' \
'https://dxspot.io/api/v1/orders/public-info?destinationAddress={YOUR_ADDRESS}' \
-H 'accept: application/json'Response Example
{
"deposits": [
{
"createdAt": "2025-08-22T05:51:30.993Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true,
"id": 0,
"counterPartyAddress": "0xdeadc0dedeadbeef"
}
],
"withdrawals": [
{
"createdAt": "2025-08-22T05:51:30.993Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"networkFee": "1.1",
"txId": "0xdeadc0dedeadbeef"
}
],
"depositAddress": {
"orderId": 0,
"liquidityProviderTitle": "DXSPOT_BUSINESS_ACCOUNT",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"depositAddress": "0xdeadc0de",
"depositAddressMemo": "string",
"redirectUrl": "string"
},
"orderId": 0,
"legacyOrderId": "string",
"pair": {
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
}
},
"createdAt": "2025-08-22T05:51:30.994Z",
"claimedDepositAmount": "10.01",
"amountToGet": "10.01",
"claimedPublicRate": {
"price": "1000.1",
"quotes": {
"sellQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
},
"buyQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
}
},
"updatedAt": "2025-08-22T05:51:30.994Z",
"liquidityProviderPublicCode": "formulae",
"claimedAmountToReceive": "0.01",
"finalNetworkFeeAmount": "0.01",
"platformFee_Absolute": "0.01",
"fixedRate_maxAmount": "1000.000",
"fixedRate_maxTimeMinutes": 1,
"fixedRate_maxRateVolatilityPercent": "1000.000"
},
"claimedNetworkFee": "10.01",
"KYCFormLink": "string",
"orderEvents": [
{
"kind": "TRACKING_STARTED",
"createdAt": "2025-08-22T05:51:30.994Z"
}
],
"userEmail": "[email protected]",
"rateMode": "FLOATING",
"destinationAddress": "0xdeadbeef",
"destinationAddressMemo": "0xdeadbeef",
"completed": false,
"possibleCashbackAmountUSDT": "500.00",
"redirectUrl": "https://payments.mercuryo.io/"
}Try it out
Leave empty to use default
Headers
POST
set-email
Endpoint URL
/api/v1/orders/public/set-email
Documentation
Assigns an email to an existing order (exchange operation). The email is used to send order status notifications and for contacting support.
URL
https://dxspot.io/api/v1/orders/public/set-email
Authorization Required
No (public method for an existing order).
Headers
Accept: application/jsonContent-Type: application/json
Request Body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
orderId |
number | yes | The identifier of the order to which the email should be linked. |
userEmail |
string (email) | yes | User’s email address for notifications. |
{
"orderId": 123456,
"userEmail": "[email protected]"
}Request Example (cURL)
curl -X POST \
'https://dxspot.io/api/v1/orders/public/set-email' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"orderId": 123456,
"userEmail": "[email protected]"
}'Responses
| Code | Body | Description |
|---|---|---|
200 OK |
JSON with public order information (including userEmail) |
Email successfully linked to the order. |
400 Bad Request |
{"status":"ERR_VALIDATION","message":"Validation Exception", ...} |
Validation error (for example, if userEmail is not a valid email). |
5xx |
— | Internal server error. |
Notes
- Before calling the method, make sure you specify a valid
orderIdof an existing order.userEmailmust be a valid email address (example error:userEmail must be an email).- The successful response returns the current public order information, where the
userEmailfield will contain the assigned address.
Code Sample
curl -X 'POST' \
'https://dxspot.io/api/v1/orders/public/set-email' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"orderId": {ID},
"userEmail": "[email protected]"
}'Response Example
{
"deposits": [
{
"createdAt": "2025-08-22T06:03:09.050Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true,
"id": 0,
"counterPartyAddress": "0xdeadc0dedeadbeef"
}
],
"withdrawals": [
{
"createdAt": "2025-08-22T06:03:09.050Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"networkFee": "1.1",
"txId": "0xdeadc0dedeadbeef"
}
],
"depositAddress": {
"orderId": 0,
"liquidityProviderTitle": "DXSPOT_BUSINESS_ACCOUNT",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"depositAddress": "0xdeadc0de",
"depositAddressMemo": "string",
"redirectUrl": "string"
},
"orderId": 0,
"legacyOrderId": "string",
"pair": {
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
}
},
"createdAt": "2025-08-22T06:03:09.050Z",
"claimedDepositAmount": "10.01",
"amountToGet": "10.01",
"claimedPublicRate": {
"price": "1000.1",
"quotes": {
"sellQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
},
"buyQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
}
},
"updatedAt": "2025-08-22T06:03:09.050Z",
"liquidityProviderPublicCode": "formulae",
"claimedAmountToReceive": "0.01",
"finalNetworkFeeAmount": "0.01",
"platformFee_Absolute": "0.01",
"fixedRate_maxAmount": "1000.000",
"fixedRate_maxTimeMinutes": 1,
"fixedRate_maxRateVolatilityPercent": "1000.000"
},
"claimedNetworkFee": "10.01",
"KYCFormLink": "string",
"orderEvents": [
{
"kind": "TRACKING_STARTED",
"createdAt": "2025-08-22T06:03:09.050Z"
}
],
"userEmail": "[email protected]",
"rateMode": "FLOATING",
"destinationAddress": "0xdeadbeef",
"destinationAddressMemo": "0xdeadbeef",
"completed": false,
"possibleCashbackAmountUSDT": "500.00",
"redirectUrl": "https://payments.mercuryo.io/"
}Try it out
Leave empty to use default
Request Body
Headers
GET
latest
Endpoint URL
https://dxspot.io/api/v1/orders/public/latest
Documentation
Returns a list of the latest public orders created on the Dxspot platform.
This method requires no parameters and provides basic information about recent exchanges (currencies, networks, and amounts).
Parameters
None
Request Example
curl -X 'GET' \
'https://dxspot.io/api/v1/orders/public/latest' \
-H 'accept: application/json'Response Example (200)
[
{
"createdAt": "2025-08-22T05:43:01.000Z",
"instrumentFrom": {
"currencyTitle": "BNB",
"networkTitle": "BEP20",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "BNB",
"currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/1839.png"
}
},
"instrumentTo": {
"currencyTitle": "SOL",
"networkTitle": "SOL",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "SOL",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/sol.png"
}
},
"amountFrom": "0.1809",
"amountTo": "0.82480169"
}
]Notes
The method returns only public information (without user personal data).
It can be useful for displaying a “latest exchanges” widget on a website.
The response contains a list with a limited number of records (e.g., the last 5–10 orders).
Code Sample
curl -X 'GET' \
'https://dxspot.io/api/v1/orders/public/latest' \
-H 'accept: */*'Response Example
[
{
"createdAt": "2025-08-22T05:43:01.000Z",
"instrumentFrom": {
"currencyTitle": "BNB",
"networkTitle": "BEP20",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "BNB",
"currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/1839.png"
}
},
"instrumentTo": {
"currencyTitle": "SOL",
"networkTitle": "SOL",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "SOL",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/sol.png"
}
},
"amountFrom": "0.1809",
"amountTo": "0.82480169"
},
{
"createdAt": "2025-08-22T05:37:01.000Z",
"instrumentFrom": {
"currencyTitle": "BNB",
"networkTitle": "BEP20",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "BNB",
"currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/1839.png"
}
},
"instrumentTo": {
"currencyTitle": "SOL",
"networkTitle": "SOL",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "SOL",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/sol.png"
}
},
"amountFrom": "0.2012",
"amountTo": "0.91833564"
},
{
"createdAt": "2025-08-22T05:33:04.000Z",
"instrumentFrom": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "BTC",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/btc20230419112752.png"
}
},
"instrumentTo": {
"currencyTitle": "ATOM",
"networkTitle": "ATOM",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "ATOM",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/atom.png"
}
},
"amountFrom": "0.12827865",
"amountTo": "3149.690556"
},
{
"createdAt": "2025-08-22T05:29:03.000Z",
"instrumentFrom": {
"currencyTitle": "BTC",
"networkTitle": "BTC",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "BTC",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/btc20230419112752.png"
}
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "USDT",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/usdt20230419113051.png"
}
},
"amountFrom": "0.00478498",
"amountTo": "563.455834"
},
{
"createdAt": "2025-08-22T05:22:03.000Z",
"instrumentFrom": {
"currencyTitle": "ETH",
"networkTitle": "ETH",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "Ethereum",
"currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/eth20230419112854.png"
}
},
"instrumentTo": {
"currencyTitle": "BNB",
"networkTitle": "BEP20",
"okexCurrency": {
"okexCurrencyFriendlyTitle": "BNB",
"currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/1839.png"
}
},
"amountFrom": "0.59",
"amountTo": "2.77157716"
}
]Try it out
Leave empty to use default
Headers
POST
accept-rate-mode-change
Endpoint URL
https://dxspot.io/api/v1/orders/public/accept-rate-mode-change
Documentation
Confirms the change of rate mode for an order. This is used in cases where the order was created with a fixed rate,
but during the exchange process it was switched to a floating rate (for example, due to exceeding limits or high volatility).
The method allows the user to accept the new mode and continue order processing.
URL
https://dxspot.io/api/v1/orders/public/accept-rate-mode-change
Headers
Accept: application/jsonContent-Type: application/json
Request Body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
orderId |
number | yes | The identifier of the order for which the rate mode change needs to be confirmed. |
destinationAddress |
string | yes | The destination address associated with the order (used as an additional check). |
{
"orderId": 123456,
"destinationAddress": "0xdeadbeef"
}Request Example (cURL)
curl -X POST \
'https://dxspot.io/api/v1/orders/public/accept-rate-mode-change' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"orderId": 123456,
"destinationAddress": "0xdeadbeef"
}'Responses
| Code | Description |
|---|---|
201 Created |
The rate mode change has been confirmed, and the order continues processing. |
404 Not Found |
Order not found ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Validation error (for example, invalid input data). |
5xx |
Internal server error. |
Notes
- This method is only called if the order has changed its rate mode (for example, from fixed to floating).
- Without confirmation, the order processing will be suspended.
- On success, the response returns status 201 and the order moves into continued processing state.
Code Sample
curl -X 'POST' \
'https://dxspot.io/api/v1/orders/public/accept-rate-mode-change' \
-H 'accept: */*' \
-H 'Content-Type: application/json' \
-d '{
"orderId": {},
"destinationAddress": "string"
}'Try it out
Leave empty to use default
Request Body
Headers
POST
request-refund
Endpoint URL
https://dxspot.io/api/v1/orders/public/request-refund
Documentation
Requests a refund for an order. Used in situations where the exchange was not completed or funds must be returned to the user.
To succeed, the refund amount and refund address must be specified.
URL
https://dxspot.io/api/v1/orders/public/request-refund
Headers
Accept: application/jsonContent-Type: application/json
Request Body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
orderId |
number | yes | The identifier of the order for which a refund is requested. |
destinationAddress |
string | yes | The destination address specified in the original order (used as an additional check). |
refundAmount |
string | yes | The amount to be refunded to the user. |
refundAddress |
string | yes | The user’s wallet address where the funds will be refunded. |
claimedNetworkFee |
string | no | The network fee amount the user agrees to pay for the refund. |
{
"orderId": 123456,
"destinationAddress": "0xdeadbeef",
"refundAmount": "10.00",
"refundAddress": "0xuserrefundwallet",
"claimedNetworkFee": "0.50"
}Request Example (cURL)
curl -X POST \
'https://dxspot.io/api/v1/orders/public/request-refund' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"orderId": 123456,
"destinationAddress": "0xdeadbeef",
"refundAmount": "10.00",
"refundAddress": "0xuserrefundwallet",
"claimedNetworkFee": "0.50"
}'Responses
| Code | Description |
|---|---|
201 Created |
The refund request has been accepted and will be processed. |
404 Not Found |
Order not found ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Validation error (for example, refund amount below the allowed minimum or invalid refundAddress). |
5xx |
Internal server error. |
Notes
- This method is only used for orders that cannot be completed.
- The refund is made to the address specified in
refundAddress, minus any applicable network fees.- After submission, the refund may require manual verification by support staff.
Code Sample
curl -X 'POST' \
'https://dxspot.io/api/v1/orders/public/request-refund' \
-H 'accept: */*' \
-H 'Content-Type: application/json' \
-d '{
"orderId": {},
"destinationAddress": "string",
"refundAmount": "10.00",
"refundAddress": "string",
"claimedNetworkFee": "10.00"
}'Try it out
Leave empty to use default
Request Body
Headers
GET
order-refund-info
Endpoint URL
https://dxspot.io/api/v1/orders/order-refund-info
Documentation
Returns refund information for a specific order.
Used after creating a refund request to check the details (amount, refund address, status).
URL
https://dxspot.io/api/v1/orders/order-refund-info
Request Parameters (Query)
| Parameter | Type | Required | Description |
|---|---|---|---|
orderId |
string | yes | The identifier of the order for which refund data should be retrieved. |
curl -X GET \
'https://dxspot.io/api/v1/orders/order-refund-info?orderId=1234' \
-H 'Accept: application/json'Responses
| Code | Description |
|---|---|
200 OK |
Returns JSON with refund information (amount, address, status, fees). |
400 Bad Request |
Validation error or invalid order data ({"status":"ERR_BAD_REQUEST","message":"Unknown liquidity provider title: ..."}). |
404 Not Found |
Order not found. |
5xx |
Internal server error. |
Notes
- The method returns data only for orders where a refund has been initiated.
- In a successful
200response, the JSON may include the refund amount, refund address, and network fees.- For validation errors (
400), the server provides the reason in themessagefield.
Code Sample
curl -X 'GET' \
'https://dxspot.io/api/v1/orders/order-refund-info?orderId={YOUR_ORDERID}' \
-H 'accept: */*'Try it out
Leave empty to use default
Headers
GET
public/list
Endpoint URL
https://dxspot.io/api/v1/orders/public/list
Documentation
Returns a list of orders associated with the currently authenticated user.
The response includes details of deposits, withdrawals, trading pair parameters, order status, and other information.
URL
https://dxspot.io/api/v1/orders/public/list
Authorization Required
Yes — a valid access_token must be provided in the header.
Headers
Accept: application/jsonaccess_token = YOUR_TOKEN
Parameters
None
Request Example (cURL)
curl -X GET \
'https://dxspot.io/api/v1/orders/public/list' \
-H 'Accept: application/json' \
--cookie "access_token=YOUR_TOKEN"Response Example (200)
[
{
"orderId": 123,
"pair": {
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo": { "currencyTitle": "BTC", "networkTitle": "BTC" }
},
"deposits": [
{
"createdAt": "2025-08-26T09:55:46.101Z",
"instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true
}
],
"withdrawals": [
{
"createdAt": "2025-08-26T09:55:46.101Z",
"instrument": { "currencyTitle": "BTC", "networkTitle": "BTC" },
"amount": "0.025",
"txId": "0xbtcdeadbeef"
}
],
"status": "PENDING",
"createdAt": "2025-08-26T09:55:46.101Z"
}
]Responses
| Code | Description |
|---|---|
200 OK |
Returns an array of the user’s orders. |
401 Unauthorized |
access_token is missing or invalid. |
5xx |
Server error while processing the request. |
Notes
- This method returns only the orders created by the currently authenticated user.
- To retrieve public information about a specific order, use the
/api/v1/orders/public-infomethod.- It is recommended to cache order data on the client side to reduce the number of requests.
Code Sample
curl -X 'GET' \
'https://dxspot.io/api/v1/orders/public/list' \
-H 'accept: application/json'
--cookie "access_token=YOUR_TOKEN" \Try it out
Leave empty to use default
Headers
POST
Create
Endpoint URL
https://dxspot.io/api/v1/orders/public/create
Documentation
Create Order
This method creates a new exchange order between the specified instruments.
It returns the order ID, deposit address, deposit/withdrawal records, and
calculated exchange parameters.
URL
POST https://dxspot.io/api/v1/orders/public/create
Authorization
Requires header B2B-Bearer-Token: <JWToken>.
Key Request Fields
instrumentFrom— deposit currency/networkinstrumentTo— payout currency/networkdestinationAddress— withdrawal addressrefundAddress— fallback refund addressclaimedDepositAmount— declared deposit amountrateMode—FLOATINGorFIXEDclaimedPublicRate— public rate used for calculationreferrerId,markupAffiliateId,markup— affiliate settingsuserEmail— user notification email
Returns
orderId,userId,legacyOrderId— order identifiersdepositAddress— deposit address and liquidity provider infodeposits[]— deposit records for the orderwithdrawals[]— withdrawal records (if any)claimedPublicRate— final rate, fees, limitspossibleCashbackAmountUSDT— potential cashback amountredirectUrl,KYCFormLink— external payment/KYC flows
Example Request
curl -X POST \
'https://dxspot.io/api/v1/orders/public/create' \
-H 'accept: application/json' \
-H 'B2B-Bearer-Token: <JWToken>' \
-H 'Content-Type: application/json' \
-d '{
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo": { "currencyTitle": "LTC", "networkTitle": "LTC" },
"destinationAddress": "MWYK4uQXFvWc1Bj1CPACyX5HTQxUUpRZ2e",
"refundAddress": "TFe5tdqSy8CMGMDVHPJHLTK8hrAL6ddUpD",
"claimedDepositAmount": "3300",
"claimedPublicRate": {
"price": "0.014271620139287839394",
"updatedAt": "2024-02-13T14:43:12.983Z",
"claimedAmountToReceive": "47.09634645964987"
},
"claimedNetworkFee": "0.001",
"userEmail": "[email protected]",
"referrerId": "aff_some-affiliate-id",
"markupAffiliateId": "aff_some-affiliate-id",
"rateMode": "FLOATING",
"markup": "0.01"
}'Example Response
{
"deposits": [
{
"createdAt": "2025-11-21T09:26:08.476Z",
"instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"amount": "1000.1",
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true
}
],
"withdrawals": [
{
"createdAt": "2025-11-21T09:26:08.476Z",
"instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"amount": "1000.1",
"networkFee": "1.1",
"txId": "0xdeadc0dedeadbeef"
}
],
"depositAddress": {
"orderId": 0,
"liquidityProviderTitle": "DXSPOT_BUSINESS_ACCOUNT",
"instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"depositAddress": "0xdeadc0de",
"depositAddressMemo": "string",
"redirectUrl": "string"
},
"orderId": 0,
"userId": 0,
"pair": {
"instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
"instrumentTo": { "currencyTitle": "USDT", "networkTitle": "TRC20" }
},
"claimedDepositAmount": "10.01",
"amountToGet": "10.01",
"claimedPublicRate": {
"price": "1000.1",
"claimedAmountToReceive": "0.01",
"finalNetworkFeeAmount": "0.01"
},
"possibleCashbackAmountUSDT": "500.00",
"redirectUrl": "https://payments.mercuryo.io/"
}Code Sample
curl -X 'POST' \
'https://dxspot.io/api/v1/orders/public/create' \
-H 'accept: application/json' \
-H 'B2B-Bearer-Token: {'JWToken'}' \
-H 'Content-Type: application/json' \
-d '{
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"instrumentTo": {
"currencyTitle": "LTC",
"networkTitle": "LTC"
},
"destinationAddress": "MWYK4uQXFvWc1Bj1CPACyX5HTQxUUpRZ2e",
"destinationAddressMemo": null,
"refundAddress": "TFe5tdqSy8CMGMDVHPJHLTK8hrAL6ddUpD",
"refundAddressMemo": null,
"claimedDepositAmount": "3300",
"claimedPublicRate": {
"price": "0.014271620139287839394",
"updatedAt": "2024-02-13T14:43:12.983Z",
"claimedAmountToReceive": "47.09634645964987"
},
"claimedNetworkFee": "0.001",
"userEmail": "[email protected]",
"legacyOrderId": null,
"referrerId": "aff_some-affiliate-id",
"markupAffiliateId": "aff_some-affiliate-id",
"rateMode": "FLOATING",
"utmData": {},
"browserFingerprint": "string",
"markup": "0.01",
"mercuryoBearerToken": "string",
"locale": "string"
}'Response Example
{
"deposits": [
{
"createdAt": "2025-11-21T09:26:08.476Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"confirmations": 0,
"txId": "0xdeadc0dedeadbeef",
"depositAddress": "0xdeadc0de",
"isPending": true,
"id": 0,
"counterPartyAddress": "0xdeadc0dedeadbeef"
}
],
"withdrawals": [
{
"createdAt": "2025-11-21T09:26:08.476Z",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"amount": "1000.1",
"networkFee": "1.1",
"txId": "0xdeadc0dedeadbeef"
}
],
"depositAddress": {
"orderId": 0,
"liquidityProviderTitle": "DXSPOT_BUSINESS_ACCOUNT",
"instrument": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"depositAddress": "0xdeadc0de",
"depositAddressMemo": "string",
"redirectUrl": "string"
},
"orderId": 0,
"userId": 0,
"legacyOrderId": "string",
"pair": {
"instrumentFrom": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
},
"instrumentTo": {
"currencyTitle": "USDT",
"networkTitle": "TRC20"
}
},
"createdAt": "2025-11-21T09:26:08.476Z",
"claimedDepositAmount": "10.01",
"amountToGet": "10.01",
"claimedPublicRate": {
"price": "1000.1",
"quotes": {
"sellQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
},
"buyQuote": {
"baseValue": "1000.1",
"quoteValue": "1000.1"
}
},
"updatedAt": "2025-11-21T09:26:08.476Z",
"liquidityProviderPublicCode": "formulae",
"claimedAmountToReceive": "0.01",
"finalNetworkFeeAmount": "0.01",
"platformFee_Absolute": "0.01",
"fixedRate_maxAmount": "1000.000",
"fixedRate_maxTimeMinutes": 1,
"fixedRate_maxRateVolatilityPercent": "1000.000"
},
"claimedNetworkFee": "10.01",
"KYCFormLink": "string",
"orderEvents": [
{
"kind": "TRACKING_STARTED",
"createdAt": "2025-11-21T09:26:08.476Z"
}
],
"userEmail": "[email protected]",
"rateMode": "FLOATING",
"destinationAddress": "0xdeadbeef",
"destinationAddressMemo": "0xdeadbeef",
"completed": false,
"possibleCashbackAmountUSDT": "500.00",
"redirectUrl": "https://payments.mercuryo.io/",
"minConfirmationsToTrade": 3,
"minConfirmationsToWithdraw": 3
}Try it out
Leave empty to use default