openapi v4.2.1

Changed

- ScreenerContext: screener endpoints migrated to /v1/quote/ai/screener/*; screener_recommend_strategies / screener_user_strategies now accept a market parameter; screener_search accepts typed ScreenerCondition objects (Mode B) instead of raw strings

Fixed

- OperatingFinancial: renamed counter_id → symbol (converts ST/US/AAPL → AAPL.US)

v4.2.0

Added

• 19 new APIs: FundamentalContext +9, QuoteContext +1 (short_trades), MarketContext +3, new ScreenerContext +5 — see PR #526, #527
• Rust: OAuthBuilder gains TokenStorage trait for custom token persistence

Changed

• short_positions unified for HK+US; typed structs with RFC 3339 timestamps
• top_movers, rank_list, valuation_comparison: typed structs, counter_id → symbol, RFC 3339 timestamps

Breaking changes

• stock_events → top_movers; StockEventsResponse → TopMoversResponse
• hk_short_positions removed; use short_positions(symbol, count)
• ShortPositionsResponse, ShortTradesResponse, TopMoversResponse, RankListResponse, ValuationComparisonResponse changed from raw JSON to typed structs

v4.1.0

• 7 new context types, 66 methods — FundamentalContext (20 methods: financial reports, analyst ratings, dividends, EPS forecasts, consensus estimates, valuation), MarketContext (9 methods: market status, broker holdings, A/H premium, trade stats), CalendarContext (7 methods: earnings / dividends / splits / IPO calendar), PortfolioContext (5 methods: exchange rates, P&L analysis), AlertContext (4 methods: price alerts), DCAContext (12 methods: DCA plans lifecycle), SharelistContext (9 methods: community sharelists)
• QuoteContext — 4 new methods: short_positions, option_volume, option_volume_daily, update_pinned
• ContentContext — new topic_detail and topic reply methods
• Rust SDK — Config::header() to inject custom HTTP/WebSocket headers
• Parameters now use typed enums instead of raw integers; monetary fields use Decimal type

v4.0.2

What's Changed

• Add news topics and filings by @wuxsoft in #477

New Contributors

• @wuxsoft made their first contribution in #477

Full Changelog: v4.0.1...v4.0.2

longport-mcp v0.2.1

What's Changed

• Add readonly option to prevent submitting orders to the exchange.
• Add support market temperature api.

Installation

For macOS and Linux (Debain), you can run this script to install:

curl -sSL https://raw.githubusercontent.com/longportapp/openapi/refs/heads/main/mcp/install | bash

Full Changelog: longport-mcp-0.2.0...longport-mcp-0.2.1

longport-mcp v0.2.0

What's Changed

• Fixed compatibility with the latest MCP protocol.
• Add support Streamable-HTTP transport.

Installation

For macOS and Linux (Debain), you can run this script to install:

curl -sSL https://raw.githubusercontent.com/longportapp/openapi/refs/heads/main/mcp/install | bash

Full Changelog: longport-mcp-0.1.0...longport-mcp-0.2.0

longport-mcp v0.1.0

LongPort MCP

LongPort-MCP is an MCP server implementation for LongPort OpenAPI

Features

• Trading - Create, amend, cancel orders, query today’s/past orders and transaction details, etc.
• Quotes - Real-time quotes, acquisition of historical quotes, etc.
• Portfolio - Real-time query of the account assets, positions, funds

Installation

macOS or Linux

Run script to install:

curl -sSL https://raw.githubusercontent.com/longportapp/openapi/refs/heads/main/mcp/install | bash

Windows

Download the latest binary from the Releases page.

Running on Cursor

To configure LongPort MCP in Cursor:

• Open Cursor Settings
• Go to Features > MCP Servers
• Click + Add New MCP Server
• Enter the following:
  • Name: longport-mcp (or your preferred name)
  • Type: command
  • Command: env LONGPORT_APP_KEY=your-app-key LONGPORT_APP_SECRET=your-app-secret LONGPORT_ACCESS_TOKEN=your-access-token longport-mcp

If you are using Windows, replace command with cmd /c "set LONGPORT_APP_KEY=your-app-key && set LONGPORT_APP_SECRET=your-app-secret && set LONGPORT_ACCESS_TOKEN=your-access-token && longport-mcp"

Running on Cherry Studio

To configure LongPort MCP in Cherry Studio:

• Go to Settings > MCP Servers
• Click + Add Server
• Enter the following:
  • Name: longport-mcp (or your preferred name)
  • Type: STDIO
  • Command: env LONGPORT_APP_KEY=your-app-key LONGPORT_APP_SECRET=your-app-secret LONGPORT_ACCESS_TOKEN=your-access-token longport-mcp

If you are using Windows, replace command with cmd /c "set LONGPORT_APP_KEY=your-app-key && set LONGPORT_APP_SECRET=your-app-secret && set LONGPORT_ACCESS_TOKEN=your-access-token && longport-mcp"

Running as a SSE server

env LONGPORT_APP_KEY=your-app-key LONGPORT_APP_SECRET=your-app-secret LONGPORT_ACCESS_TOKEN=your-access-token longport-mcp --sse

Default bind address is 127.0.0.1:8000, you can change it by using the --bind flag:

longport-mcp --sse --bind 127.0.0.1:3000