News & Contents

Create Topic

POSThttps://openapi.longbridge.com/v1/content/topics

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=.

Create a new community topic on Topics. Two content types are supported:

Type title body format Notes
post (default) Optional Plain text only Markdown syntax (e.g. **bold**, # heading) is NOT rendered — it appears as literal characters, similar to a tweet.
article Required Markdown The server converts Markdown to HTML for display. Supports headers, tables, bold, code blocks, etc.

Only users who have opened a Longbridge account and hold assets are allowed to publish community topics and replies via Longbridge Developers API or CLI. Returns 403 otherwise.

Tip

Stock symbols mentioned in the body (e.g. 700.HK, TSLA.US) are automatically recognized and linked as related stocks by the platform. Use tickers to associate additional symbols not explicitly mentioned in the body.

⚠️ Do not abuse symbol linking to associate unrelated stocks. Content moderation may restrict publishing or mute the account.

Rate limit: Max 3 topics per user per minute and 10 per 24 hours. Exceeding the limit returns 429.

Warning

⚠️ Rate limit thresholds are for reference only and may be adjusted by the platform at any time.

>_ CLI
# publish a topic for Tesla
longbridge topic create --body "Tesla Q1 earnings analysis" --tickers TSLA.US
# publish a topic for Apple
longbridge topic create --body "Apple WWDC preview" --tickers AAPL.US

Request

Request body

NameTypeRequiredDescription
titlestringOptionalTopic title. Required when `topic_type` is `article`; optional for `post`.
bodystringRequiredTopic body. - For `post`: plain text only — Markdown is not rendered. - For `article`: Markdown is supported.
topic_typestringOptionalContent type: `post` (plain text, default) or `article` (Markdown).
tickersarrayOptionalRelated security symbols, format `{symbol}.{market}` (e.g. `["AAPL.US", "700.HK"]`). Maximum 10. **Note:** Symbols mentioned in the body (e.g. `700.HK`, `TSLA.US`) are automatically recognized and linked by the platform. Use `tickers` to associate additional symbols not explicitly mentioned in the body.
hashtagsarrayOptionalHashtag names (e.g. `["earnings", "fed"]`). Maximum 1.

Response

Response properties

NameTypeRequiredDescription
itemobjectRequiredNewly created topic details
└ idstringRequiredTopic ID
└ titlestringOptionalTopic title
└ descriptionstringOptionalPlain-text summary (auto-generated from body)
└ bodystringOptionalFull body text (Markdown for `article`)
└ topic_typestringOptionalTopic type. One of `article`, `post`
└ tickersstring[]OptionalAssociated security symbols
└ hashtagsstring[]OptionalAssociated hashtag names
└ imagesobject[]OptionalImage list
└ ∟ urlstringOptionalOriginal image URL
└ ∟ smstringOptionalSmall thumbnail URL
└ ∟ lgstringOptionalLarge thumbnail URL
└ likes_countint32OptionalNumber of likes
└ comments_countint32OptionalNumber of replies
└ views_countint32OptionalNumber of views
└ shares_countint32OptionalNumber of shares
└ detail_urlstringOptionalDirect URL to the topic
└ authorobjectOptionalAuthor information
└ ∟ member_idstringOptionalAuthor member ID
└ ∟ namestringOptionalAuthor display name
└ ∟ avatarstringOptionalAuthor avatar URL
└ created_atstringRequiredUnix timestamp (seconds) when the topic was created
└ updated_atstringOptionalUnix timestamp (seconds) of last update

Response JSON example

{
  "code": 0,
  "message": "success",
  "data": {
    "item": {
      "id": "39304657",
      "title": "My View on AAPL",
      "topic_type": "article",
      "tickers": [
        "AAPL.US"
      ],
      "hashtags": [
        "earnings"
      ],
      "created_at": "1742000000"
    }
  }
}

Error code

See the Error Codes page for the full list of error codes.