Toda chamada leva dois cabeçalhos:
A URL base é https://api.clarian.finance/v1/{ambiente}: O prefixo da chave precisa bater com o ambiente da URL. Os SDKs escolhem a URL pela chave.

Permissões e IPs

  • Ao criar a chave, marque só as permissões que ela usa.
  • Chaves de produção só funcionam a partir dos IPs que você cadastrar em Negócios › API › IPs.
  • Criar, rotacionar ou revogar chaves exige o 2FA de uma pessoa no painel; isso não é feito pela API.

Limite de requisições

120 requisições por minuto por chave. Acima disso a resposta é 429 rate_limited; tente de novo quando a janela de um minuto virar.

Subcontas

Para agir em uma subconta sua (carteira como serviço), envie X-Subaccount-Id: <id> nas rotas de saldos, carteiras e movimentação.