Equipe Quickex
12 de novembro de 2025
~1 min de leitura
O grupo de métodos Orders é responsável por trabalhar com as ordens — trocas criadas pelos usuários na plataforma Quickex.
Com a ajuda desses métodos, você pode: obter informações públicas sobre uma ordem específica e sobre as trocas mais recentes,
vincular um e-mail a uma ordem para receber notificações, aceitar alterações no modo da taxa de câmbio (por exemplo, mudar de taxa fixa para taxa flutuante), iniciar um reembolso e verificar seu status.
Esses métodos são usados em todas as etapas do ciclo de vida da ordem — do acompanhamento aos reembolsos.
GET
public-info
Endpoint URL
https://quickex.io/api/v1/orders/public-info
Documentation
Retorna informações públicas sobre uma ordem (operação de troca) pelo endereço de destino.
A resposta contém detalhes de depósitos/saques, par de negociação, parâmetros declarados da taxa, eventos da ordem, etc.
URL
https://quickex.io/api/v1/orders/public-info
Parâmetros da requisição (query)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
destinationAddress |
string | sim | O endereço de destino vinculado à ordem. Usado para localizar a ordem. |
Exemplo de requisição (cURL)
curl -X GET \
'https://quickex.io/api/v1/orders/public-info?destinationAddress=0xdeadbeef' \
-H 'Accept: application/json'Exemplo de resposta (sucesso)
{
"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": "test@example.com",
"destinationAddress": "0xdeadbeef"
}Respostas
| Código | Corpo | Descrição |
|---|---|---|
200 OK |
JSON com informações da ordem | A ordem foi encontrada e retornada. |
400 Bad Request |
{"status":"ERR_VALIDATION","message":"Validation Exception", ...} |
Erro de validação (por exemplo, se destinationAddress estiver ausente ou inválido). |
5xx |
— | Erro interno do servidor. |
Observações
- O método retorna dados públicos da ordem; detalhes privados não estão disponíveis.
- Se a ordem ainda não tiver sido criada / não puder ser encontrada pelo endereço, será retornado um erro de validação ou um resultado vazio.
- A estrutura das seções
deposits/withdrawalse dos campos auxiliares pode variar conforme o status da ordem e o provedor de liquidez.
Code Sample
curl -X 'GET' \
'https://quickex.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": "QUICKEX_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": "test@example.com",
"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
Atribui um e-mail a uma ordem existente (operação de troca). O e-mail é usado para enviar notificações sobre o status da ordem e para contato com o suporte.
URL
https://quickex.io/api/v1/orders/public/set-email
Autorização Necessária
Não (método público para uma ordem existente).
Cabeçalhos
Accept: application/jsonContent-Type: application/json
Corpo da requisição (JSON)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
orderId |
number | sim | O identificador da ordem à qual o e-mail deve ser vinculado. |
userEmail |
string (email) | sim | Endereço de e-mail do usuário para notificações. |
{
"orderId": 123456,
"userEmail": "user@example.com"
}Exemplo de requisição (cURL)
curl -X POST \
'https://quickex.io/api/v1/orders/public/set-email' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"orderId": 123456,
"userEmail": "user@example.com"
}'Respostas
| Código | Corpo | Descrição |
|---|---|---|
200 OK |
JSON com informações públicas da ordem (incluindo userEmail) |
E-mail vinculado com sucesso à ordem. |
400 Bad Request |
{"status":"ERR_VALIDATION","message":"Validation Exception", ...} |
Erro de validação (por exemplo, se userEmail não for um e-mail válido). |
5xx |
— | Erro interno do servidor. |
Observações
- Antes de chamar o método, certifique-se de informar um
orderIdválido de uma ordem existente.userEmaildeve ser um endereço de e-mail válido (exemplo de erro:userEmail must be an email).- A resposta bem-sucedida retorna as informações públicas atuais da ordem, em que o campo
userEmailconterá o endereço atribuído.
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v1/orders/public/set-email' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"orderId": {ID},
"userEmail": "user@example.com"
}'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": "QUICKEX_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": "test@example.com",
"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://quickex.io/api/v1/orders/public/latest
Documentation
Retorna uma lista das ordens públicas mais recentes criadas na plataforma Quickex.
Este método não requer parâmetros e fornece informações básicas sobre as trocas recentes (moedas, redes e valores).
Parâmetros
Nenhum
Exemplo de requisição
curl -X 'GET' \
'https://quickex.io/api/v1/orders/public/latest' \
-H 'accept: application/json'Exemplo de resposta (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"
}
]Observações
O método retorna apenas informações públicas (sem dados pessoais do usuário).
Pode ser útil para exibir um widget de “últimas trocas” em um site.
A resposta contém uma lista com número limitado de registros (por exemplo, as últimas 5–10 ordens).
Code Sample
curl -X 'GET' \
'https://quickex.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://quickex.io/api/v1/orders/public/accept-rate-mode-change
Documentation
Confirma a alteração do modo de taxa de uma ordem. É usado em casos em que a ordem foi criada com taxa fixa,
mas durante o processo de troca foi alterada para taxa flutuante (por exemplo, devido a exceder limites ou à alta volatilidade).
O método permite que o usuário aceite o novo modo e continue o processamento da ordem.
URL
https://quickex.io/api/v1/orders/public/accept-rate-mode-change
Cabeçalhos
Accept: application/jsonContent-Type: application/json
Corpo da requisição (JSON)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
orderId |
number | sim | O identificador da ordem para a qual é necessário confirmar a alteração do modo de taxa. |
destinationAddress |
string | sim | O endereço de destino associado à ordem (usado como verificação adicional). |
{
"orderId": 123456,
"destinationAddress": "0xdeadbeef"
}Exemplo de requisição (cURL)
curl -X POST \
'https://quickex.io/api/v1/orders/public/accept-rate-mode-change' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"orderId": 123456,
"destinationAddress": "0xdeadbeef"
}'Respostas
| Código | Descrição |
|---|---|
201 Created |
A alteração do modo de taxa foi confirmada e a ordem segue em processamento. |
404 Not Found |
Ordem não encontrada ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Erro de validação (por exemplo, dados de entrada inválidos). |
5xx |
Erro interno do servidor. |
Observações
- Este método só é chamado se a ordem tiver alterado o seu modo de taxa (por exemplo, de fixa para flutuante).
- Sem confirmação, o processamento da ordem será suspenso.
- Em caso de sucesso, a resposta retorna o status 201 e a ordem continua a ser processada.
Code Sample
curl -X 'POST' \
'https://quickex.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://quickex.io/api/v1/orders/public/request-refund
Documentation
Confirma a alteração do modo de taxa de uma ordem. É usado em casos em que a ordem foi criada com taxa fixa,
mas durante o processo de troca foi alterada para taxa flutuante (por exemplo, devido a exceder limites ou à alta volatilidade).
O método permite que o usuário aceite o novo modo e continue o processamento da ordem.
URL
https://quickex.io/api/v1/orders/public/accept-rate-mode-change
Cabeçalhos
Accept: application/jsonContent-Type: application/json
Corpo da requisição (JSON)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
orderId |
number | sim | O identificador da ordem para a qual é necessário confirmar a alteração do modo de taxa. |
destinationAddress |
string | sim | O endereço de destino associado à ordem (usado como verificação adicional). |
{
"orderId": 123456,
"destinationAddress": "0xdeadbeef"
}Exemplo de requisição (cURL)
curl -X POST \
'https://quickex.io/api/v1/orders/public/accept-rate-mode-change' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"orderId": 123456,
"destinationAddress": "0xdeadbeef"
}'Respostas
| Código | Descrição |
|---|---|
201 Created |
A alteração do modo de taxa foi confirmada e a ordem segue em processamento. |
404 Not Found |
Ordem não encontrada ({"status":"ERR_NOT_FOUND","message":"Order not found"}). |
400 Bad Request |
Erro de validação (por exemplo, dados de entrada inválidos). |
5xx |
Erro interno do servidor. |
Observações
- Este método só é chamado se a ordem tiver alterado o seu modo de taxa (por exemplo, de fixa para flutuante).
- Sem confirmação, o processamento da ordem será suspenso.
- Em caso de sucesso, a resposta retorna o status 201 e a ordem continua a ser processada.
Code Sample
curl -X 'POST' \
'https://quickex.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://quickex.io/api/v1/orders/order-refund-info
Documentation
Retorna informações de reembolso para uma ordem específica.
Usado após criar uma solicitação de reembolso para verificar os detalhes (valor, endereço de reembolso, status).
URL
https://quickex.io/api/v1/orders/order-refund-info
Parâmetros da requisição (query)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
orderId |
string | sim | O identificador da ordem para a qual os dados de reembolso devem ser obtidos. |
curl -X GET \
'https://quickex.io/api/v1/orders/order-refund-info?orderId=1234' \
-H 'Accept: application/json'Respostas
| Código | Descrição |
|---|---|
200 OK |
Retorna JSON com as informações de reembolso (valor, endereço, status, taxas). |
400 Bad Request |
Erro de validação ou dados de ordem inválidos ({"status":"ERR_BAD_REQUEST","message":"Unknown liquidity provider title: ..."}). |
404 Not Found |
Ordem não encontrada. |
5xx |
Erro interno do servidor. |
Observações
- O método retorna dados apenas para ordens nas quais um reembolso foi iniciado.
- Em uma resposta
200bem-sucedida, o JSON pode incluir o valor do reembolso, o endereço de reembolso e as taxas de rede.- Para erros de validação (
400), o servidor informa o motivo no campomessage.
Code Sample
curl -X 'GET' \
'https://quickex.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://quickex.io/api/v1/orders/public/list
Documentation
Retorna uma lista das ordens associadas ao usuário autenticado no momento.
A resposta inclui detalhes de depósitos, saques, parâmetros do par de negociação, status da ordem e outras informações.
URL
https://quickex.io/api/v1/orders/public/list
Autorização Necessária
Sim — um access_token válido deve ser fornecido no cabeçalho.
Cabeçalhos
Accept: application/jsonaccess_token = YOUR_TOKEN
Parâmetros
Nenhum
Exemplo de requisição (cURL)
curl -X GET \
'https://quickex.io/api/v1/orders/public/list' \
-H 'Accept: application/json' \
--cookie "access_token=YOUR_TOKEN"Exemplo de resposta (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"
}
]Respostas
| Código | Descrição |
|---|---|
200 OK |
Retorna um array com as ordens do usuário. |
401 Unauthorized |
O access_token está ausente ou é inválido. |
5xx |
Erro do servidor ao processar a requisição. |
Observações
- Este método retorna apenas as ordens criadas pelo usuário autenticado no momento.
- Para obter informações públicas sobre uma ordem específica, use o método
/api/v1/orders/public-info.- Recomenda-se armazenar em cache os dados das ordens no lado do cliente para reduzir o número de requisições.
Code Sample
curl -X 'GET' \
'https://quickex.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
/api/v1/orders/public/create
Endpoint URL
https://quickex.io/api/v1/orders/public/create
Documentation
Cria uma nova ordem de troca.
O método aceita parâmetros do par de negociação (moedas de envio e de recebimento), valor, endereços do usuário, assim como dados adicionais
(taxa, comissões, parâmetros de afiliados). A resposta retorna um objeto da ordem com detalhes de depósito e saque.
URL
https://quickex.io/api/v1/orders/public/create
Autenticação
- O cabeçalho
B2B-Bearer-Tokené obrigatório para integrações B2B (exemplo:-H "B2B-Bearer-Token: TOKEN"). - Para cenários de usuário,
access_tokenpode ser usado como cookie.
Cabeçalhos
Accept: application/jsonContent-Type: application/jsonB2B-Bearer-Token: <TOKEN>
Corpo da requisição (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": "test@example.com",
"referrerId": "aff_some-affiliate-id",
"markupAffiliateId": "aff_some-affiliate-id",
"rateMode": "FLOATING",
"browserFingerprint": "string",
"markup": "0.01",
"locale": "en"
}Exemplo de requisição (cURL)
curl -X POST \
'https://quickex.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": "test@example.com",
"rateMode": "FLOATING",
"browserFingerprint": "string",
"markup": "0.01",
"locale": "en"
}'Exemplo de resposta (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": "test@example.com",
"status": "CREATED",
"createdAt": "2025-08-26T10:08:06.203Z"
}Respostas
| Código | Descrição |
|---|---|
200 OK |
Ordem criada com sucesso; o objeto da ordem é retornado. |
401 Unauthorized |
O B2B-Bearer-Token ou o cookie access_token está ausente ou é inválido. |
422 Unprocessable Entity |
Erro de validação nos dados de entrada (por exemplo, valor muito baixo). |
501 |
Erro do servidor (“data is not iterable”). |
Observações
- Recomenda-se obter a taxa primeiro usando
/api/v1/rates/public/oneantes de criar uma ordem.- Se
rateMode=FIXEDfor especificado, a taxa ficará bloqueada por tempo limitado.- Os parâmetros
referrerIdemarkupAffiliateIdsão usados para integrações de afiliados.- A resposta pode conter arrays vazios em
withdrawalscaso os fundos ainda não tenham sido enviados.
Code Sample
curl -X 'POST' \
'https://quickex.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": "test@example.com",
"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": "QUICKEX_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": "test@example.com",
"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