Команда DxSpot

15 июня 2026 г.

~1 мин. чтения

Раздел ордеры (orders) включает методы для создания ордера и добавления электронной почты пользователя к уже существующему ордеру. С помощью доступных методов можно инициировать обмен через создание ордера, а также прикрепить email для уведомлений о его статусе.

GET

orders

Endpoint URL

https://dxspot.io/api/v2/orders/public

Documentation

POST /api/v2/orders/public/set-email

Общее описание
Этот эндпоинт позволяет прикрепить электронную почту пользователя к уже созданному ордеру. После вызова метода в поле userEmail ордера сохраняется переданный адрес, и на него будут отправляться уведомления о смене статуса транзакций.

Параметры

Заголовки (Headers)

Название	Обязателен	Описание
`X-Api-Public-Key`	да	Ваш публичный API-ключ для аутентификации запроса.
`X-Api-Timestamp`	да	Метка времени в формате UNIX (ms). Используется для защиты от повторных запросов.
`X-Api-Signature`	да	HMAC-подпись всего тела запроса, сгенерированная с помощью вашего секретного ключа.

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

Поле	Тип	Обязательное	Описание
`orderId`	number	да	Идентификатор существующего ордера.
`userEmail`	string	да	Электронная почта для уведомлений.

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

curl -X POST 'https://dxspot.io/api/v2/orders/public/set-email' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Public-Key: yourPublicKey' \
  -H 'X-Api-Timestamp: 1691397292905' \
  -H 'X-Api-Signature: yourHmacSignature' \
  -d '{
    "orderId": 12345,
    "userEmail": "[email protected]"
  }'

Возможные ответы

200 OK — почта успешно добавлена.
403 ERR_FORBIDDEN — отсутствуют обязательные заголовки или неверная подпись.

{
  "status": "ERR_FORBIDDEN",
  "message": "Header params is missed!"
}

Use Case

Партнёр-интегратор встраивает обменник Dxspot в своё приложение и хочет после создания ордера автоматически подключить уведомления о зачислениях и выводах на электронную почту пользователя.

Клиент создаёт ордер через /api/v2/orders/public/create.
Сразу после получения orderId отправляется запрос к /api/v2/orders/public/set-email, чтобы закрепить адрес для уведомлений.
Как только средства будут зачислены или выведены, Dxspot отправит письма на указанный userEmail.

Code Sample

Response Example

[
  {
    "orderId": 2096,
    "destinationAddress": "rMZiLhMHDKHSD9mMurzvixQGKFsDNLLP1",
    "createdAt": "2024-11-21T09:57:37.536Z",
    "updatedAt": "2024-11-21T09:57:37.536Z",
    "destinationAddressMemo": null,
    "refundAddress": null,
    "refundAddressMemo": null,
    "claimedDepositAmount": "11905.4",
    "claimedNetworkFee": "0.25",
    "amountToGet": "2000.535980286546",
    "amountToGetUSDT": "0",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "TRX",
    "instrumentFromNetworkTitle": "TRX",
    "instrumentToCurrencyTitle": "XRP",
    "instrumentToNetworkTitle": "XRP",
    "ip": "165.22.73.162",
    "geoCode": "DE",
    "markup": "0",
    "userEmail": "[email protected]",
    "completed": false,
    "state": "created"
  },
  {
    "orderId": 2097,
    "destinationAddress": "rMZiLhMHDKHSD9mMurzvixQGKFsDNLLP1",
    "createdAt": "2024-11-21T09:57:56.849Z",
    "updatedAt": "2024-11-21T09:57:56.849Z",
    "destinationAddressMemo": null,
    "refundAddress": null,
    "refundAddressMemo": null,
    "claimedDepositAmount": "500",
    "claimedNetworkFee": "0.25",
    "amountToGet": "88.201060256891",
    "amountToGetUSDT": "0",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "TRX",
    "instrumentFromNetworkTitle": "TRX",
    "instrumentToCurrencyTitle": "XRP",
    "instrumentToNetworkTitle": "XRP",
    "ip": "165.22.73.162",
    "geoCode": "DE",
    "markup": "0",
    "userEmail": "[email protected]",
    "completed": false,
    "state": "created"
  },
  {
    "orderId": 3038,
    "destinationAddress": "TFjfHBiDcL6B5S5W8g9b6gU2tbvnTR52ya",
    "createdAt": "2025-04-28T13:15:03.006Z",
    "updatedAt": "2025-07-22T10:36:58.557Z",
    "destinationAddressMemo": null,
    "refundAddress": null,
    "refundAddressMemo": null,
    "claimedDepositAmount": "0.034268",
    "claimedNetworkFee": "1.5",
    "amountToGet": "3263.05",
    "amountToGetUSDT": "3263.058154",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "BTC",
    "instrumentFromNetworkTitle": "BTC",
    "instrumentToCurrencyTitle": "USDT",
    "instrumentToNetworkTitle": "TRC20",
    "ip": "45.76.90.73",
    "geoCode": "DE",
    "markup": "0",
    "userEmail": "[email protected]",
    "completed": false,
    "state": "created"
  },
  {
    "orderId": 3172,
    "destinationAddress": "TPjT9p6UK5omA19h1QuYf4HbWvB9CukMzx",
    "createdAt": "2025-11-25T07:52:52.871Z",
    "updatedAt": "2025-11-27T11:34:19.690Z",
    "destinationAddressMemo": null,
    "refundAddress": null,
    "refundAddressMemo": null,
    "claimedDepositAmount": "52",
    "claimedNetworkFee": "2.054188275293",
    "amountToGet": "419.2",
    "amountToGetUSDT": "114.402051690569",
    "amountToWithdrawFact": "417.825363",
    "amountToWithdrawFactUSDT": "114.0245415627",
    "instrumentFromCurrencyTitle": "XRP",
    "instrumentFromNetworkTitle": "XRP",
    "instrumentToCurrencyTitle": "TRX",
    "instrumentToNetworkTitle": "TRX",
    "ip": "77.246.100.22",
    "geoCode": "NL",
    "markup": "0",
    "userEmail": "[email protected]",
    "completed": true,
    "state": "withdraw"
  },
  {
    "orderId": 3192,
    "destinationAddress": "15vvDFQFksUS4r1cYxmjZuTVVUzWZSJauuUapg7Xjhgtkwqy",
    "createdAt": "2025-12-02T14:11:15.985Z",
    "updatedAt": "2025-12-02T14:11:16.107Z",
    "destinationAddressMemo": null,
    "refundAddress": "UQCGxjLy3msAFWG4r310Sk_rOz27QWRy252fdLMWJAMQJvSE",
    "refundAddressMemo": null,
    "claimedDepositAmount": "3300",
    "claimedNetworkFee": "0.14",
    "amountToGet": "2363.663",
    "amountToGetUSDT": "4999.384629917638",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "TON",
    "instrumentFromNetworkTitle": "TON",
    "instrumentToCurrencyTitle": "DOT",
    "instrumentToNetworkTitle": "DOT",
    "ip": "77.246.100.22",
    "geoCode": "NL",
    "markup": "0",
    "userEmail": null,
    "completed": false,
    "state": "created"
  },
  {
    "orderId": 3193,
    "destinationAddress": "15vvDFQFksUS4r1cYxmjZuTVVUzWZSJauuUapg7Xjhgtkwqy",
    "createdAt": "2025-12-02T14:14:34.356Z",
    "updatedAt": "2025-12-02T14:14:34.557Z",
    "destinationAddressMemo": null,
    "refundAddress": "UQCGxjLy3msAFWG4r310Sk_rOz27QWRy252fdLMWJAMQJvSE",
    "refundAddressMemo": null,
    "claimedDepositAmount": "73",
    "claimedNetworkFee": "0.14",
    "amountToGet": "52.235",
    "amountToGetUSDT": "110.556162356583",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "TON",
    "instrumentFromNetworkTitle": "TON",
    "instrumentToCurrencyTitle": "DOT",
    "instrumentToNetworkTitle": "DOT",
    "ip": "77.246.100.22",
    "geoCode": "NL",
    "markup": "0",
    "userEmail": null,
    "completed": false,
    "state": "created"
  }
]

Try it out

POST

orders/public/create

Endpoint URL

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

Documentation

POST /api/v2/orders/public/create

Общее описание
Создаёт новый ордер для обмена криптовалют. Возвращает все детали ордера: адреса для депозита и вывода, параметры курса, события и ссылки для дальнейшей обработки.

Параметры

Заголовки (Headers)

Название	Обязателен	Описание
`B2B-Bearer-Token`	да	Bearer-токен для аутентификации через Mercuryo.
`X-Api-Public-Key`	да	Ваш публичный API-ключ.
`X-Api-Timestamp`	да	Метка времени в формате UNIX (ms).
`X-Api-Signature`	да	HMAC-подпись тела запроса вашим секретным ключом.

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

Поле	Тип	Обязательное	Описание
`instrumentFrom`	object	да	Исходная валюта и сеть (currencyTitle/networkTitle).
`instrumentTo`	object	да	Целевая валюта и сеть.
`destinationAddress`	string	да	Адрес для получения обменянных средств.
`destinationAddressMemo`	string	нет	Доп. метка для адреса (Memo/Tag).
`refundAddress`	string	да	Адрес возврата при ошибке обмена.
`refundAddressMemo`	string	нет	Memo/Tag для возвратного адреса.
`claimedDepositAmount`	string	да	Сумма, которую пользователь заявляет внести.
`claimedPublicRate`	object	нет	Заявленный курс: цена, время обновления и ожидаемая сумма к получению.
`claimedNetworkFee`	string	нет	Заявленная сетевая комиссия.
`userEmail`	string	нет	Email для уведомлений.
`legacyOrderId`	string	нет	Внешний идентификатор ордера из старой системы.
`referrerId`	string	нет	ID реферера для партнёрской программы.
`markupAffiliateId`	string	нет	ID аффилиата для начисления маржи.
`rateMode`	string	нет	Тип курса: `FLOATING` или `FIXED`.
`utmData`	object	нет	UTM-метки для аналитики.
`browserFingerprint`	string	нет	Фингерпринт браузера для защиты от мошенничества.
`markup`	string	нет	Процент маржи.
`mercuryoBearerToken`	string	нет	Токен Mercuryo для опциональной интеграции.
`locale`	string	нет	Языковой локаль ответа (например, `en`, `ru`).

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

curl -X POST 'https://dxspot.io/api/v2/orders/public/create' \
  -H 'accept: application/json' \
  -H 'B2B-Bearer-Token: yourMercuryoToken' \
  -H 'X-Api-Public-Key: yourPublicKey' \
  -H 'X-Api-Timestamp: 1691397873000' \
  -H 'X-Api-Signature: yourHmacSignature' \
  -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",
    "mercuryoBearerToken": "string",
    "locale": "ru"
  }'

Возможные ответы

200 OK — ордер успешно создан, возвращается полная структура ордера.
401 ERR_UNAUTHORIZED — неверные или отсутствующие токены/ключи.

{
  "status": "ERR_UNAUTHORIZED",
  "message": "Unauthorized"
}

Use Case

Партнёрская платформа хочет автоматически создавать ордера при оплате пользователя через Mercuryo. После завершения аутентификации Mercuryo выдаёт B2B-Bearer-Token, платформа формирует детали обмена и вызывает этот метод для создания ордера на Dxspot.

Code Sample

Response Example

{
  "deposits": [
    {
      "createdAt": "2025-12-02T08:52:08.178Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "confirmations": 0,
      "txId": "0xdeadc0dedeadbeef",
      "depositAddress": "0xdeadc0de",
      "isPending": true,
      "id": 0,
      "counterPartyAddress": "0xdeadc0dedeadbeef"
    }
  ],
  "withdrawals": [
    {
      "createdAt": "2025-12-02T08:52:08.178Z",
      "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-12-02T08:52:08.179Z",
  "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-12-02T08:52:08.179Z",
    "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-12-02T08:52:08.179Z"
    }
  ],
  "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

POST

orders/public/set-email

Endpoint URL

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

Documentation

Обзор

Этот метод позволяет установить email для уже созданного публичного ордера.

Он используется, когда ордер был создан без userEmail в запросе /api/v2/orders/public/create, но позже нужно привязать email (например, чтобы пользователь мог получать уведомления о статусе ордера).

> Важно: email можно установить только один раз. Если у ордера уже есть userEmail, его нельзя изменить через этот метод.

HTTP-запрос

Метод: POST
URL: https://dxspot.io/api/v2/orders/public/set-email

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

curl -X 'POST' \
  'https://dxspot.io/api/v2/orders/public/set-email' \
  -H 'accept: application/json' \
  -H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
  -H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
  -H 'X-Api-Signature: {SIGNATURE}' \
  -H 'Content-Type: application/json' \
  -d '{
  "orderId": 3038,
  "userEmail": "[email protected]"
}'

Заголовки

Заголовок	Обязательный	Описание
`Accept`	да	Рекомендуемое значение: `application/json`.
`Content-Type`	да	application/json.
`X-Api-Public-Key`	да	Ваш публичный ключ API.
`X-Api-Timestamp`	да	Метка времени (обычно UNIX в мс), включается в подпись.
`X-Api-Signature`	да	Подпись запроса (HMAC SHA256 согласно схеме API v2).

Параметры запроса

Параметры тела

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

Поле	Тип	Обязательный	Описание
`orderId`	number	да	ID ордера, для которого вы хотите установить email.
`userEmail`	string	да	Email пользователя, который будет привязан к ордеру и использован для уведомлений.

Ограничения: если для этого ордера userEmail уже установлен, метод вернет ошибку 403 ERR_FORBIDDEN.

Формат ответа

Если запрос выполнен успешно, метод возвращает JSON-объект ордера, похожий на ответ от POST /api/v2/orders/public/create / GET /api/v2/orders/info, но с установленным полем userEmail.

Пример ответа

{
  "deposits": [
    {
      "createdAt": "2025-12-02T09:31:46.246Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "confirmations": 0,
      "txId": "0xdeadc0dedeadbeef",
      "depositAddress": "0xdeadc0de",
      "isPending": true,
      "id": 0,
      "counterPartyAddress": "0xdeadc0dedeadbeef"
    }
  ],
  "withdrawals": [
    {
      "createdAt": "2025-12-02T09:31:46.246Z",
      "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-12-02T09:31:46.246Z",
  "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-12-02T09:31:46.246Z",
    "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-12-02T09:31:46.246Z"
    }
  ],
  "userEmail": "[email protected]",
  "rateMode": "FLOATING",
  "destinationAddress": "0xdeadbeef",
  "destinationAddressMemo": "0xdeadbeef",
  "completed": false,
  "possibleCashbackAmountUSDT": "500.00",
  "redirectUrl": "https://payments.mercuryo.io/",
  "minConfirmationsToTrade": 3,
  "minConfirmationsToWithdraw": 3
}

Ключевой момент: поле userEmail, привязанное к ордеру, будет заполнено в ответе.

Ошибки

403 ERR_FORBIDDEN — Email уже установлен

{
  "status": "ERR_FORBIDDEN",
  "message": "Order.userEmail already set and can not be modified"
}

Эта ошибка возвращается, если вы пытаетесь изменить email у ордера, для которого userEmail уже был установлен (либо при создании ордера, либо в предыдущем вызове set-email).

Что делать:

Email нельзя изменить для ордеров, у которых email уже установлен.

Возможные сценарии использования

Добавление email для ордеров, созданных анонимно (например, через виджет без обязательного поля email).

Code Sample

Response Example

{
  "deposits": [
    {
      "createdAt": "2025-12-02T09:31:46.246Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "confirmations": 0,
      "txId": "0xdeadc0dedeadbeef",
      "depositAddress": "0xdeadc0de",
      "isPending": true,
      "id": 0,
      "counterPartyAddress": "0xdeadc0dedeadbeef"
    }
  ],
  "withdrawals": [
    {
      "createdAt": "2025-12-02T09:31:46.246Z",
      "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-12-02T09:31:46.246Z",
  "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-12-02T09:31:46.246Z",
    "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-12-02T09:31:46.246Z"
    }
  ],
  "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

GET

orders/public-info

Endpoint URL

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

Documentation

Обзор

Этот метод возвращает подробную информацию по конкретному ордеру по его orderId.
В отличие от списка ордеров (GET /api/v2/orders), он возвращает все данные, связанные с выбранным ордером:
полную пару инструментов с параметрами, фиксированный курс (claimedPublicRate),
лимиты подтверждений, историю событий (orderEvents), депозитный адрес,
а также информацию о возможном кэшбэке/начислениях по рефералам и статус завершения.
Доступ к ордерам ограничен текущим API-ключом: вы можете видеть только те ордера, которые были созданы
с использованием вашего X-Api-Public-Key.

HTTP-запрос

Метод: GET
URL: https://dxspot.io/api/v2/orders/public-info

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

curl -X 'GET' \
  'https://dxspot.io/api/v2/orders/public-info?orderId=3038' \
  -H 'accept: application/json' \
  -H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
  -H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
  -H 'X-Api-Signature: {SIGNATURE}'

Заголовки

Заголовок	Обязательный	Описание
Accept	да	Рекомендуемое значение: `application/json`.
X-Api-Public-Key	да	Ваш публичный ключ API.
X-Api-Timestamp	да	Метка времени (обычно UNIX в мс), включается в подпись.
X-Api-Signature	да	Подпись запроса (HMAC SHA256 согласно схеме API v2).

Параметры запроса

Query-параметры

Параметр	Тип	Обязательный	Описание
orderId	int	да	Идентификатор ордера, по которому запрашивается информация.

Формат ответа

Метод возвращает JSON-объект с полной информацией об ордере.

Пример ответа

{
  "orderId": 174059,
  "legacyOrderId": "602184da-5881-408e-bffa-3562702d7d3e",
  "pair": {
    "instrumentFrom": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP",
      "precisionDecimals": 2,
      "slug": "xrp",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 12,
          "minConfirmationsToWithdraw": 12
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "TRX",
      "networkTitle": "TRX",
      "precisionDecimals": 2,
      "slug": "trx",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },
  "createdAt": "2025-12-15T14:38:40.523Z",
  "instrumentFromCurrencyTitle": "XRP",
  "instrumentFromNetworkTitle": "XRP",
  "instrumentToCurrencyTitle": "TRX",
  "instrumentToNetworkTitle": "TRX",
  "feeMode": "FIXED",
  "userId": 2382,
  "userEmail": "[email protected]",
  "isPlatformEmail": false,
  "refundAddress": "rNFSruW9B1NwVoGgUMmfwXbruWMp8Mgv3K",
  "refundAddressMemo": null,
  "destinationAddress": "TWRW8YiZtjW7JkYxxzuPrN9fQzoDK5FHgm",
  "destinationAddressMemo": null,
  "claimedNetworkFee": "1.987665024814",
  "rateMode": "FIXED",
  "claimedDepositAmount": "57",
  "amountToGet": "393.07",
  "platformFee": "3.86",
  "redirectUrl": null,
  "orderEvents": [
    {
      "createdAt": "2025-12-15T14:42:43.317Z",
      "kind": "WITHDRAWAL_COMPLETED"
    },
    {
      "createdAt": "2025-12-15T14:41:54.109Z",
      "kind": "FUNDS_WITHDRAWAL_START"
    },
    {
      "createdAt": "2025-12-15T14:41:00.379Z",
      "kind": "DEPOSIT_REGISTERED"
    },
    {
      "createdAt": "2025-12-15T14:39:58.760Z",
      "kind": "INCOMING_FUNDS_DETECTED"
    },
    {
      "createdAt": "2025-12-15T14:38:41.642Z",
      "kind": "CREATION_END"
    }
  ],
  "depositAddress": {
    "instrument": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP"
    },
    "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
    "depositAddressMemo": "2097040307"
  },
  "deposits": [
    {
      "id": 50958,
      "counterPartyAddress": null,
      "createdAt": "2025-12-15T14:39:45.000Z",
      "instrument": {
        "currencyTitle": "XRP",
        "networkTitle": "XRP"
      },
      "amount": "57",
      "amountUSDT": "112.40742",
      "txId": "DEA15CCF7AF04799A090298CB06D78DD177B3B518BED9C9DE8A0A5B717CCDBE7",
      "confirmations": 12,
      "depositAddress": {
        "instrument": {
          "currencyTitle": "XRP",
          "networkTitle": "XRP"
        },
        "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
        "depositAddressMemo": "2097040307"
      },
      "isPending": false
    }
  ],
  "withdrawals": [
    {
      "instrument": {
        "currencyTitle": "TRX",
        "networkTitle": "TRC20"
      },
      "amount": "393.07",
      "txId": "39dc5802a931da0613f687087397e812dd6c0aa0b9041124d76e864e37bd1e09",
      "createdAt": "2025-12-15T14:41:58.926Z",
      "networkFee": "1.98"
    }
  ],
  "KYCFormLink": null,
  "liquidityProviderPublicCode": "hat",
  "possibleRefferalAccrualAmount": "0.78",
  "possibleCashbackAmountUSDT": "0.22",
  "actualCashbackAmountUSDT": "0.22",
  "claimedPublicRate": {
    "claimedAmountToReceive": "393.07",
    "finalNetworkFeeAmount": "1.9876650248138958",
    "platformFee_Absolute": null,
    "price": "7.000992555831266",
    "quotes": {
      "sellQuote": {
        "baseValue": "0.2821",
        "quoteValue": "1.9453930016929823"
      },
      "buyQuote": {
        "baseValue": "1.97499",
        "quoteValue": "0.2777753832835882"
      }
    },
    "updatedAt": "2025-12-15T14:38:36.201Z",
    "instrumentFrom": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP",
      "precisionDecimals": 2,
      "slug": "xrp",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 12,
          "minConfirmationsToWithdraw": 12
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "TRX",
      "networkTitle": "TRX",
      "precisionDecimals": 2,
      "slug": "trx",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },
  "completed": true,
  "minConfirmationsToTrade": 12,
  "minConfirmationsToWithdraw": 12
}

Расшифровка полей ответа

Ниже приведены ключевые поля ответа. Некоторые вложенные структуры (например, instrumentFrom / instrumentTo) по структуре похожи на объекты из методов /instruments и /rates.

Общая информация об ордере

Поле	Тип	Описание
orderId	number	Уникальный идентификатор ордера в системе Dxspot.
legacyOrderId	string	Идентификатор ордера в legacy-системе (если используется для миграции/совместимости).
createdAt	string	Время создания ордера (ISO8601).
instrumentFromCurrencyTitle	string	Код исходной валюты (например, `BTC`).
instrumentFromNetworkTitle	string	Исходная сеть (например, `BTC`).
instrumentToCurrencyTitle	string	Код целевой валюты (например, `USDT`).
instrumentToNetworkTitle	string	Целевая сеть (например, `TRC20`).
feeMode	string	Режим комиссии ордера: • `FLOATING` – комиссия может меняться в зависимости от условий сети или типа рынка. • `FIXED` – комиссия фиксируется в момент создания ордера.
rateMode	string	Режим курса: • `FIXED` – курс фиксируется при создании ордера; сумма к получению не меняется. • `FLOATING` – курс может колебаться до завершения ордера; сумма к получению обновляется согласно текущим рыночным условиям.
claimedDepositAmount	string	Сумма депозита, использованная при создании ордера.
amountToGet	string	Сумма, которую пользователь должен получить по этому ордеру.
claimedNetworkFee	string	Сетевая комиссия, учтенная в расчете ордера.
platformFee	string	Комиссия платформы.
redirectUrl	string	URL для редиректа на внешний сервис.
completed	boolean	Флаг завершения ордера: `true` — обмен завершен, `false` — в процессе.
minConfirmationsToTrade	number	Минимальные подтверждения, чтобы депозит считался доступным для обмена.
minConfirmationsToWithdraw	number	Минимальные подтверждения, необходимые для вывода.

Пара инструментов (pair)

  "pair": {
    "instrumentFrom": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP",
      "precisionDecimals": 2,
      "slug": "xrp",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 12,
          "minConfirmationsToWithdraw": 12
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "TRX",
      "networkTitle": "TRX",
      "precisionDecimals": 2,
      "slug": "trx",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },

Поле	Тип	Описание
instrumentFrom	object	Исходный инструмент: валюта, которую пользователь отправляет.
instrumentFrom.currencyTitle	string	Код валюты исходного инструмента (например, XRP).
instrumentFrom.networkTitle	string	Блокчейн-сеть исходного инструмента.
instrumentFrom.precisionDecimals	number	Количество поддерживаемых знаков после запятой для сумм.
instrumentFrom.slug	string	Внутренний идентификатор валюты.
instrumentFrom.liquidityProviderCurrencies	array	Настройки провайдера ликвидности для этой валюты и сети.
instrumentFrom.liquidityProviderCurrencies.minConfirmationsToTrade	number	Минимальные подтверждения, чтобы использовать депозит в обмене.
instrumentFrom.liquidityProviderCurrencies.minConfirmationsToWithdraw	number	Минимальные подтверждения перед разрешением вывода.
instrumentTo	object	Целевой инструмент: валюта, которую пользователь получает.
instrumentTo.currencyTitle	string	Код валюты целевого инструмента (например, TRX).
instrumentTo.networkTitle	string	Блокчейн-сеть целевого инструмента.
instrumentTo.precisionDecimals	number	Количество поддерживаемых знаков после запятой для сумм.
instrumentTo.slug	string	Внутренний идентификатор валюты.
instrumentTo.liquidityProviderCurrencies	array	Настройки провайдера ликвидности для этой валюты и сети.
instrumentTo.liquidityProviderCurrencies.minConfirmationsToTrade	number	Минимальные подтверждения до того, как средства могут быть обменены.
instrumentTo.liquidityProviderCurrencies.minConfirmationsToWithdraw	number	Минимальные подтверждения до того, как средства могут быть выведены.

orderEvents

  "orderEvents": [
    {
      "createdAt": "2025-12-15T14:42:43.317Z",
      "kind": "WITHDRAWAL_COMPLETED"
    },
    {
      "createdAt": "2025-12-15T14:41:54.109Z",
      "kind": "FUNDS_WITHDRAWAL_START"
    },
    {
      "createdAt": "2025-12-15T14:41:00.379Z",
      "kind": "DEPOSIT_REGISTERED"
    },
    {
      "createdAt": "2025-12-15T14:39:58.760Z",
      "kind": "INCOMING_FUNDS_DETECTED"
    },
    {
      "createdAt": "2025-12-15T14:38:41.642Z",
      "kind": "CREATION_END"
    }
  ],

Поле	Тип	Описание
orderEvents	array	Список событий, описывающих жизненный цикл ордера (в хронологическом порядке).
orderEvents[].createdAt	string (ISO 8601)	Метка времени, когда произошло событие.
orderEvents[].kind	string	Тип события ордера.

Возможные значения orderEvents[].kind

Значение	Описание
CREATION_END	Ордер успешно создан.
INCOMING_FUNDS_DETECTED	В блокчейне обнаружена входящая депозитная транзакция.
DEPOSIT_REGISTERED	Депозит получил необходимые подтверждения и был зачислен.
FUNDS_WITHDRAWAL_START	Инициирована транзакция вывода средств.
WITHDRAWAL_COMPLETED	Средства успешно отправлены на адрес назначения.

Объект depositAddress

  "depositAddress": {
    "instrument": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP"
    },
    "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
    "depositAddressMemo": "2097040307"
  },

Поле	Тип	Описание
depositAddress	object	Детали депозита для исходного инструмента.
depositAddress.instrument	object	Инструмент и сеть, используемые для депозита.
depositAddress.instrument.currencyTitle	string	Код валюты депозитного инструмента (например, XRP).
depositAddress.instrument.networkTitle	string	Блокчейн-сеть, используемая для депозита.
depositAddress.depositAddress	string	Блокчейн-адрес, на который пользователь должен отправить средства.
depositAddress.depositAddressMemo	string \| null	Memo / tag, требуемый для депозита (например, XRP Destination Tag). Должен быть указан, если он предоставлен.

Массив deposits

"deposits": [
  {
    "id": 50958,
    "counterPartyAddress": null,
    "createdAt": "2025-12-15T14:39:45.000Z",
    "instrument": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP"
    },
    "amount": "57",
    "amountUSDT": "112.40742",
    "txId": "DEA15CCF7AF04799A090298CB06D78DD177B3B518BED9C9DE8A0A5B717CCDBE7",
    "confirmations": 12,
    "depositAddress": {
      "instrument": {
        "currencyTitle": "XRP",
        "networkTitle": "XRP"
      },
      "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
      "depositAddressMemo": "2097040307"
    },
    "isPending": false
  }
]

Поле	Тип	Описание
deposits[]	array	Список депозитных транзакций, связанных с ордером.
deposits[].id	number	Внутренний идентификатор депозитной транзакции.
deposits[].counterPartyAddress	string \| null	Адрес контрагента, отправившего депозит, если известен.
deposits[].createdAt	string (ISO 8601)	Время, когда депозитная транзакция была зафиксирована в системе.
deposits[].instrument	object	Инструмент и сеть внесенной валюты.
deposits[].instrument.currencyTitle	string	Код валюты депозита (например, XRP).
deposits[].instrument.networkTitle	string	Блокчейн-сеть депозита (например, XRP).
deposits[].amount	string	Сумма депозита в исходном токене.
deposits[].amountUSDT	string	Эквивалент депозита в USDT на момент депозита.
deposits[].txId	string	ID депозитной транзакции в блокчейне.
deposits[].confirmations	number	Количество подтверждений блокчейна по этому депозиту.
deposits[].depositAddress	object	Объект депозитного адреса, на который были отправлены средства (см. блок `depositAddress`).
deposits[].isPending	boolean	Показывает, находится ли депозит в ожидании (true) или подтвержден/зачислен (false).

Массив withdrawals

"withdrawals": [
  {
    "instrument": {
      "currencyTitle": "TRX",
      "networkTitle": "TRC20"
    },
    "amount": "393.07",
    "txId": "39dc5802a931da0613f687087397e812dd6c0aa0b9041124d76e864e37bd1e09",
    "createdAt": "2025-12-15T14:41:58.926Z",
    "networkFee": "1.98"
  }
]

Поле	Тип	Описание
withdrawals[]	array	Список транзакций вывода по ордеру.
withdrawals[].instrument	object	Инструмент и сеть выводимой валюты.
withdrawals[].instrument.currencyTitle	string	Код выводимой валюты (например, TRX).
withdrawals[].instrument.networkTitle	string	Блокчейн-сеть, используемая для вывода (например, TRC20).
withdrawals[].amount	string	Сумма вывода в исходном токене.
withdrawals[].txId	string	ID транзакции вывода в блокчейне.
withdrawals[].createdAt	string (ISO 8601)	Время создания вывода.
withdrawals[].networkFee	string	Сетевая комиссия, списанная за транзакцию вывода.

Возможные сценарии использования

Получение полных деталей конкретного ордера, чтобы отображать полную историю транзакций, статус и связанные финансовые данные в аккаунте пользователя/партнерской панели или для целей сверки и аудита.

Code Sample

Response Example

{
  "orderId": 3038,
  "legacyOrderId": "4602ddf9-e516-4c3a-9146-7bc748edd89b",
  "pair": {
    "instrumentFrom": {
      "currencyTitle": "BTC",
      "networkTitle": "BTC",
      "precisionDecimals": 7,
      "slug": "btc",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20",
      "precisionDecimals": 5,
      "slug": "usdttrc20",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },
  "createdAt": "2025-04-28T13:15:03.006Z",
  "instrumentFromCurrencyTitle": "BTC",
  "instrumentFromNetworkTitle": "BTC",
  "instrumentToCurrencyTitle": "USDT",
  "instrumentToNetworkTitle": "TRC20",
  "feeMode": "FLOATING",
  "userId": 229,
  "userEmail": "[email protected]",
  "isPlatformEmail": false,
  "refundAddress": null,
  "refundAddressMemo": null,
  "destinationAddress": "TFjfHBiDcL6B5S5W8g9b6gU2tbvnTR52ya",
  "destinationAddressMemo": null,
  "claimedNetworkFee": "1.5",
  "rateMode": "FLOATING",
  "claimedDepositAmount": "0.034268",
  "amountToGet": "3263.05",
  "platformFee": null,
  "redirectUrl": null,
  "orderEvents": [
    {
      "createdAt": "2025-04-28T13:15:03.021Z",
      "kind": "CREATION_END"
    }
  ],
  "depositAddress": {
    "instrument": {
      "currencyTitle": "BTC",
      "networkTitle": "BTC"
    },
    "depositAddress": "3LpR1ZKEVysoi6sxFqoGtB49638RsxzKSh",
    "depositAddressMemo": null
  },
  "deposits": [],
  "withdrawals": [],
  "KYCFormLink": null,
  "liquidityProviderPublicCode": "hat",
  "possibleRefferalAccrualAmount": "3.01",
  "possibleCashbackAmountUSDT": "0",
  "actualCashbackAmountUSDT": null,
  "claimedPublicRate": {
    "claimedAmountToReceive": "3259.38",
    "finalNetworkFeeAmount": "1.5",
    "price": "95158.1",
    "quotes": {
      "sellQuote": {
        "baseValue": "1",
        "quoteValue": "95114.32743505127"
      },
      "buyQuote": {
        "baseValue": "95158",
        "quoteValue": "0.9995400016924599"
      }
    },
    "updatedAt": "2025-04-28T13:11:30.251Z",
    "instrumentFrom": {
      "currencyTitle": "BTC",
      "networkTitle": "BTC",
      "precisionDecimals": 7,
      "slug": "btc",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20",
      "precisionDecimals": 5,
      "slug": "usdttrc20",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },
  "completed": false,
  "minConfirmationsToTrade": 3,
  "minConfirmationsToWithdraw": 3
}

Try it out

POST

accept-rate-mode-change

Endpoint URL

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

Documentation

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

URL

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

Заголовки

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

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

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

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

POST

request-refund

Endpoint URL

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

Documentation

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

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

Code Sample

Try it out

GET

order-refund-info

Endpoint URL

https://dxspot.io/api/v2/orders/order-refund-info

Documentation

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

URL

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

Заголовки

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

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

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

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

Поделиться статьей:

Orders API V2

Documentation

POST /api/v2/orders/public/set-email

Параметры

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

Возможные ответы

Use Case

Code Sample

Response Example

Try it out

Query Parameters

Headers

Documentation

POST /api/v2/orders/public/create

Параметры

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

Возможные ответы

Use Case

Code Sample

Response Example

Try it out

Request Body

Headers

Documentation

Обзор

HTTP-запрос

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

Заголовки

Параметры запроса

Параметры тела

Формат ответа

Пример ответа

Ошибки

403 ERR_FORBIDDEN — Email уже установлен

Возможные сценарии использования

Code Sample

Response Example

Try it out

Request Body

Headers

Documentation

Обзор

HTTP-запрос

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

Заголовки

Параметры запроса

Query-параметры

Формат ответа

Пример ответа

Расшифровка полей ответа

Общая информация об ордере

Пара инструментов (pair)

orderEvents

Возможные значения orderEvents[].kind

Объект depositAddress

Массив deposits

Массив withdrawals

Возможные сценарии использования

Code Sample

Response Example

Try it out

Query Parameters

Headers

Documentation

URL

Заголовки

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

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

Ответы

Примечания

Code Sample

Try it out

Request Body

Headers

Documentation

URL

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

Ответы

Примечания

Code Sample