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 | 0: return a project summary array without data; 1 (default): return an object containing projects and asset details |
4. Response
Fields
detail | Response schema | Asset details |
|---|---|---|
0 | Root project array; no total, projects, asset-total, or refreshTimeInfo wrapper fields | Each item omits data |
1 or omitted | Object with projects and the top-level fields below | Each projects[] item includes data (an array, which may be empty) |
Top-level (detail=1 or omitted)
| 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) | — |
Project item: root array element for detail=0; projects[] element for detail=1
| 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) | — |
url_level | integer | Optional | Classification of the project website URL, when supplied | — |
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 | Conditional | Required for detail=1 (default); omitted for detail=0. Asset detail entries are described below | — |
projects[].data[] element (detail=1 only)
| 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 | Position operation type (e.g. Stake, Supply, Liquidity); may be an empty string or omitted depending on the scenario | — |
little_balance | boolean | Optional | Small-balance flag; for scenarios that support it, returned as true when the balance rounded to 6 decimal places is zero or negative; otherwise omitted | — |
little_value | boolean | Optional | Small-value flag; for scenarios that support it, returned as true when the scenario’s valuation rounded to 2 decimal places is zero or negative; otherwise omitted | — |
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: 0 (UNKNOWN), 1 (NEUTRAL), 2 (OK), 3 (SUSPICIOUS), 4 (UNSAFE) | — |
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: when no projects are available,
detail=0returns200+[];detail=1returns200+ an object withtotal: 0andprojects: [].