Get Hot Search Data
1. Overview & Typical Use
Returns trending tokens and contracts with their search rankings, including token prices, holder counts, and contract call statistics.
- Typical use: homepage hot-search display, token/contract leaderboards.
- When not to use: to search for a specific token or account, use “Search Tokens/Contracts/Accounts”.
2. Endpoint & Authentication
GET /api/search/hot
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
No parameters required.
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
hot_tokens | array | Required | Trending token list; see below | — |
hot_contracts | array | Required | Trending contract list; see below | — |
hot_sum_all | object | Required | Token weight summary; sub-fields: activeAddress/activeAddressScore/click/clickScore/holder/holderScore/justswapLiquidity/justswapLiquidityScore/justswapLiquidityV2/justswapVolume24hrs/justswapVolume24hrsScore/justswapVolume24hrsV2/justswapVolume7d/justswapVolume7dScore/justswapVolume7dV2/search/searchScore/totalScore/transfer/transferScore | — |
hot_c_sum_all | object | Required | Contract weight summary; sub-fields: caller/callerScore/click/clickScore/newIssue/newIssueScore/projectId/projectIdScore/search/searchScore/tokenAmount/tokenAmountScore/totalScore/trigger/triggerScore/verified/verifiedScore | — |
hot_tokens[] elements
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
id | string | Required | Token contract address or ID | — |
type | string | Required | Token type: "20" = TRC20, "10" = TRC10 | — |
vip_token | boolean | Required | Whether this is a VIP token | — |
icon | string | Required | Token icon URL | — |
name | string | Required | Token name | — |
abbr | string | Required | Token abbreviation | — |
priceInUsd | number | Required | Current price | USD |
holders | integer | Required | Number of holders | — |
hot_contracts[] elements
| Field | Type | Required | Description |
|---|---|---|---|
contract_address | string | Required | Contract address |
name | string | Required | Contract name |
tag | string | Optional | Contract tag |
tagUrl | string | Optional | Tag link URL |
triggers | integer | Required | Total trigger count |
trigger7day | integer | Required | Trigger count in the past 7 days |
verify_status | integer | Required | Verification status: 0 unverified, 1 partially verified, 2 fully verified |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- No parameters — always returns data: an empty result is not an error.
Last updated on: