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 popular/trending sharelists from the community.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
count | integer | Optional | Maximum number of results, default 20 |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
sharelists | object[] | Optional | User's own sharelists |
└ id | string | Optional | Sharelist ID |
└ subscribers_count | integer | Optional | Number of subscribers |
└ stocks_count | integer | Optional | Number of securities in the list. |
└ name | string | Optional | Security name. |
└ description | string | Optional | Description |
└ cover | string | Optional | Cover image URL |
└ created_at | string | Optional | Unix timestamp (seconds) when the topic was created |
└ this_year_chg | string | Optional | Year-to-date change percentage |
└ status | integer | Optional | Final run status: `succeeded` / `interrupted` / `failed` / `stopped` |
└ edited_at | string | Optional | Last edit time. |
└ digest | string | Optional | Short description / digest. |
└ creator | object | Optional | Creator user name. |
└ ∟ id | string | Optional | Sharelist ID |
└ ∟ name | string | Optional | Security name. |
└ ∟ avatar | string | Optional | Author avatar URL |
└ ∟ member_id | string | Optional | Author member ID |
└ ∟ scopes | object | Optional | Subscription scope info |
└ ∟ ∟ followed | boolean | Optional | Whether the current user follows this list. |
└ ∟ ∟ following | boolean | Optional | Whether following the creator. |
└ ∟ ∟ self | boolean | Optional | Whether the list belongs to the current user. |
└ ∟ ∟ blocked | boolean | Optional | Whether blocked by the current user. |
└ ∟ ∟ special_following | boolean | Optional | Whether specially followed. |
└ ∟ ∟ be_blocked | boolean | Optional | Whether the current user is blocked. |
└ ∟ ∟ trade_following | boolean | Optional | Whether copy-trade following. |
└ ∟ profile_id | string | Optional | Profile ID. |
└ ∟ group_scopes | object | Optional | Group permission scopes. |
└ ∟ ∟ joined | boolean | Optional | Whether the user has joined. |
└ ∟ group_member | string | Optional | Whether a group member. |
└ ∟ description | string | Optional | Description |
└ ∟ invite_code | string | Optional | Invitation code. |
└ ∟ cert_scopes | object | Optional | Certification scopes. |
└ ∟ ∟ official | boolean | Optional | Whether an official list. |
└ ∟ ∟ cert_Info | object | Optional | Certification info. |
└ ∟ ∟ ∟ label | string | Optional | Label. |
└ ∟ ∟ ∟ name | string | Optional | Security name. |
└ ∟ ∟ ∟ desc | string | Optional | Description of current valuation |
└ ∟ ∟ ∟ icon | string | Optional | Icon URL |
└ ∟ ∟ security_live_info | string | Optional | Security live-stream info. |
└ ∟ certification | boolean | Optional | Certification. |
└ stocks | array | Optional | Constituent stocks |
└ subscribed | boolean | Optional | Whether the current user is subscribed |
└ stock_group_id | string | Optional | Stock-group ID. |
└ last_read_log_id | string | Optional | Last-read change-log ID. |
└ chg | string | Optional | Day change percentage |
└ group_id | string | Optional | Group ID. |
└ sharelist_type | integer | Optional | Type: `0`=regular, `3`=official, `4`=industry |
└ industry_code | string | Optional | Industry code (for industry sharelists) |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"list": [
{
"id": 123,
"name": "AI Picks",
"description": "Top AI infrastructure stocks"
},
{
"id": 456,
"name": "EV Leaders",
"description": "Electric vehicle sector leaders"
}
]
}
}Error code
See the Error Codes page for the full list of error codes.