News & Contents

Popular Sharelists

GEThttps://openapi.longbridge.com/v1/sharelists/popular

Authorization

Signed mode: every request is signed with your App Key/Secret. Header set:

NameTypeRequiredDescription
Authorizationstring · headerRequiredThe account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation.
X-Api-Keystring · headerRequiredYour App Key.
X-Timestampstring · headerRequiredRequest timestamp in seconds (Unix epoch).
X-Api-Signaturestring · headerRequiredHMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=.

Get popular/trending sharelists from the community.

>_ CLI
longbridge sharelist popular --count 10

Request

Query parameters

NameTypeRequiredDescription
countintegerOptionalMaximum number of results, default 20

Response

Response properties

NameTypeRequiredDescription
sharelistsobject[]OptionalUser's own sharelists
└ idstringOptionalSharelist ID
└ subscribers_countintegerOptionalNumber of subscribers
└ stocks_countintegerOptionalNumber of securities in the list.
└ namestringOptionalSecurity name.
└ descriptionstringOptionalDescription
└ coverstringOptionalCover image URL
└ created_atstringOptionalUnix timestamp (seconds) when the topic was created
└ this_year_chgstringOptionalYear-to-date change percentage
└ statusintegerOptionalFinal run status: `succeeded` / `interrupted` / `failed` / `stopped`
└ edited_atstringOptionalLast edit time.
└ digeststringOptionalShort description / digest.
└ creatorobjectOptionalCreator user name.
└ ∟ idstringOptionalSharelist ID
└ ∟ namestringOptionalSecurity name.
└ ∟ avatarstringOptionalAuthor avatar URL
└ ∟ member_idstringOptionalAuthor member ID
└ ∟ scopesobjectOptionalSubscription scope info
└ ∟ ∟ followedbooleanOptionalWhether the current user follows this list.
└ ∟ ∟ followingbooleanOptionalWhether following the creator.
└ ∟ ∟ selfbooleanOptionalWhether the list belongs to the current user.
└ ∟ ∟ blockedbooleanOptionalWhether blocked by the current user.
└ ∟ ∟ special_followingbooleanOptionalWhether specially followed.
└ ∟ ∟ be_blockedbooleanOptionalWhether the current user is blocked.
└ ∟ ∟ trade_followingbooleanOptionalWhether copy-trade following.
└ ∟ profile_idstringOptionalProfile ID.
└ ∟ group_scopesobjectOptionalGroup permission scopes.
└ ∟ ∟ joinedbooleanOptionalWhether the user has joined.
└ ∟ group_memberstringOptionalWhether a group member.
└ ∟ descriptionstringOptionalDescription
└ ∟ invite_codestringOptionalInvitation code.
└ ∟ cert_scopesobjectOptionalCertification scopes.
└ ∟ ∟ officialbooleanOptionalWhether an official list.
└ ∟ ∟ cert_InfoobjectOptionalCertification info.
└ ∟ ∟ ∟ labelstringOptionalLabel.
└ ∟ ∟ ∟ namestringOptionalSecurity name.
└ ∟ ∟ ∟ descstringOptionalDescription of current valuation
└ ∟ ∟ ∟ iconstringOptionalIcon URL
└ ∟ ∟ security_live_infostringOptionalSecurity live-stream info.
└ ∟ certificationbooleanOptionalCertification.
└ stocksarrayOptionalConstituent stocks
└ subscribedbooleanOptionalWhether the current user is subscribed
└ stock_group_idstringOptionalStock-group ID.
└ last_read_log_idstringOptionalLast-read change-log ID.
└ chgstringOptionalDay change percentage
└ group_idstringOptionalGroup ID.
└ sharelist_typeintegerOptionalType: `0`=regular, `3`=official, `4`=industry
└ industry_codestringOptionalIndustry 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.