Criar ordem limite

post https://api.cryptomus.com/v2/user-api/convert/limit Cópia

Solicitar

Parâmetros de consulta

NomeTipo de parâmetroDefinição
from*stringmax:10Moeda para converter de
to*stringmax:10Moeda para converter para
amount*stringQuantia a ser convertida na moeda de origemSe houver centavos no valor, envie -os com um separador '.'
Exemplo: 10.28
price*stringPreço a converterSe houver centavos no valor, envie -os com um separador '.'
Exemplo: 10.28
stop_loss_pricestring|nullO preço limite de mercado do ativo, ao atingir o qual a ordem será automaticamente canceladaSe houver centavos no valor, envie -os com um separador '.'
Exemplo: 10.28

Tipo de parâmetro

stringmax:10

Definição

Moeda para converter de

Tipo de parâmetro

stringmax:10

Definição

Moeda para converter para

Tipo de parâmetro

string

Definição

Quantia a ser convertida na moeda de origemSe houver centavos no valor, envie -os com um separador '.'
Exemplo: 10.28

Tipo de parâmetro

string

Definição

Preço a converterSe houver centavos no valor, envie -os com um separador '.'
Exemplo: 10.28

Tipo de parâmetro

string|null

Definição

O preço limite de mercado do ativo, ao atingir o qual a ordem será automaticamente canceladaSe houver centavos no valor, envie -os com um separador '.'
Exemplo: 10.28

* - parâmetro obrigatório

Exemplo de solicitação

curl https://api.cryptomus.com/v2/user-api/convert/limit \
    -X POST \
    -H 'userId: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: fe99035f86fa436181717b302b95bacff1' \
    -H 'Content-Type: application/json' \
    -d '{
        "from": "BTC",
        "to": "USDT",
        "amount": "0.0001",
        "price": "70000",
        "stop_loss_price": "0.21"
    }'
Cópia

Resposta

Parâmetros de resposta

NomeTipo de parâmetroDefinição
order_idstringID de conversão
uuidstringUUID do pedido de conversão
convert_amount_fromstring|nullQuantia a ser convertida de
convert_amount_tostring|nullQuantia a ser convertida para
executed_amount_fromstring|nullQuantia executada de
executed_amount_tostring|nullQuantia executada para
convert_currency_fromstring|nullConverter moeda de
convert_currency_tostring|nullConverter moeda para
typestringTipo de enumeraçãoOpções disponíveis:• market• limit
statusstringStatus da enumeraçãoOpções disponíveis:• active• completed• partially_completed• cancelled• expired• failed
created_atstringData e hora de criação
current_ratestring|nullTaxa atual
market_ratestring|nullTaxa de mercado
limitstring|nullValor do limite (somente se o tipo for limite)
expires_atstringData e hora de expiração do limite
completed_atstringData e hora em que o pedido foi concluído (somente se o pedido foi concluído)

Tipo de parâmetro

string

Definição

ID de conversão

Tipo de parâmetro

string

Definição

UUID do pedido de conversão

Tipo de parâmetro

string|null

Definição

Quantia a ser convertida de

Tipo de parâmetro

string|null

Definição

Quantia a ser convertida para

Tipo de parâmetro

string|null

Definição

Quantia executada de

Tipo de parâmetro

string|null

Definição

Quantia executada para

Tipo de parâmetro

string|null

Definição

Converter moeda de

Tipo de parâmetro

string|null

Definição

Converter moeda para

Tipo de parâmetro

string

Definição

Tipo de enumeraçãoOpções disponíveis:- market- limit

Tipo de parâmetro

string

Definição

Status da enumeraçãoOpções disponíveis:- active- completed- partially_completed- cancelled- expired- failed

Tipo de parâmetro

string

Definição

Data e hora de criação

Tipo de parâmetro

string|null

Definição

Taxa atual

Tipo de parâmetro

string|null

Definição

Taxa de mercado

Tipo de parâmetro

string|null

Definição

Valor do limite (somente se o tipo for limite)

Tipo de parâmetro

string

Definição

Data e hora de expiração do limite

Tipo de parâmetro

string

Definição

Data e hora em que o pedido foi concluído (somente se o pedido foi concluído)

Exemplo de resposta


1{
2  "state": 0,
3  "result": {
4    "order_id": "2d9bf426-98ef-448b-84c2-03cc1ec78feb",
5    "uuid": "740a39d1-2edd-4b4d-bf49-826caf324312",
6    "convert_amount_from": "10.000",
7    "convert_amount_to": "3.000",
8    "executed_amount_from": null,
9    "executed_amount_to": null,
10    "convert_currency_from": "USDT",
11    "convert_currency_to": "XMR",
12    "type": "limit",
13    "status": "active",
14    "created_at": "2024-07-11 , 18:06:04",
15    "current_rate": "100",
16    "market_rate": "100",
17    "limit": "70000",
18    "expires_at": "2024-07-12 , 18:06:04"
19  }
20}
Cópia