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 é uma análise detalhada de todas elas. É apenas um relato de como tenho testado o sistema, 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 ainda não faziam parte do fluxo de trabalho. Isso mudou. Com o Cursor e algumas instruções bem elaboradas, 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 comprovar que as credenciais funcionavam e estavam configuradas corretamente.

Esse pequeno teste está disponível 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 as carteiras de custódia

  • Percorra todas as combinações conhecidas de tipo de valor e tipo de transferência

  • Consultar os saldos e registrar os resultados

O aplicativo está disponível aqui: github.com/superduperdot/balance-app

Identificando os tipos suportados

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

  • Lista de TransferTypes do Brale

  • Lista de ValueTypes do Brale

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

Outras observações

  • Se você estiver executando localmente, espere problemas com CORS; use um proxy.

  • A autenticação ocorre em auth.brale.xyz; todo o restante 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 se concentraram principalmente em velocidade e usabilidade. O objetivo era ver com que rapidez você consegue passar das credenciais para algo concreto, 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 esse tempo para ver como a nova camada se comporta na prática. A CLI também pode ser útil para dar uma olhada no que está por vir.