Check Token Security
1. Overview & Typical Use
Returns security attributes for TRC10, TRC20, TRC721, or TRC1155 tokens, including VIP status, blacklist capability, supply control, token level, and liquidity.
- Typical use: token risk assessment, pre-trade security check, token audit.
- When not to use: to check account security use “Check Account Security”.
2. Endpoint & Authentication
GET /api/security/token/data
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
address | string | Yes | — | Token ID for TRC10, or contract address for TRC20/TRC721/TRC1155 |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
is_vip | boolean | Required | Whether this is a VIP token issued by a well-known institution | — |
black_list_type | integer | Required | Blacklist capability: 0 unrecognized, 1 has blacklist, 2 no blacklist | — |
increase_total_supply | integer | Required | Whether total supply can be increased: 0 unrecognized, 1 allowed, 2 not allowed | — |
token_level | string | Required | Security level: 0 unknown, 1 neutral, 2 normal, 3 suspicious, 4 unsafe | — |
has_url | boolean | Required | Whether the name or symbol contains a URL | — |
swap_token | boolean | Required | Whether listed on sun.io | — |
sun_liquidity | string | Optional | Liquidity | USD |
open_source | boolean | Required | Whether the contract is open source | — |
is_proxy | boolean | Required | Whether a proxy contract is used | — |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- When
addressis invalid, default values are returned without raising an error.
Last updated on: