Ir para conteúdo principal

PrimeXBT MCP: ferramentas disponíveis

Importante: Operar produtos alavancados envolve alto risco de perda de dinheiro. Seu assistente de IA pode cometer erros. Sempre verifique o card da ordem antes de confirmar uma operação.

Depois de conectado, seu assistente de IA pode usar as ferramentas da PrimeXBT listadas abaixo. Não é preciso chamá-las pelo nome: basta pedir em linguagem simples, e o assistente escolhe a ferramenta certa. Os nomes estão listados para que você possa reconhecê-los na atividade do assistente.

Além das ferramentas, o assistente conta com uma base de conhecimento integrada da PrimeXBT. Ela abrange contas hedge e netting, perpétuos e CFDs (por exemplo, BTC/USDT paga funding, enquanto BTC/USD paga swap), stop loss e take profit como ordens separadas, alavancagem dinâmica e isolada, e contas demo e reais. Isso ajuda o assistente a responder corretamente a perguntas como “Por que minha venda abriu uma segunda posição?”

Conta e posições

Disponível com os acessos Somente leitura e Leitura e trading.

Ferramenta

O que faz

list_accounts

Contas disponíveis na conexão: ID, moeda, demo ou real e modo de posição (hedge ou netting)

get_account_snapshot

Visão geral em uma única chamada: saldo, patrimônio, lucro/prejuízo não realizado, margem disponível e todas as posições abertas, exibidos em um card

get_account_metrics

Saldo, patrimônio, lucro/prejuízo, margem utilizada e disponível. Responde a “quanto posso arriscar?” e “estou perto de uma margin call?”

list_positions

Posições abertas. Em uma conta hedge, cada perna aparece em uma linha separada

list_net_positions

Posição líquida por instrumento, como exibida no terminal

list_orders

Ordens ativas, incluindo o stop loss e o take profit das suas posições

list_order_history

Ordens executadas, canceladas e rejeitadas, com o motivo

list_fills

Execuções reais, incluindo o preço real de execução de uma ordem a mercado

explain_order

Tudo sobre uma ordem: como terminou e todas as suas execuções

Mercados

Disponível com os acessos Somente leitura e Leitura e trading.

Ferramenta

O que faz

find_symbol

Encontra um instrumento pelo ticker, par ou nome (por exemplo, “bitcoin” → BTC/USDT)

get_quotes

Bid e ask atuais, incluindo o spread da sua conta

get_order_book

Livro de ordens, incluindo o spread da sua conta

get_bars

Histórico de preços (OHLCV) de 1 minuto a 1 mês, exibido em gráfico

screen_symbols

Maiores altas, maiores baixas e instrumentos com maior volume em 24 horas, com filtro por categoria (criptomoedas, forex e outras)

Condições de trading

Disponível com os acessos Somente leitura e Leitura e trading. Essas ferramentas retornam as condições da sua conta, e não valores genéricos.

Ferramenta

O que faz

get_symbol

Condições da sua conta para um instrumento: tamanho mínimo e máximo, incremento de tamanho e de preço, taxa, financiamento, alavancagem, tipo de margem e limite de exposição

list_trade_settings

Custos de negociação e de manutenção de posições em todos os instrumentos: taxas maker e taker, funding ou swap e o horário da próxima cobrança, e alavancagem

get_leverage

Alavancagem atual e máxima por instrumento

Trading

Disponível apenas com o acesso Leitura e trading. Toda ação de trading passa primeiro por uma prévia: o assistente mostra o card da ordem com números calculados pelo motor da PrimeXBT, e a ação só é executada depois que você confirma.

Ferramenta de prévia

Ferramenta de ação

O que faz

preview_order

place_order

Nova ordem: margem, preço esperado, nível de liquidação, stop loss e take profit

preview_modify_order

modify_order

Altera o preço ou o tamanho de uma ordem ativa e mostra o efeito na margem

preview_cancel_order

cancel_order

Primeiro mostra que ordem é (uma entrada ou o stop de uma posição) e depois a cancela

preview_close_position

close_position

Fecha uma posição e mostra o resultado realizado

preview_position_protection

set_position_protection

Define ou move o stop loss e o take profit de uma posição

preview_leverage

set_leverage

Altera a alavancagem e mostra como a margem e o nível de liquidação vão mudar

—

cancel_all_orders

Cancela todas as ordens ativas, da conta inteira ou de um instrumento. Por padrão, mantém o stop loss e o take profit

cancel_all_orders é a única ação sem prévia. Ela existe para que você possa reagir rápido e nunca abre uma posição.

Isto respondeu à sua pergunta?