Get Account Tags
1. Overview & Typical Use
Returns all on-chain behavior tags associated with an account, including categories such as Assets, Activity, DeFi, NFT, and Governance.
- Typical use: quickly understand the on-chain behavior profile of an account.
- When not to use: to query account balance, use an account endpoint.
2. Endpoint & Authentication
GET /api/account/tag
For Base URL and authentication, see Common Network & Authentication.
This endpoint requires API Key: calls without a key return 401.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
address | string | Yes | — | Account address to query |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
blueTag | string | Required | Blue tag (official identifier) | — |
greyTag | string | Required | Grey tag | — |
redTag | string | Required | Red tag (risk identifier) | — |
publicTag | string | Required | Public tag | — |
chainTags | object | Required | On-chain behavior tags grouped by category; empty object {} when the account has no tags | — |
refreshTimeInfo | object | Optional | Data refresh time info; not returned when the account has no tag data | — |
chainTags category keys (dynamic object key set)
| Category | Type | Required | Description |
|---|---|---|---|
Assets | array | Optional | Asset tags (e.g. High Balance / Whale) |
Activity | array | Optional | Activity tags (e.g. High Activity / Large Trader) |
DeFi | array | Optional | DeFi tags (e.g. Lender on JustLend) |
NFT | array | Optional | NFT tags (e.g. NFT Collector) |
Governance | array | Optional | Governance tags |
Each category value is an array of tag elements; empty array [] when the account has no hits in that category.
refreshTimeInfo object
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
type | string | Required | Refresh type (e.g. realtime) | — |
lastUpdateTime | integer | Required | Last update time | seconds timestamp |
Tag element under each chainTags category
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
tagName | string | Required | Tag name | — |
tagNameKey | string | Required | Tag name key | — |
tagDesc | string | Required | Tag description | — |
tagDescKey | string | Required | Tag description key | — |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- API Key required: returns
401if not provided. - General error handling rules apply; no special error scenarios.
Last updated on: