Brale 最近发布了stablecoin API的更新版本。该项目于第一季度启动设计工作，第二季度进入开发阶段，随后不久便正式上线，开始为真实客户提供服务。

API的功能非常丰富。本文并非对所有功能的详细解析，而是记录了我如何进行测试——主要是出于兴趣，同时也希望帮助初次接触该工具的开发者了解其使用方法。

利用大型语言模型（LLMs）探索 API

上次我从事类似项目时，大型语言模型还未真正融入工作流程。如今情况已然不同。借助 Cursor 和一些恰当的提示词，现在可以轻松地快速搭建可运行的原型，并实时验证假设。

我依然喜欢用 Postman 来探索 API，但我想体验一下在更接近真实界面的环境中使用 Brale API 的感觉。

首次测试：身份验证

我从一个基本的认证流程开始——使用 client_id 和 client_secret 获取 bearer token。没什么花哨的，只是为了验证凭证是否有效且作用域设置正确。

这个小测试项目在这里：github.com/superduperdot/auth-app

第二次测试：余额

这部分其实稍微复杂一些。Brale API 支持多种值类型（每种代表一种不同的资产）和多种转账类型（每种代表一条链或一个网络）。因此，查询余额的过程如下：

  • 获取与您的凭据关联的 account_id

  • 使用该 ID 获取地址列表

  • 按类型过滤结果：“internal”以筛选出托管钱包

  • 遍历所有已知的价值类型与转账类型的组合

  • 查询余额并记录返回结果

该应用在此：github.com/superduperdot/balance-app

追踪支持的类型

TransferTypes 已有详细文档说明。ValueTypes 目前尚未在文档中直接公开，因此我从生产环境应用中提取了这些数据，并将两份列表上传至 GitHub 以供日后参考：

  • Brale的TransferTypes列表

  • Brale 的 ValueTypes 列表

从数据接口获取价格的功能也运行良好。

其他观察

  • 若在本地运行，可能会遇到 CORS 问题，请使用代理。

  • 身份验证在 auth.brale.xyz 进行；其余操作均在 api.brale.xyz 进行。

  • 如果我不小心，account_id 和 address_id 之间的区别仍会引发一些小问题。

  • 这些测试应用将凭据存储在本地，不适合在生产环境中使用。这是有意为之

此处内容均未最终确定。这些测试主要侧重于速度和易用性，旨在验证在不依赖内部工具或深入了解平台的情况下，从凭据到实际应用的实现速度有多快。

如果你正在探索 Brale API，也许这能为你省去一些周折。即使不是，花时间观察这一新层在实际环境中的表现也依然值得。CLI 工具同样有助于初步测试其功能。