A página Developers: use a API da FxMind num script ou numa planilha

Uma API é um jeito de um programa, e não uma pessoa, pedir dados à FxMind. Seu script manda um pedido a um endereço e recebe JSON (um formato de texto que planilhas e código leem). O guia é a página /app/developers. Ela não tem item no menu: abra por Ajustes > API com Ler o guia da API, ou digite o endereço.

Quem tem

O acesso à API faz parte dos planos Elite e Desk. Em outro plano, Ajustes > API diz isso e mostra Ver planos; as chaves que você fez antes continuam na lista como Pausada e voltam a funcionar quando o plano incluir a API. Criar uma chave também exige verificação em duas etapas: configure antes um app autenticador ou uma passkey.

O que ela faz

Ler seu diário

Contas (nunca um login nem senha), operações com a revisão, tags, estatísticas e relatórios agrupados. Permissão journal:read.

Ler dados de mercado

O calendário de notícias em UTC, até 31 dias por vez, e os resumos de mercado escritos de hoje. Permissão market:read.

Alarmes de preço

Listar seus alarmes, criar um ou apagar um. Permissões alarms:read e alarms:write.

Nunca operar

Não existe permissão para abrir, alterar ou fechar uma operação pela API.

Crie uma chave e faça sua primeira chamada

1. 1Abra Ajustes > API e aperte Nova chave.
2. 2Digite um Nome que diga onde você vai usar, por exemplo Exportar para Sheets.
3. 3Marque só as permissões de que o script precisa. Dá para mudar depois em Editar; a chave em si continua a mesma.
4. 4Escolha uma Validade: 30 dias, 90 dias, 1 ano ou Nunca. Uma chave que vence faz menos estrago se vazar.
5. 5Confirme que é você com seu app autenticador ou passkey. A chave inteira, que começa com fxm_, aparece uma vez só. Copie para as configurações secretas do seu script, por exemplo uma variável de ambiente chamada FXMIND_API_KEY.
6. 6Na página Developers, copie o exemplo Minha chave funciona? em curl, Python ou JavaScript e rode. Ele chama /api/v1/me e responde com o nome da chave, as permissões e quantas chamadas restam hoje.

Toda chamada manda a chave num cabeçalho: Authorization: Bearer fxm_.... Nunca ponha a chave no endereço: a FxMind recusa ali e você deve revogar essa chave, porque endereços acabam em registros. O endereço base é https://api.fxmind.ai/api/v1.

Os exemplos da página

• Minha chave funciona? A chamada mais simples.
• Todos os trades fechados desde uma data. As operações vêm da mais nova para a mais antiga, até 500 por página. Quando nextCursor não é null, peça de novo com ele para a página seguinte. O dinheiro vem em centavos: divida por 100.
• Criar um alarme de preço. O mesmo alarme que a Mesa cria. Vale o limite de alarmes do seu plano.

Abaixo dos exemplos, uma tabela lista cada endereço com a permissão dele, e a página mostra o contrato completo como um documento OpenAPI que você pode importar no Postman ou no Insomnia.

Limites e formatos

• 60 chamadas por minuto por chave. Acima disso vem rate_limited (429): espere os segundos do cabeçalho Retry-After.
• 10,000 chamadas por dia por chave, contadas em UTC. A contagem recomeça às 00:00 UTC. Toda resposta traz X-Quota-Remaining.
• Até 10 chaves ativas ao mesmo tempo. Chaves revogadas ficam na lista por 30 dias.
• O dinheiro vem em centavos inteiros da moeda da conta, com o código ao lado. Moedas diferentes nunca são somadas.
• Os horários vêm em UTC no formato ISO 8601, por exemplo 2026-09-27T14:30:00Z.

Quando uma chamada é recusada

api_key_required (401)

Nenhuma chave enviada. Ponha no cabeçalho Authorization.

invalid_api_key (401)

A chave está incompleta ou não é válida. Se perdeu, revogue e crie outra.

api_key_revoked ou api_key_expired (401)

Crie uma chave nova em Ajustes > API.

key_in_url (400)

Passe a chave para o cabeçalho e depois revogue essa chave.

insufficient_scope (403)

À chave falta a permissão que a chamada pede. Crie uma que tenha.

api_plan_suspended (403)

Seu plano não inclui a API agora. As chaves voltam a funcionar quando incluir.

rate_limited ou daily_quota_reached (429)

Espere, ou volte depois das 00:00 UTC.

too_many_attempts (429)

Chaves erradas demais vindas do seu endereço. Espere 10 minutos.

Mantenha as chaves seguras

• Uma chave por script, só com as permissões de que ele precisa e com validade.
• Guarde as chaves em variáveis de ambiente ou num gerenciador de senhas, nunca numa planilha que outras pessoas abrem.
• Cada chave nova é enviada para o seu email, e a lista mostra quando e de onde ela foi usada por último.
• Se uma chave pode ter vazado, aperte Revogar em Ajustes > API. Ela para na próxima chamada.

Webhooks e apps de IA

A página Developers cobre só a API. A aba Webhooks em Ajustes é o outro sentido: um alerta do TradingView chama a FxMind. Veja webhooks do TradingView. Para conectar Claude, Cursor ou outro app de IA com uma chave, veja conecte sua própria IA. Assentos e chaves no Desk: assentos de equipe e chaves de API.