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

API的功能非常丰富。本文并非对所有功能的详细解析，而是记录了我主要出于兴趣、部分为了了解初次使用者可能采取何种方式而进行的测试过程。

利用大型语言模型探索 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 上以供将来参考：

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

其他观察

  • 若在本地运行，可能会遇到 CORS 问题，建议使用代理。
  • 身份验证在 auth.brale.xyz 进行；其余操作均在 api.brale.xyz 进行。
  • 如果我不小心，account_id 和 address_id 之间的区别仍然会给我带来一些小问题。
  • 这些测试应用将凭证存储在本地，不适合生产环境使用。这是有意为之

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

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