HoldFi 开放接口文档

文档版本：v1.0
更新时间：2026-08-27

本文档面向接入 HoldFi 开放能力的第三方平台，介绍服务端通信协议、用户接入、账户查询和充值确认接口。

第三方后端调用 HoldFi OpenAPI 时，须按照统一协议完成请求加密与签名，并在收到响应后完成验签与解密。OAuth2 浏览器跳转和 HoldFi 门户页面跳转不使用该协议。

文档导航

文档	内容
协议规范	HTTP 报文、加密信封、签名规则、时间窗口和错误处理
用户体系接入	用户登记、用户 USD 查询、门户会话
账户能力	关联账户余额、充值地址和充值确认查询
公共常量	公链、资产、状态和响应码
接口清单	HoldFi 与第三方提供的接口总览

开放能力

HoldFi 当前提供以下能力：

1. 按第三方用户标识登记 HoldFi 用户。
2. 批量查询第三方用户的可用 USD 和冻结 USD。
3. 创建短期门户会话，引导用户进入 HoldFi。
4. 查询开放应用关联账户的 USDT 可用余额和充值地址。
5. 按公链与交易哈希查询 USDT 充值确认结果。

接入说明

• HoldFi 为每个接入方分配唯一的 platform，用于识别开放应用。
• 双方分别生成 RSA 密钥对并交换公钥，私钥由各自安全保管。
• OpenAPI 仅供服务端调用，请勿在浏览器或移动端保存开放应用私钥。
• 文档中的金额均为十进制字符串，接入方应使用 Decimal 或 BigNumber 类型处理。
• 如需本文档未列出的开放能力，请与 HoldFi 对接人员确认。