創建討論

創建一篇新討論。支持兩種內容類型：

類型	title	body 格式	說明
post（默認）	可選	純文本	Markdown 語法（如 **加粗**、# 標題）不會渲染，將作為字面字符顯示，類似發推文。
article	必填	Markdown	服務端將 Markdown 轉為 HTML 展示，支持標題、表格、加粗、代碼塊等。

僅限 Longbridge 開戶且持有資產 的用戶才允許通過 Longbridge Developers 的 API 或 CLI 發布社區討論和回覆。否則返回 403。

正文中提到的標的代碼（如 `700.HK`、`TSLA.US`）會被平台自動識別並關聯為相關標的。`tickers` 字段用於補充正文中未顯式提及的標的。

⚠️ 請勿濫用此功能關聯與內容無關的標的，否則後台內容運營可能會限制發布，甚至有可能禁言。

頻率限制： 同一用戶每分鐘最多創建 3 篇，24 小時內最多 10 篇，超出返回 429。

⚠️ 以上頻率限制規則僅供參考，平台可能隨時進行內部調整。

CLI安裝 CLI

# 發佈 Tesla 相關話題
longbridge create-topic TSLA.US "Tesla Q1 財報分析"
# 發佈 Apple 相關話題
longbridge create-topic AAPL.US "Apple WWDC 前瞻"

SDK Links

Python	longbridge.openapi.ContentContext.create_topic
Rust	longbridge::content::ContentContext#create_topic
Go	ContentContext.CreateTopic
Node.js	ContentContext#createTopic
Java	ContentContext.getCreateTopic
C++	longbridge::content::ContentContext::create_topic

Request

HTTP Method	POST
HTTP URL	/v1/content/topics

Request Body

Name	Type	Required	Description
title	string	是（article 類型必填）	標題。topic_type 為 article 時必填，post 時可省略。
body	string	YES	正文。post 類型為純文本，Markdown 不渲染；article 類型支持 Markdown。
topic_type	string	NO	內容類型：post（純文本，默認）或 article（Markdown）
tickers	string[]	NO	關聯標的代碼，格式 {symbol}.{market}，如 ["AAPL.US", "700.HK"]，最多 10 個。注意： 正文中提到的標的代碼（如 700.HK、TSLA.US）會被平台自動識別並關聯，tickers 用於補充正文中未顯式提及的標的。
hashtags	string[]	NO	討論標籤名稱列表，如 ["earnings", "fed"]，最多 5 個

Request Example

# 短帖 — 純文本（默認），Markdown 不渲染
longbridge create-topic --body "今天看好 700.HK"

# 短帖 + 關聯標的
longbridge create-topic --body "NVDA GTC 看點" --tickers NVDA.US,700.HK

# 長文 — 支持 Markdown，必須填寫標題
longbridge create-topic --title "我的分析" --body "**看好** 700.HK，因為..." --type article

# 長文 — 從 Markdown 文件讀取正文
longbridge create-topic --title "Q4 財報前瞻" --body "$(cat analysis.md)" --type article

# JSON 輸出
longbridge create-topic --body "測試帖" --format json

from longbridge.openapi import ContentContext, Config, OAuthBuilder

oauth = OAuthBuilder("your-client-id").build(lambda url: print("Visit:", url))
config = Config.from_oauth(oauth)
ctx = ContentContext(config)

# 短帖（純文本）
resp = ctx.create_topic(
    title="",
    body="今天看好 700.HK",
    topic_type="post",
    tickers=["700.HK"],
)
print(resp)

# 長文（Markdown，標題必填）
resp = ctx.create_topic(
    title="我的分析",
    body="**看好** 700.HK，因為...",
    topic_type="article",
    tickers=["700.HK"],
    license=1,
)
print(resp)

import asyncio
from longbridge.openapi import AsyncContentContext, Config, OAuthBuilder

async def main() -> None:
    oauth = await OAuthBuilder("your-client-id").build_async(lambda url: print("Visit:", url))
    config = Config.from_oauth(oauth)
    ctx = AsyncContentContext.create(config)

    resp = await ctx.create_topic(
        title="我的分析",
        body="**看好** 700.HK，因為...",
        topic_type="article",
        tickers=["700.HK"],
    )
    print(resp)

if __name__ == "__main__":
    asyncio.run(main())

const { Config, ContentContext, OAuth } = require('longbridge')

async function main() {
  const oauth = await OAuth.build("your-client-id", (_, url) => { console.log("Open this URL to authorize: " + url) })
  const config = Config.fromOAuth(oauth)
  const ctx = ContentContext.new(config)

  // 長文（Markdown，標題必填）
  const resp = await ctx.createTopic({
    title: "我的分析",
    body: "**看好** 700.HK，因為...",
    topicType: "article",
    tickers: ["700.HK"],
  })
  console.log(resp)
}
main().catch(console.error)

import com.longbridge.*;
import com.longbridge.content.*;

class Main {
    public static void main(String[] args) throws Exception {
        try (OAuth oauth = new OAuthBuilder("your-client-id").build(url -> System.out.println("Open to authorize: " + url)).get();
             Config config = Config.fromOAuth(oauth);
             ContentContext ctx = ContentContext.create(config)) {
            // 長文（Markdown，標題必填）
            CreateTopicOptions opts = new CreateTopicOptions("我的分析", "**看好** 700.HK，因為...")
                .setTopicType("article")
                .setTickers(new String[]{"700.HK"})
                .setLicense(1);
            OwnedTopic resp = ctx.createTopic(opts).get();
            System.out.println(resp);
        }
    }
}

use std::sync::Arc;
use longbridge::{oauth::OAuthBuilder, content::{ContentContext, CreateTopicOptions}, Config};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let oauth = OAuthBuilder::new("your-client-id").build(|url| println!("Open this URL to authorize: {url}")).await?;
    let config = Arc::new(Config::from_oauth(oauth));
    let ctx = ContentContext::new(config);

    // 長文（Markdown，標題必填）
    let opts = CreateTopicOptions {
        title: "我的分析".to_string(),
        body: "**看好** 700.HK，因為...".to_string(),
        topic_type: Some("article".to_string()),
        tickers: Some(vec!["700.HK".to_string()]),
        hashtags: None,
        license: Some(1),
    };
    let resp = ctx.create_topic(opts).await?;
    println!("{:?}", resp);
    Ok(())
}

#include <iostream>
#include <longbridge.hpp>

#ifdef WIN32
#include <windows.h>
#endif

using namespace longbridge;
using namespace longbridge::content;

static void
run(const OAuth& oauth)
{
    Config config = Config::from_oauth(oauth);
    ContentContext ctx = ContentContext::create(config);

    // 長文（Markdown，標題必填）
    CreateTopicOptions opts;
    opts.title = "我的分析";
    opts.body = "**看好** 700.HK，因為...";
    opts.topic_type = "article";
    opts.tickers = {"700.HK"};

    ctx.create_topic(opts, [](auto res) {
        if (!res) { std::cout << "failed: " << *res.status().message() << std::endl; return; }
        std::cout << "created topic: " << res->id << std::endl;
    });
}

int main(int argc, char const* argv[]) {
#ifdef WIN32
    SetConsoleOutputCP(CP_UTF8);
#endif

    const std::string client_id = "your-client-id";
    OAuthBuilder(client_id).build(
    [](const std::string& url) {
        std::cout << "Open this URL to authorize: " << url << std::endl;
    },
    [](auto res) {
        if (!res) {
            std::cout << "authorization failed: " << *res.status().message() << std::endl;
            return;
        }
        run(*res);
    });

    std::cin.get();
    return 0;
}

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/longbridge/openapi-go/config"
	"github.com/longbridge/openapi-go/oauth"
	"github.com/longbridge/openapi-go/content"
)

func main() {
	o := oauth.New("your-client-id").
		OnOpenURL(func(url string) { fmt.Println("Open this URL to authorize:", url) })
	if err := o.Build(context.Background()); err != nil {
		log.Fatal(err)
	}
	conf, err := config.New(config.WithOAuthClient(o))
	if err != nil {
		log.Fatal(err)
	}
	ctx, err := content.NewFromCfg(conf)
	if err != nil {
		log.Fatal(err)
	}
	// 長文（Markdown，標題必填）
	opts := content.CreateTopicOptions{
		Title:     "我的分析",
		Body:      "**看好** 700.HK，因為...",
		TopicType: "article",
		Tickers:   []string{"700.HK"},
	}
	resp, err := ctx.CreateTopic(context.Background(), opts)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("created topic: %s\n", resp.ID)
}

Response

Response Headers

• Content-Type: application/json

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "item": {
      "id": "39304657",
      "title": "我對蘋果的看法",
      "topic_type": "article",
      "tickers": ["AAPL.US"],
      "hashtags": ["earnings"],
      "created_at": "1742000000"
    }
  }
}

Response Status

Status	Description	Schema
200	返回成功	create_topic_response
403	權限不足	用戶未開戶或無資產
429	頻率超限	超過每分鐘或每日創建上限，請稍後重試
500	內部錯誤	None

Schemas

create_topic_response

Name	Type	Required	Description
item	object	true	新建討論詳情
∟ id	string	true	討論 ID
∟ title	string	false	標題
∟ description	string	false	純文本摘要（由正文自動截取）
∟ body	string	false	完整正文（article 類型為 Markdown）
∟ topic_type	string	false	內容類型，article 或 post
∟ tickers	string[]	false	關聯標的代碼
∟ hashtags	string[]	false	討論標籤名稱列表
∟ images	object[]	false	附圖列表
∟∟ url	string	false	原始圖片 URL
∟∟ sm	string	false	小縮略圖 URL
∟∟ lg	string	false	大縮略圖 URL
∟ likes_count	int32	false	點讚數
∟ comments_count	int32	false	回覆數
∟ views_count	int32	false	瀏覽數
∟ shares_count	int32	false	分享數
∟ detail_url	string	false	討論頁面直鏈
∟ author	object	false	作者信息
∟∟ member_id	string	false	作者 member ID
∟∟ name	string	false	作者暱稱
∟∟ avatar	string	false	作者頭像 URL
∟ created_at	string	true	創建時間，Unix 時間戳（秒）
∟ updated_at	string	false	最近更新時間，Unix 時間戳（秒）