mcpField
L
longbridge

longbridge

github.com/starchild-ai-agentOther2969 installsUpdated 1w ago
Repository

About longbridge

A command-line skill for querying and trading US, Hong Kong, and A-share markets through the Longport SDK. It provides account and market operations, while paper or live status depends on the configured token rather than server-side verification.

Key features

  1. 01Account status and asset checks
  2. 02Quotes and price history
  3. 03Positions and order queries
  4. 04Market and limit orders
  5. 05Live-order confirmation requirement

Use cases

  1. 01Check account status before use
  2. 02Review holdings and executions
  3. 03Retrieve a ticker quote or history
  4. 04Place orders after checking the configured token

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/starchild-ai-agent/official-skills --skill longbridge

After installing, type/longbridgein Claude Code to confirm it loaded.

Bundled filesscripts/longbridge_cli.py

Details

From the project README

What this is

☁️ Cloud broker — runs directly in the container via the official longport SDK (formerly longbridge). Covers US, HK, and A-share markets.

Auth is static key: App Key + App Secret + Access Token. These use the SDK's own env var names so they're picked up automatically.

⚠️ No paper/live discriminator exists in the API. Paper vs live is determined only by which Access Token you loaded — there is no field, account prefix, or host that distinguishes them. So --profile here is trust-declared (echoed back as paper_guard: config_declared); it does not verify anything on the server. Live placement still requires --confirm-live. Treat the token you configure as authoritative for which environment you're in.

Get your credentials

  1. Open a Longbridge account, then go to the LongPort OpenAPI console (开放平台).
  2. Apply for / enable OpenAPI access. The console issues three values:
    • App Key
    • App Secret
    • Access Token (has an expiry — regenerate when it lapses)
  3. For paper trading, generate the token while your account/environment is in the paper/模拟 mode the platform offers; for live, use the live token. (Same three field names either way.)

Configure (.env)

Request via secure input — never paste keys in chat. These are the SDK's standard names:

VariableRequiredNotes
LONGPORT_APP_KEYyesApp Key
LONGPORT_APP_SECRETyesApp Secret
LONGPORT_ACCESS_TOKENyesAccess Token (expires — refresh when needed)

Usage

pip install longport (first run). JSON output. Default profile paper (label only).

python skills/longbridge/scripts/longbridge_cli.py status
python skills/longbridge/scripts/longbridge_cli.py account
python skills/longbridge/scripts/longbridge_cli.py positions
python skills/longbridge/scripts/longbridge_cli.py orders [--executions]
python skills/longbridge/scripts/longbridge_cli.py quote --symbol 700.HK
python skills/longbridge/scripts/longbridge_cli.py history --symbol AAPL.US --period 1d --limit 90
# place: qty in shares only; market or limit
python skills/longbridge/scripts/longbridge_cli.py place --symbol 700.HK --side buy --qty 100 --type limit --limit-price 350
python skills/longbridge/scripts/longbridge_cli.py cancel --order-id <id>
# live (real money): add --confirm-live (profile is label-only)
python skills/longbridge/scripts/longbridge_cli.py --confirm-live place --symbol AAPL.US --side buy --qty 1

Symbol format is mandatory: <ticker>.<market> — 700.HK, AAPL.US, 000001.SZ, 600519.SH. Periods: 1m 5m 15m 30m 1h 1d 1w 1M.

Gotchas

  • Longbridge has no notional path — always --qty (shares).
  • The Access Token expires; if calls start failing auth, regenerate it in the console and update .env.
  • Because there's no server-side paper/live check, double-check which token you loaded before any live order — the CLI can't catch a mislabeled environment for you.

Comments

Markdown supported