GET

public-info

Endpoint URL

https://dxspot.io/api/v1/orders/public-info

Documentation

Возвращает публичную информацию о заказе (обменной операции) по адресу назначения.
В ответе приходят детали депозита/вывода, пара инструментов, параметры заявленного курса, события заказа и т.д.

URL

https://dxspot.io/api/v1/orders/public-info

Параметры запроса (Query)

Параметр	Тип	Обяз.	Описание
`destinationAddress`	string	да	Адрес назначения, к которому привязан заказ. Используется для поиска заказа.

Пример запроса (cURL)

curl -X GET \
  'https://dxspot.io/api/v1/orders/public-info?destinationAddress=0xdeadbeef' \
  -H 'Accept: application/json'

Пример ответа (успех)

{
  "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"
}

Ответы

Код	Тело	Описание
`200 OK`	JSON с информацией о заказе	Заказ найден и возвращён.
`400 Bad Request`	`{"status":"ERR_VALIDATION","message":"Validation Exception", ...}`	Ошибка валидации (например, не передан `destinationAddress` или он некорректен).
`5xx`	—	Внутренняя ошибка сервера.

Примечания

Метод отдаёт публичные данные заказа; приватные детали недоступны.

Если заказ ещё не создан/не найден по адресу, вернётся ошибка валидации или пустой результат.

Структура разделов deposits/withdrawals и вспомогательных полей может меняться в зависимости от статуса заказа и провайдера ликвидности.

Code Sample

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

POST

set-email

Endpoint URL

/api/v1/orders/public/set-email

Documentation

Присваивает email существующему заказу (обменной операции). Email используется для отправки уведомлений по статусу заказа и для связи с поддержкой.

URL

https://dxspot.io/api/v1/orders/public/set-email

Требуется авторизация

Нет (публичный метод для существующего заказа).

Заголовки

Accept: application/json
Content-Type: application/json

Тело запроса (JSON)

Поле	Тип	Обяз.	Описание
`orderId`	number	да	Идентификатор заказа, к которому нужно привязать email.
`userEmail`	string (email)	да	Почтовый адрес пользователя для уведомлений.

{
  "orderId": 123456,
  "userEmail": "[email protected]"
}

Пример запроса (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]"
  }'

Ответы

Код	Тело	Описание
`200 OK`	JSON с публичной информацией о заказе (включая `userEmail`)	Email успешно привязан к заказу.
`400 Bad Request`	`{"status":"ERR_VALIDATION","message":"Validation Exception", ...}`	Ошибка валидации (например, `userEmail` не является валидным email).
`5xx`	—	Внутренняя ошибка сервера.

Примечания

Перед вызовом убедитесь, что указан корректный orderId существующего заказа.

userEmail должен быть валидным адресом (пример ошибки: userEmail must be an email).

В успешном ответе возвращается актуальная публичная информация по заказу, где поле userEmail будет установленным адресом.

Code Sample

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

GET

latest

Endpoint URL

https://dxspot.io/api/v1/orders/public/latest

Documentation

Code Sample

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

POST

accept-rate-mode-change

Endpoint URL

https://dxspot.io/api/v1/orders/public/accept-rate-mode-change

Documentation

Подтверждает смену режима курса для заказа. Используется в случаях, когда заказ был создан с фиксированным курсом,
но в процессе обмена произошёл переход на плавающий курс (например, из-за превышения лимита или высокой волатильности).
Метод позволяет пользователю принять новый режим и продолжить обработку заказа.

URL

https://dxspot.io/api/v1/orders/public/accept-rate-mode-change

Заголовки

Accept: application/json
Content-Type: application/json

Тело запроса (JSON)

Поле	Тип	Обяз.	Описание
`orderId`	number	да	Идентификатор заказа, для которого необходимо подтвердить смену режима курса.
`destinationAddress`	string	да	Адрес назначения, связанный с заказом (используется как дополнительная проверка).

{
  "orderId": 123456,
  "destinationAddress": "0xdeadbeef"
}

Пример запроса (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"
  }'

Ответы

Код	Описание
`201 Created`	Смена режима курса подтверждена, заказ продолжает обработку.
`404 Not Found`	Заказ не найден (`{"status":"ERR_NOT_FOUND","message":"Order not found"}`).
`400 Bad Request`	Ошибка валидации (например, некорректные входные данные).
`5xx`	Внутренняя ошибка сервера.

Примечания

Метод вызывается только если заказ изменил режим курса (например, с фиксированного на плавающий).

Без подтверждения обработка заказа будет приостановлена.

В ответе при успехе приходит статус 201 и заказ переводится в состояние продолжения обработки.

Code Sample

Try it out

POST

request-refund

Endpoint URL

https://dxspot.io/api/v1/orders/public/request-refund

Documentation

Запрашивает возврат средств по заказу. Используется в ситуациях, когда обмен не был завершён или средства должны быть возвращены пользователю.
Для успешного выполнения необходимо указать сумму возврата и адрес для возврата.

URL

https://dxspot.io/api/v1/orders/public/request-refund

Заголовки

Accept: application/json
Content-Type: application/json

Тело запроса (JSON)

Поле	Тип	Обяз.	Описание
`orderId`	number	да	Идентификатор заказа, по которому запрашивается возврат.
`destinationAddress`	string	да	Адрес назначения, указанный в исходном заказе (дополнительная проверка).
`refundAmount`	string	да	Сумма, которую требуется вернуть пользователю.
`refundAddress`	string	да	Кошелёк пользователя, на который будут возвращены средства.
`claimedNetworkFee`	string	нет	Размер комиссии сети, который пользователь соглашается оплатить при возврате.

{
  "orderId": 123456,
  "destinationAddress": "0xdeadbeef",
  "refundAmount": "10.00",
  "refundAddress": "0xuserrefundwallet",
  "claimedNetworkFee": "0.50"
}

Пример запроса (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"
  }'

Ответы

Код	Описание
`201 Created`	Запрос возврата принят, обработка возврата будет выполнена.
`404 Not Found`	Заказ не найден (`{"status":"ERR_NOT_FOUND","message":"Order not found"}`).
`400 Bad Request`	Ошибка валидации (например, сумма возврата меньше допустимой или неверный `refundAddress`).
`5xx`	Внутренняя ошибка сервера.

Примечания

Метод используется только для заказов, которые не могут быть завершены.

Возврат осуществляется на адрес, указанный в поле refundAddress, с вычетом возможной комиссии сети.

После запроса возврат может потребовать ручной проверки службой поддержки.

Code Sample

Try it out

GET

order-refund-info

Параметр	Тип	Обяз.	Описание
`orderId`	string	да	Идентификатор заказа, по которому необходимо получить данные о возврате.

Код	Описание
`200 OK`	Возвращает JSON с информацией о возврате (сумма, адрес, статус, комиссии).
`400 Bad Request`	Ошибка валидации или некорректные данные заказа (`{"status":"ERR_BAD_REQUEST","message":"Unknown liquidity provider title: ..."}`).
`404 Not Found`	Заказ не найден.
`5xx`	Внутренняя ошибка сервера.

GET

public/list

Endpoint URL

https://dxspot.io/api/v1/orders/public/list

Documentation

Возвращает список заказов (ордеров), связанных с текущим аутентифицированным пользователем.
В ответе содержатся детали депозитов, выводов, параметры пары, статус заказа и другая информация.

URL

https://dxspot.io/api/v1/orders/public/list

Требуется авторизация

Да — необходимо передать действительный access_token в заголовке .

Заголовки

Accept: application/json
access_token = YOUR_TOKEN

Параметры

Отсутствуют

Пример запроса (cURL)

curl -X GET \
  'https://dxspot.io/api/v1/orders/public/list' \
  -H 'Accept: application/json' \
  --cookie "access_token=YOUR_TOKEN" \'

Пример ответа (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"
  }
]

Ответы

Код	Описание
`200 OK`	Возвращает массив заказов пользователя.
`401 Unauthorized`	Не передан или недействителен `access_token`.
`5xx`	Ошибка сервера при обработке запроса.

Примечания

Метод возвращает только заказы, созданные текущим авторизованным пользователем.

Для получения публичной информации о конкретном заказе можно использовать метод /api/v1/orders/public-info.

Рекомендуется кэшировать данные заказов на клиенте для уменьшения количества запросов.

Code Sample

Try it out

POST

Create

Endpoint URL

https://dxspot.io/api/v1/orders/public/create

Documentation

Создаёт новый заказ (ордер) на обмен.
Метод принимает параметры пары (валюта отправления и получения), сумму, адреса пользователя, а также дополнительные данные
(курс, комиссии, партнёрские параметры). В ответ возвращает объект заказа с деталями депозита и вывода.

URL

https://dxspot.io/api/v1/orders/public/create

Аутентификация

Заголовок B2B-Bearer-Token обязателен для B2B-интеграций (пример: -H "B2B-Bearer-Token: TOKEN").
Для пользовательских сценариев может использоваться access_token как cookie.

Заголовки

Accept: application/json
Content-Type: application/json
B2B-Bearer-Token: <TOKEN>

Тело запроса (JSON)

{
  "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",
  "browserFingerprint": "string",
  "markup": "0.01",
  "locale": "en"
}

Пример запроса (cURL)

curl -X POST \
  'https://dxspot.io/api/v1/orders/public/create' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'B2B-Bearer-Token: YOUR TOKEN' \
  -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]",
    "rateMode": "FLOATING",
    "browserFingerprint": "string",
    "markup": "0.01",
    "locale": "en"
  }'

Пример ответа (200)

{
  "orderId": 9876,
  "deposits": [
    {
      "createdAt": "2025-08-26T10:08:06.203Z",
      "instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
      "amount": "3300",
      "depositAddress": "0xdeadc0de",
      "txId": null,
      "isPending": true
    }
  ],
  "withdrawals": [],
  "pair": {
    "instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
    "instrumentTo":   { "currencyTitle": "LTC",  "networkTitle": "LTC"   }
  },
  "rateMode": "FLOATING",
  "userEmail": "[email protected]",
  "status": "CREATED",
  "createdAt": "2025-08-26T10:08:06.203Z"
}

Ответы

Код	Описание
`200 OK`	Заказ успешно создан, возвращается объект заказа.
`401 Unauthorized`	Не указан или неверный `B2B-Bearer-Token` или cookie `access_token`.
`422 Unprocessable Entity`	Ошибка валидации входных данных (например, слишком маленькая сумма).
`501`	Ошибка сервера («data is not iterable»).

Примечания

Перед созданием заказа рекомендуется получить курс методом /api/v1/rates/public/one.

При указании rateMode=FIXED курс будет зафиксирован на ограниченное время.

Параметры referrerId и markupAffiliateId используются для партнёрских интеграций.

Ответ может содержать пустые массивы withdrawals, если средства ещё не отправлены.

Code Sample

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
}

API V1 Orders

Documentation

URL

Параметры запроса (Query)

Пример запроса (cURL)

Пример ответа (успех)

Ответы

Примечания

Code Sample

Response Example

Try it out

Headers

Documentation

URL

Требуется авторизация

Заголовки

Тело запроса (JSON)

Пример запроса (cURL)

Ответы

Примечания

Code Sample

Response Example

Try it out

Request Body

Headers

Documentation

Параметры

Пример запроса

Пример ответа (200)

Примечания

Code Sample

Response Example

Try it out

Headers

Documentation

URL

Заголовки

Тело запроса (JSON)

Пример запроса (cURL)

Ответы

Примечания

Code Sample

Try it out

Request Body

Headers

Documentation

URL

Заголовки

Тело запроса (JSON)

Пример запроса (cURL)

Ответы

Примечания

Code Sample

Try it out

Request Body

Headers

Documentation

URL

Параметры запроса (Query)

Ответы

Примечания

Code Sample

Try it out

Headers

Documentation

URL

Требуется авторизация

Заголовки

Параметры

Пример запроса (cURL)

Пример ответа (200)

Ответы

Примечания

Code Sample

Try it out

Headers

Documentation

URL

Аутентификация

Заголовки