Get Approval List
1. Overview & Typical Use
Query the token approval (Approve) list for a specified account, with support for aggregation by project or token dimension.
- Typical use: approval management page, reviewing contract approval risks, viewing approved projects and tokens for an account.
- When not to use: for approval change history use “Get Account Approval Change Records”.
limitmaximum is 50.
2. Endpoint & Authentication
GET /api/account/approve/list
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
address | string | Yes | — | Account address (Base58, starts with T) |
limit | integer | No | 10 | Page size, max 50 |
start | integer | No | 0 | Starting offset |
type | string | No | project | Aggregation type: project (by project) or token (by token) |
transfer | string | No | — | Use mobile when requesting mobile data |
relatedId | string | No | — | Used with mobile. project_id when type=project; token_id when type=token |
4. Response
Fields
type=project and type=token return the same schema (verified 2026-06-02); type only affects backend aggregation/sorting and does not change the field structure.
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Total approval record count | — |
rangeTotal | integer | Required | Total count within the filtered range | — |
data | array | Required | Approval records array (see below); [] for empty results | — |
contractMap | object | Required | Address → boolean map of whether it is a contract | — |
contractInfo | object | Required | Contract address → label info (value schema below) | — |
normalAddressInfo | object | Optional | Non-contract address → risk info map; not returned when data is empty; each address value verified to contain publicTag (string) | — |
data[] elements
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
amount | string | Required | Approval amount (raw value string; combine with tokenInfo.tokenDecimal to convert) | Requires decimals |
unlimited | boolean | Required | Whether it is an unlimited approval | — |
from_address | string | Required | Approver address (Base58) | — |
to_address | string | Required | Approved address (Base58) | — |
contract_address | string | Required | Token contract address (Base58) | — |
tokenInfo | object | Required | Token metadata (value schema below) | — |
project | object | Required | Project metadata (see sub-table below) | — |
project_id | string | Required | Project ID (numeric string, e.g. "8") | — |
project_sort | integer | Required | Project sort key | — |
setApprovalForAll | boolean | Optional | Operator-approval marker from a TRC-721 / TRC-1155 NFT setApprovalForAll(operator, true) call; only present on NFT operator-approval records, absent on regular TRC-20 approve records (observed sample: account TJvcpCNL3qpPgnQ8YsRsRQSqwCToLAevnZ, contract TEvqEyCxQHgxUPBUV1JcD5HYreQxxLeKj7 (TRC-721 RFBG) returns true) | — |
fromAddressTag | string | Optional | Public label for the approving address (from_address); only returned when the from address has a label; code-derived from Greason v5 scan (reproducing sample pending) | — |
toAddressTag | string | Optional | Public label for the approved address (to_address); only returned when the to address has a label; code-derived from Greason v5 scan (reproducing sample pending) | — |
operate_time | integer | Required | Most recent operation time | ms timestamp |
contractInfo[<addr>] object schema (8 fields):
| Field | Type | Required | Description |
|---|---|---|---|
tag1 | string | Required | Primary label (project name / contract name / exchange name) |
tag1Url | string | Required | URL of the primary label (may be an empty string) |
name | string | Required | Formal contract / project name |
isToken | boolean | Required | Whether it is a token contract (true / false) |
vip | boolean | Required | Whether it is a VIP entity (true / false) |
risk | boolean | string | Required | Risk label; most endpoints return boolean, some return a string risk type (blacklist / fraud, etc.) |
publicTagDesc | string | Required | Public label description; empty string for most accounts |
publicTag | string | Optional | Public label (e.g. "USDT Token" / "Binance"); returned only for well-known entities or certain endpoints |
tokenInfo object schema (9 common fields + issuerAddr):
| 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 | Required | Token logo URL | — |
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 | Required | Issuer address (Base58) | — |
project sub-fields
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
name | string | Required | Project name | — |
logo | string | Required | Project logo URL | — |
id | integer | Required | Project numeric ID | — |
officalWebsite | string | Required | Project website URL (API field name is intentionally preserved as officalWebsite, the API’s real spelling, missing the second i in official) | — |
5. Errors
For HTTP status codes, see Common Errors. Notes for this endpoint:
- Empty result is not an error: no approval records returns
200+data: [], which is a normal response.
Last updated on: