News & Contents
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 all community stock lists (sharelists) created by or subscribed to by the current user.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
type | string | Optional | Filter: `mine` or `subscribed`. Omit for both. |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
sharelists | object[] | Optional | User's own sharelists |
subscribed_sharelists | object[] | Optional | Subscribed sharelists |
tail_mark | string | Optional | Pagination cursor for subscribed list |
id | integer | Required | Sharelist ID |
description | string | Optional | Description |
cover | string | Optional | Cover image URL |
subscribers_count | integer | Optional | Number of subscribers |
chg | string | Optional | Day change percentage |
this_year_chg | string | Optional | Year-to-date change percentage |
subscribed | boolean | Optional | Whether the current user is subscribed |
sharelist_type | integer | Optional | Type: `0`=regular, `3`=official, `4`=industry |
industry_code | string | Optional | Industry code (for industry sharelists) |
symbol | string | Required | Security symbol |
code | string | Optional | Ticker code |
market | string | Optional | Market |
intro | string | Optional | Brief description |
last_done | string | Optional | Latest price |
change | string | Optional | Day change percentage |
trade_status | integer | Optional | Trade status code |
latency | boolean | Optional | Whether quote data is delayed |
unread_change_log_category | string | Optional | Unread change log category |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"mine": [
{
"id": 15921,
"name": "AI Picks",
"type": "Regular",
"day_change": "-0.40",
"ytd_change": "6.64",
"subscribers": 500
}
],
"subscribed": []
}
}Error code
See the Error Codes page for the full list of error codes.