Get Account Participated Projects
1. Overview & Typical Use
Queries the projects that a specified account has participated in, including staking, liquidity provision, and other DeFi projects along with their asset values.
- Typical use: DeFi asset aggregation, project participation overview, portfolio asset value calculation.
- When not to use: to query account token holdings, use “Get Account Token List”; to query an account’s overall asset overview, use “Get Account Wallet Token Overview”.
2. Endpoint & Authentication
GET /api/participate_project
For Base URL and authentication, see Common Network & Authentication.
This endpoint requires an API Key: calls without a Key return 401.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
address | string | Yes | — | Account address (Base58, starts with T) |
detail | integer | No | 1 | Pass 0 to omit the data field in each project; defaults to returning all data |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Total number of participated projects | — |
projects | array | Required | Project record array; see below | — |
total_asset_in_trx | number | Required | Total assets across all projects in TRX | TRX |
total_asset_in_usd | number | Required | Total assets across all projects in USD | USD |
refreshTimeInfo | object | Required | Data refresh time info (contains type and lastUpdateTime s timestamp) | — |
projects[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
project_name | string | Required | Project name | — |
logo | string | Required | Project logo URL | — |
url | string | Required | Project website (may be an empty string) | — |
total_value | number | Required | Asset value for this project (TRX, low precision display) | TRX |
total_value_detail | number | Required | Asset value for this project (TRX, high precision) | TRX |
total_value_in_usd | number | Required | Asset value in USD (low precision display) | USD |
total_value_in_usd_detail | number | Required | Asset value in USD (high precision) | USD |
percent | number | Required | Proportion of total assets | Decimal |
data | array | Required | Asset detail array; see below | — |
projects[].data[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
sc_type | string | Required | Scenario type (e.g. Staked USDT, Staking, Lending, Liquidity Asset) | — |
currency | string | Required | Token ID (TRX uses _; TRC20 uses contract address) | — |
currency_info | object | Required | Token metadata; see below | — |
balance | number | Required | Balance (low precision display) | Includes decimals |
balanceDetail | number | Required | Balance (high precision) | Includes decimals |
value | number | Required | Asset value (TRX, low precision display) | TRX |
value_detail | number | Required | Asset value (TRX, high precision) | TRX |
value_in_usd | number | Required | Value in USD (low precision display) | USD |
value_in_usd_detail | number | Required | Value in USD (high precision) | USD |
type | string | Optional | Operation type (e.g. Stake, Supply, Liquidity); not returned for some scenarios (e.g. Liquidity Asset) | — |
little_balance | boolean | Optional | Whether the balance is negligibly small; only returned for some sc_type values (e.g. Staked USDT) | — |
little_value | boolean | Optional | Whether the value is negligibly small; only returned for some sc_type values (e.g. Staked USDT) | — |
version | integer | Optional | Only returned for sc_type: "Staking" (TRX Staking) projects; value 1 or 2 indicates stake v1/v2; not returned for other sc_types | — |
projects[].data[].currency_info object
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
tokenId | string | Required | Token contract address (Base58); TRX placeholder is _ | — |
tokenAbbr | string | Required | Token abbreviation (e.g. USDT / TRX) | — |
tokenName | string | Required | Token name | — |
tokenDecimal | integer | Required | Decimal precision (required to convert the amount field) | — |
tokenCanShow | integer | Required | Whether displayable (1 yes / 0 no) | — |
tokenType | string | Required | Token type (trc10 / trc20 / trc721 / trc1155) | — |
tokenLogo | string | Optional | Token logo URL (not returned for some tokens) | — |
tokenLevel | string | Required | Token level | — |
vip | boolean | Required | Whether it is a VIP token | — |
issuerAddr | string | Optional | Issuer address (Base58); present for TRC20 tokens | — |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- API Key Required: returns 401 if not provided (see Common Network & Authentication).
- Empty result is not an error: returns
200+projects: []when the account has not participated in any projects, which is a normal response.
Last updated on: