Exemplos de como colocar ordens com diferentes parâmetros

Última atualização: 31 de mar. de 2025

Os endpoints REST AddOrder e WebSocket addOrder são usados para colocar ordens em nossos mercados, mas devido à variedade de ordens possíveis (diferentes tipos de ordem, preços variados, tamanhos variados, opções de ordem personalizadas, etc.), existem muitas maneiras diferentes de chamar os endpoints AddOrder/addOrder.

Como sugestões úteis para configurar suas próprias ordens, os exemplos a seguir são chamadas de AddOrder/addOrder com alguns dos parâmetros mais usados. Os exemplos usam nosso cliente de linha de comando da REST API, mas os mesmos parâmetros podem ser usados por meio de qualquer interface de API (curl, Postman, código de API personalizado, etc.).

Ordem a mercado (comprar 50 XDG/USD ao melhor preço disponível)

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=50

{"error":[],"result":{"descr":{"order":"buy 50.00000000 XDGUSD @ market"},"txid":["OFKBX4-NUHFI-JIKLLM"]}}

Ordem limite (vender 50 XDG/USD a US$ 1)

$ ./krakenapi AddOrder pair=xdgusd type=sell ordertype=limit price=1.00 volume=50

{"error":[],"result":{"descr":{"order":"sell 50.00000000 XDGUSD @ limit 1.0000000"},"txid":["O562OP-O6FNI-SEQ23Y"]}}

Ordem limite 'post only' (vender 50 XDG/USD a US$ 1)

$ ./krakenapi AddOrder pair=xdgusd type=sell ordertype=limit price=1.00 volume=50 oflags=post

{"error":[],"result":{"descr":{"order":"sell 50.00000000 XDGUSD @ limit 1.0000000"},"txid":["OWFYJG-DJUOO-F5BISK"]}}

Ordem a mercado com fechamento condicional stop loss (comprar 50 XDG/USD e, em seguida, colocar ordem de venda 5% abaixo)

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=50 'close[ordertype]=stop-loss' 'close[price]=-5%'

{"error":[],"result":{"descr":{"order":"buy 50.00000000 XDGUSD @ market","close":"close position @ stop loss -5.0000%"},"txid":["OW7UJZ-P7F7Z-JAHANL"]}}

Ordem a mercado com fechamento condicional take profit limite (comprar 50 XDG/USD e, em seguida, colocar ordem de venda a US$ 1)

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=50 'close[ordertype]=take-profit-limit' 'close[price]=1.00' 'close[price2]=1.00'

{"error":[],"result":{"descr":{"order":"buy 50.00000000 XDGUSD @ market","close":"close position @ take profit 1.0000000 -> limit 1.0000000"},"txid":["OJ7K64-4PQ5Y-DE7FRG"]}}

Ordem IOC (comprar 50 XDG/USD usando uma ordem Immediate or Cancel)

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=limit price=1.00 volume=50 timeinforce=ioc {"error":[],"result":{"txid":["OZS2KT-JVN2E-J2XM7Z"],"descr":{"order":"buy 50.00000000 XDGUSD @ limit 1.0000000"}}}

Ordem iceberg (vender 50 XDG/USD exibindo apenas 25 XDG/USD para venda)

$ ./krakenapi AddOrder pair=xdgusd type=sell ordertype=limit price=1.00 volume=50 displayvol=25 {"error":[],"result":{"txid":["ODMXEB-NUCVA-QWG6HH"],"descr":{"order":"sell 50.00000000 XDGUSD @ limit 1.0000000"}}}

Ordem a mercado com alavancagem de 5:1 (abrir posição comprada de XBT/USD ao melhor preço disponível)

$ ./krakenapi AddOrder pair=xbtusd type=buy ordertype=market volume=0.0005 leverage=5

{"error":[],"result":{"descr":{"order":"buy 0.00050000 XBTUSD @ market with 5:1 leverage"},"txid":["OXCTLW-XCYRT-MSP4FS"]}}

Ordem de liquidação de posição

$ ./krakenapi AddOrder pair=xbtusd type=buy ordertype=settle-position volume=0 leverage=5

{"error":[],"result":{"descr":{"order":"buy 0.00000000 XBTUSD @ settle position"},"txid":["OYO2FZ-7SYNG-GDBZ6M"]}}

Observe o volume de 0 (zero), que pode ser usado para fechar/liquidar posições de margem sem saber o volume exato.

Detalhes completos de todos os possíveis parâmetros de entrada do endpoint AddOrder estão disponíveis em nossa documentação da REST API e da WebSocket API.