Brale Recentemente, lançamos uma versão atualizada das APIs do stablecoin. O projeto começou com um grupo de design no primeiro trimestre, passou para a fase de desenvolvimento no segundo trimestre e entrou em produção com clientes reais logo em seguida.

O API oferece muitas funcionalidades. Este post não é um detalhamento de todas elas. É apenas um registro de como tenho testado as coisas, principalmente por diversão e, em parte, para entender como outras pessoas poderiam abordá-lo ao usá-lo pela primeira vez.

Usando LLMs para trabalhar com o API

Da última vez que trabalhei em algo assim, os grandes modelos de linguagem não faziam realmente parte do fluxo de trabalho. Isso mudou. Com o Cursor e algumas instruções adequadas, agora é fácil montar protótipos funcionais e testar hipóteses em tempo real.

Ainda gosto de usar o Postman para explorar APIs, mas queria ver como seria usar o Brale API dentro de algo um pouco mais próximo de uma interface real.

Primeiro teste: Autenticação

Comecei com um fluxo básico de autenticação — usando um client_id e um client_secret para obter um token bearer. Nada sofisticado. Apenas o suficiente para provar que as credenciais funcionavam e estavam configuradas corretamente.

Esse pequeno teste está aqui: github.com/superduperdot/auth-app

Segundo teste: saldos

Isso acabou sendo um pouco mais complexo. O Brale API suporta vários tipos de valores (cada um representando um ativo distinto) e vários tipos de transferência (cada um representando uma cadeia ou rede). Portanto, o processo para recuperar saldos foi assim:

  • Obter o account_id associado às suas credenciais
  • Use esse ID para obter a lista de endereços
  • Filtre os resultados por tipo: “internal” para isolar carteiras de custódia
  • Percorra todas as combinações conhecidas de tipo de valor e tipo de transferência
  • Consultar saldos e registrar os resultados

Esse aplicativo está aqui: github.com/superduperdot/balance-app

Buscando os tipos suportados

Os TransferTypes estão bem documentados. Os ValueTypes ainda não estão expostos diretamente na documentação, então eu os extraí do aplicativo em produção e coloquei ambas as listas no GitHub para referência futura:

A obtenção de preços a partir do endpoint de dados também funcionou bem.

Outras observações

  • Se você estiver executando localmente, espere problemas de CORS; use um proxy.
  • A autenticação ocorre em auth.brale.xyz; todo o resto está em api.brale.xyz.
  • A distinção entre account_id e address_id ainda causa pequenos erros para mim se eu não tomar cuidado.
  • Esses aplicativos de teste armazenam credenciais localmente e não são seguros para uso em produção. Isso é intencional

Nada aqui é definitivo. Esses testes foram principalmente sobre velocidade e usabilidade. O objetivo era ver com que rapidez você pode passar das credenciais para algo real, sem depender de ferramentas internas ou de um conhecimento profundo da plataforma.

Se você estiver explorando o Brale API, talvez isso encurte o caminho. Caso contrário, ainda assim valeu a pena dedicar tempo para ver como a nova camada se comporta na prática. A CLI também pode ser útil para testar o sistema.