API e CLI do Moedux para agentes de IA

O Moedux expõe uma API JSON em /api/v1 e um cliente oficial, o moedux-cli, para que assistentes de IA, scripts e cronjobs leiam o diagnóstico financeiro e atuem nas transações da conta. As regras de negócio ficam apenas no servidor: a CLI é um cliente fino, sem cálculo próprio.

Como começar

  1. Entre na sua conta. A API usa sua conta Moedux — fazer login. Ainda não tem conta? 14 dias grátis, sem cartão.
  2. Crie uma API Key. Em Configurações → API Keys, escolha apenas as permissões que o agente precisa. O segredo tem o formato moedux_live_<segredo> e aparece uma única vez na criação; o servidor guarda só o hash.
  3. Instale a CLI. O instalador detecta macOS ARM/Intel, Linux x64 e Linux ARM64 e coloca o binário em ~/.local/bin.
curl -fsSL https://www.moedux.com/static/cli-install.sh | sh export MOEDUX_API_KEY=moedux_live_<segredo> moedux-cli diagnosis

A chave pode ser passada pela flag --api-key ou pela variável MOEDUX_API_KEY. A base URL padrão é https://www.moedux.com.

Endpoints disponíveis

MétodoEndpointPermissão
GET/api/v1/diagnosisdiagnosis:read
GET/api/v1/transactionstransactions:read
GET/api/v1/networthnetworth:read
POST/api/v1/transactionstransactions:write
PUT/api/v1/transactions/:idtransactions:write
DELETE/api/v1/transactions/:idtransactions:write
POST/api/v1/scenarios/comparescenarios:compare
POST/api/v1/scenarios/applyscenarios:apply

Uma chave sem a permissão correspondente recebe 403. O plano da conta continua valendo na API: recursos do Plano Pro não são liberados por uma API Key.

Contrato legível por máquina

A especificação OpenAPI 3.1 descreve caminhos, corpos de requisição, respostas e a permissão exigida em cada operação. Agentes podem gerar um cliente ou validar chamadas sem interpretar esta página.

https://www.moedux.com/openapi.json

Abrir o contrato OpenAPI →

Comandos da CLI

moedux diagnosis [--horizon-days N] moedux transactions list [--type T] [--from D] [--to D] [--limit N] moedux transactions add <json|--fields> moedux transactions edit <id> --mode only|from|all moedux transactions remove <id> [--mode only|from|all] moedux scenarios compare <json> moedux scenarios apply <json> moedux networth

Saída JSON no stdout. Códigos de saída: 0 sucesso, 1 uso, 2 autenticação/permissão, 3 validação, 4 rede/servidor. Edições e exclusões de transações recorrentes usam o mesmo Escopo de edição da interface.

Skill para agentes

O arquivo de instruções ensina um agente a instalar a CLI, autenticar com a API Key, preferir leitura antes de escrita e interpretar os códigos de saída.

curl -fsSL https://www.moedux.com/static/cli/SKILL.md -o SKILL.md
llms.txt →

Prévia sem cadastro

Descubra a data do seu Mar Vermelho antes de calcular qualquer coisa.

Informe seu Saldo Inicial, uma Entrada e uma Saída mensais e veja quando seu saldo chega a zero — com o mesmo motor de Projeção do diagnóstico. Sem cadastro, sem instalar nada.

Ver amostra do Mar Vermelho — sem cadastro →

Planilha anota. Moedux projeta.

COMECE GRÁTIS

Seu diagnóstico financeiro na linha de comando.

14 dias grátis, sem cartão. Crie sua conta, gere uma API Key e rode moedux diagnosis: a API e a CLI completas para você testar sem pagar nada.

Criar minha conta grátis →

Já tem conta? Ir para API Keys →

PRIMEIRO PASSO GRÁTIS

Planilha anota. Moedux projeta.

Comece pelo modelo pronto, sem cadastro. Quando quiser enxergar a projeção, o Moedux faz a conta por você.

Baixar planilha grátis →

Sem spam. O download acima é grátis e não pede cadastro.

Compartilhe:WhatsAppX
Feedback

Seu feedback é crucial ❤️

Avaliação