Market
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=. |
Get the tag category configuration for the popularity leaderboard. second_tags[].key can be passed to rank_list.
Request
This endpoint takes no request parameters.
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
first_tags | object[] | Optional | Top-level category list |
└ key | string | Optional | Top-level category key |
└ name | string | Optional | Top-level category name |
└ second_tags | object[] | Optional | Second-level category list |
└ ∟ key | string | Optional | Top-level category key |
└ ∟ name | string | Optional | Top-level category name |
└ ∟ market | string | Optional | Associated market: `US`, `HK`, `CN`, `SG` |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"first_tags": [
{
"key": "ib_hot",
"name": "Hotness Rank",
"second_tags": [
{
"key": "ib_hot_all-us",
"name": "US Total Hotness",
"market": "US"
},
{
"key": "ib_hot_all-hk",
"name": "HK Total Hotness",
"market": "HK"
},
{
"key": "ib_hot_all-cn",
"name": "A-share Total Hotness",
"market": "CN"
}
]
},
{
"key": "ib_change",
"name": "Price Change Rank",
"second_tags": [
{
"key": "ib_change_top-us",
"name": "US Top Gainers",
"market": "US"
},
{
"key": "ib_change_top-hk",
"name": "HK Top Gainers",
"market": "HK"
}
]
}
]
}
}Error code
See the Error Codes page for the full list of error codes.