Guia de Início Rápido para Usuários com Assistentes de Codificação por IA.
Visão Geral
Este documento é uma coleção de Skills da API BingX para Assistentes de Codificação por IA, incluindo 15 módulos de habilidades, cobrindo Futuros Perpétuos, spot trading, Futuros Standard Coin-M, copy trading e gerenciamento de contas.
Após a instalação, você pode interagir diretamente em linguagem natural com IA para consultar dados de mercado, realizar operações de trading e gerenciar contas, sem precisar escrever manualmente nenhum código de requisição de API.
Assistentes de IA Suportados: Claude Code, Cursor e outros assistentes de codificação por IA que suportam o mecanismo Skills.
Instalação
- Instalação Geral (Claude Code / Cursor / Outros)
| npx skills add BingX-API/api-ai-skills |
- Claude Code Instalação Dedicada (suporta atualizações automáticas)
| /plugin add BingX-API/api-ai-skills |
Para instruções detalhadas de instalação, veja README.md
Visão Geral das Skills
- USDT-M Perpétuo
| Nome da Skill | Propósito | Autorização Necessária |
| bingx-swap-market | Dados de mercado: Preço, profundidade, K-line, taxa de financiamento, juros em aberto, etc. | Incompleto |
| bingx-swap-trade | Operações de trading: Inserir ordens, cancelar ordens, definir alavancagem, modo de ativo, etc. | Sim |
| bingx-swap-account | Informação de conta: Saldos, posições atuais, taxas de comissões, fluxo de fundos, etc. | Sim |
- Spot
| Nome da Skill | Propósito | Autorização Necessária |
| bingx-spot-market | Dados de mercado: Preço, profundidade, K-line,histórico de trade, etc. | Incompleto |
| bingx-spot-trade | Operações de trading: Inserir ordens, cancelar ordens, consultas de ordem,ordens OCO, etc. | Sim |
| bingx-spot-account | Info de conta: Saldos, visão geral dos ativos, transferência de ativos, etc. | Sim |
| bingx-spot-wallet | Operações de carteira: Depósito, saque, registros de transferência, etc. | Sim |
- Coin-M Perpétuo
| Nome da Skill | Propósito | Autorização Necessária |
| bingx-coinm-market | Dados de mercado: Preço, profundidade, K-line, taxa de financiamento, etc. | Incompleto |
| bingx-coinm-trade | Operações de trading: Inserir ordens, cancelar ordens, alavancagem, modo de ativo, etc. | Sim |
- Copy Trading
| Nome da Skill | Propósito | Autorização Necessária |
| bingx-copytrade-spot | Spot Copy Trading: Fechar posições copiadas, consultar lucros, etc. | Sim |
| bingx-copytrade-swap | Copy Trading de Futuros: Fechar posições, definir TP/SL, definir comissões, etc. | Sim |
- Gerenciamento de Conta
| Nome da Skill | Propósito | Autorização Necessária |
| bingx-fund-account | Conta de Fundos: Consultar saldo, visão geral dos ativos, transferência interna, etc. | Sim |
| bingx-sub-account | Gerenciamento de Subconta: Criar/congelar subcontas,gerenciamento de API Key , etc. | Sim |
| bingx-agent | Parceiro/Corretora: Convidar usuários, consultar comissões, e verificar dados de parceiros, etc. | Sim |
- Futuros Standard
| Nome da Skill | Propósito | Autorização Necessária |
| bingx-standard-trade | Futuros Standard: Consultar posições, histórico de ordem, saldo, etc. | Sim |
Explicação de Autorização
- Skills que não requerem autorização
As seguintes skills de dados de mercado podem ser usadas sem configurar API Key:
- bingx-swap-market (dados de mercado de Futuros Perp)
- bingx-spot-market (dados de mercado de Spot)
- bingx-coinm-market (dados de mercado de Futuros Standard Coin-M)
- Skills que requerem autorização
Todas as demais skills de trading e relacionadas à conta exigem configuração das seguintes variáveis de ambiente:
- BINGX_API_KEY — sua API Key
- BINGX_SECRET_KEY — sua Secret Key
API Key é criada no BingX Centro de Usuário → Gerenciamento de API.
- Ambientes de Operação
| Ambiente | Descrição | Base URL |
| prod-live | Produção (ao vivo) | https://open-api.bingx.com |
| prod-vst | Demo (não requer fundos reais) | https://open-api-vst.bingx.com |
Para detalhes técnicos completos sobre a assinatura de autenticação, veja skills/references/authentication.md
Mecanismo de Segurança
- Confirmação para operações de escrita
No ambiente prod-live (produção), todas as operações de escrita (inserção de ordens, cancelamento de ordens, transferências, etc.) exigem que o usuário insira CONFIRMAR antes da execução. Nenhuma confirmação é necessária no ambiente demo.
- Mascaramento de Chaves
AI irá mascarar automaticamente as keys ao exibi-las:
- API Key: Exibe os 5 primeiros e os 4 últimos caracteres, ex.: su1Qc...8akf
- Secret Key: Totalmente mascarada, exibe apenas os últimos 5 caracteres, ex.: ***...aws1
Cenários Comuns de Uso
Uma vez concluída a instalação, é possível interagir diretamente com IA usando linguagem natural. Aqui estão alguns exemplos comuns:
- Consulta de Dados de Mercado
| Consultar o preço atual de BTC-USDT |
| Visualizar os dados de K-line da última hora para ETH-USDT |
| Qual é a taxa de financiamento atual do BTC-USDT? |
- Operações de Trading
| Fazer uma ordem de compra a mercado para BTC-USDT no valor de 0,01 |
| Fazer uma ordem limite de venda para ETH ao preço de 4.000 USDT com quantidade de 0,1 |
| Cancelar todas as ordens abertas de BTC-USDT |
- Gerenciamento da Conta
| Visualizar o saldo da minha conta de futuros e as posições atuais |
| Consultar o saldo da minha conta spot |
| Transferir 100 USDT da minha conta spot para minha conta de futuros |
- Outras Operações
| Visualizar minha lista de subcontas |
| Consultar minha lista de indicações de parceiro |
Fluxo de Trabalho Multi-Skill
Múltiplas skills podem ser combinadas para executar processos de trading completos:
- Fluxo de Trabalho de Trading de Futuros
| swap-market (visualizar dados de mercado e profundidade de BTC-USDT) ↓ swap-account (verificar saldo da conta e margem disponível) ↓ swap-trade (inserir ordem) |
- Fluxo de Trabalho de Gerenciamento de Posições
| swap-account (visualizar posições atuais e PnL) ↓ swap-market (visualizar último preço) ↓ swap-trade (fechar ou ajustar posição) ↓ swap-account (confirmar resultado do fechamento) |
- Fluxo de Trabalho de Spot Trading
| spot-market (consultar preço spot e profundidade) ↓ spot-account (verificar saldo da Conta Spot) ↓ spot-trade (inserir ordem de compra ou venda) |
- Transferência de Ativos entre Contas
| spot-account (visualizar saldo spot) ↓ spot-account / fund-account (transferir ativos para Conta de Futuros) ↓ swap-trade (operar futuros com fundos transferidos) |
Estrutura de Arquivos
Cada módulo de skill consiste em dois arquivos:
| skills/<skill-name>/ ├── SKILL.md # Descrição de uso do Agente └── api-reference.md # Documentação API completa |
- SKILL.md: Define o propósito da skill, tabela de referência rápida, exemplos de código TypeScript, regras de interação do agente (autorização, mecanismo de confirmação, etc.)
- api-reference.md: Documentação completa dos endpoints da API, incluindo detalhes de parâmetros, campos de resposta, exemplos em JSON e códigos de erro
A documentação de referência geral pode ser encontrada no diretório skills/references/:
- authentication.md — Implementação da assinatura HMAC SHA256
- base-urls.md — Configuração de base URL de ambiente
