接口清单

1. HoldFi 提供的接口

以下接口由第三方后端调用，统一使用 OpenAPI v1 协议。

接口	方法	API path	说明
注册用户	POST	/openapi/v1/users/register	第三方主动同步用户身份
批量查询用户 USD	POST	/openapi/v1/users/accounts/query	查询用户登记状态、可用 USD 和冻结 USD
创建门户会话	POST	/openapi/v1/users/portal-sessions/create	创建短期有效的 HoldFi 门户访问地址
查询关联账户信息	POST	/openapi/v1/accounts/info	查询 USDT 可用余额和充值地址
查询充值确认结果	POST	/openapi/v1/accounts/recharge/query	按公链和交易哈希查询 USDT 充值结果

2. 浏览器跳转

创建门户会话成功后，第三方应将用户浏览器跳转至响应中的完整 portal_url。该地址由 HoldFi 生成并包含一次性访问凭证，接入方无需解析或重新拼接。