获取账户参与的项目
1. 概述与典型用途
查询指定账户参与的项目信息，包括质押、流动性提供等 DeFi 项目及其资产价值。
- 典型用途：DeFi 资产汇总、项目参与概览、组合资产价值计算。
- 何时不要用：查询账户代币持仓用「获取账户代币列表」；查询账户整体资产概览用「获取账户钱包代币概览」。
2. 接口与鉴权
GET /api/participate_project
Base URL 与鉴权见 公共网络与鉴权说明。
本接口强制需要 API Key：无 Key 调用返回 401。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 账户地址（Base58，T 开头） |
detail | integer | 否 | 1 | 传 0 时省略各项目中的 data 字段，默认返回全部数据 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 参与的项目总数 | — |
projects | array | 必返 | 项目记录数组，见下 | — |
total_asset_in_trx | number | 必返 | 全部项目资产折合 TRX | TRX |
total_asset_in_usd | number | 必返 | 全部项目资产折合 USD | USD |
refreshTimeInfo | object | 必返 | 数据刷新时间信息（含 type 和 lastUpdateTime 秒时间戳） | — |
projects[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
project_name | string | 必返 | 项目名称 | — |
logo | string | 必返 | 项目 Logo URL | — |
url | string | 必返 | 项目网址（可能为空字符串） | — |
total_value | number | 必返 | 该项目资产价值（TRX，低精度显示） | TRX |
total_value_detail | number | 必返 | 该项目资产价值（TRX，高精度） | TRX |
total_value_in_usd | number | 必返 | 该项目资产折合 USD（低精度显示） | USD |
total_value_in_usd_detail | number | 必返 | 该项目资产折合 USD（高精度） | USD |
percent | number | 必返 | 占总资产比例 | 小数 |
data | array | 必返 | 资产明细数组，见下 | — |
projects[].data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
sc_type | string | 必返 | 场景类型（如 Staked USDT、Staking、Lending、Liquidity Asset） | — |
currency | string | 必返 | 代币 ID（TRX 为 _，TRC20 为合约地址） | — |
currency_info | object | 必返 | 代币元信息，见下 | — |
balance | number | 必返 | 余额（低精度显示） | 含 decimals |
balanceDetail | number | 必返 | 余额（高精度） | 含 decimals |
value | number | 必返 | 资产价值（TRX，低精度显示） | TRX |
value_detail | number | 必返 | 资产价值（TRX，高精度） | TRX |
value_in_usd | number | 必返 | 折合 USD（低精度显示） | USD |
value_in_usd_detail | number | 必返 | 折合 USD（高精度） | USD |
type | string | 可选 | 操作类型（如 Stake、Supply、Liquidity）；部分场景（如 Liquidity Asset）不返回 | — |
little_balance | boolean | 可选 | 余额是否极小（可忽略级别）；仅部分 sc_type（如 Staked USDT）返回 | — |
little_value | boolean | 可选 | 价值是否极小（可忽略级别）；仅部分 sc_type（如 Staked USDT）返回 | — |
version | integer | 可选 | 仅 sc_type: "Staking"（TRX Staking）项目返回，值为 1 或 2 表示 stake v1/v2；其他 sc_type 不返回 | — |
projects[].data[].currency_info 对象 schema（通用 9 字段 + 本接口扩展字段）：
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenId | string | 必返 | 代币合约地址（Base58）；TRX 占位符为 _ | — |
tokenAbbr | string | 必返 | 代币缩写（如 USDT / TRX） | — |
tokenName | string | 必返 | 代币名称 | — |
tokenDecimal | integer | 必返 | 精度位数（amount 字段换算所需） | — |
tokenCanShow | integer | 必返 | 是否可展示（1 是 / 0 否） | — |
tokenType | string | 必返 | 代币类型（trc10 / trc20 / trc721 / trc1155） | — |
tokenLogo | string | 可选 | 代币 logo URL；部分代币不返回 | — |
tokenLevel | string | 必返 | 代币等级（已观测值："0" / "1" / "2" / "4"，具体语义以后端定义为准） | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
issuerAddr | string | 可选 | 发行方地址（TRC20 代币有） | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 需要 API Key：未携带返回 401（见公共网络与鉴权说明）。
- 空结果 ≠ 错误：账户未参与任何项目时返回
200+projects: []，属于正常响应。
最后更新于: