Added

• FundamentalContext.MacroeconomicIndicators gains keyword *string parameter for fuzzy name filtering via GET /v2/quote/macrodata
• FundamentalContext.Macroeconomic switches to GET /v2/quote/macrodata/{id}, results sorted newest-first (sort=desc) by default

Changed

• MacroeconomicIndicator.Name / .Describe: MultiLanguageText → string
• Macroeconomic.Unit / .UnitPrefix: MultiLanguageText → string

Added

• New public counter package for symbol ↔ counter_id conversion, backed by an embedded ETF (7250) / index (648) / warrant (17693) directory:
  • SymbolToCounterID / IndexSymbolToCounterID / CounterIDToSymbol
  • IsETF reports whether a symbol resolves to an ETF
  • LookupCounterID resolves locally only (embedded directory + on-disk cache + leading-dot index notation)
  • CacheCounterIDs persists remotely resolved entries to $LONGBRIDGE_CACHE_DIR/counter-ids.csv (default ~/.longbridge/cache/counter-ids.csv)
• QuoteContext.SymbolToCounterIds — batch convert symbols to counter IDs via POST /v1/quote/symbol-to-counter-ids
• QuoteContext.ResolveCounterIds — local-first counter ID resolution with batched remote fallback and automatic caching
• FundamentalContext.EtfAssetAllocation — ETF asset allocation (holdings / regional / asset class / industry) via GET /v1/quote/etf-asset-allocation
• FundamentalContext.MacroeconomicIndicators(country, offset, limit) — list macroeconomic indicators via GET /v1/quote/macrodata; filter by MacroeconomicCountry (HK/CN/US/EU/JP/SG); response includes Count
• FundamentalContext.Macroeconomic(indicatorCode, startDate, endDate, offset, limit) — historical data for a specific indicator via GET /v1/quote/macrodata/{indicator_code}; startDate / endDate accept "YYYY-MM-DD" strings; response includes Count
• New types: MultiLanguageText, MacroeconomicCountry, MacroeconomicImportance, MacroeconomicIndicator, MacroeconomicIndicatorListResponse, Macroeconomic, MacroeconomicResponse

Upgrade

go get github.com/longbridge/openapi-go@v0.25.0

Bug Fixes

• calendar.CalendarEventsResponse: expose NextDate pagination cursor — fixes incomplete results when a date range spans multiple pages (e.g. CRM.US, PDD.US missing from a 2026年05月23日→05-30 range query)
• calendar.CalendarEventInfo.Symbol: convert raw counter_id (e.g. ST/US/CRM) to standard symbol format (CRM.US)
• quote.DailyOptionVolume.Symbol: convert underlying_counter_id to standard symbol format

Changes

• Add internal/counter.IDToSymbol as a shared counter_id → symbol conversion helper; sharelist migrated to use it

Upgrade

go get github.com/longbridge/openapi-go@v0.24.2

What's New

7 New Context Types

19 New APIs

• FundamentalContext +9: Shareholders, BusinessSegments, InstitutionRatingViews, IndustryRank, IndustryPeers, FinancialReportSnapshot, and more
• MarketContext +3: new market-related endpoints
• QuoteContext +4: ShortPositions, OptionVolume, OptionVolumeDaily, UpdatePinned
• New screener package +5: ScreenerRecommendStrategies / ScreenerUserStrategies / ScreenerSearch and more, endpoints migrated to /v1/quote/ai/screener/*

Extensions to Existing APIs

• QuoteContext — added ShortPositions, OptionVolume, OptionVolumeDaily, UpdatePinned
• WatchedSecurity — added IsPinned bool field
• Config — added WithHeader(key, value string) *Config to inject custom HTTP headers per request

HTTP Connection Improvements

• Removed req.Close = true that was forcing a new TCP connection per request
• Configured a custom http.Transport with IdleConnTimeout of 60 seconds to enable connection reuse

Breaking Changes

• AlertContext.Enable / AlertContext.Disable merged into a single AlertContext.Update(item *AlertItem) method
• StockEvents → TopMovers; StockEventsResponse → TopMoversResponse
• HkShortPositions removed; use ShortPositions(ctx, symbol, count) instead
• Response types for ShortPositions, ShortTrades, TopMovers, RankList, ValuationComparison changed from raw JSON to typed structs; timestamps unified to RFC 3339
• ScreenerRecommendStrategies / ScreenerUserStrategies now accept a market parameter; ScreenerSearch accepts typed ScreenerCondition objects

Bug Fixes

• fundamental.ValuationPoint.Timestamp, ForecastEpsItem.ForecastStartDate/EndDate: fixed deserialization failure when API returns string timestamps
• dca.DcaPlan.AlterHours: fixed type mismatch
• quote.ShortPositions: corrected request parameter to counter_id format
• quote.UpdatePinned: mode now sends string "add" / "remove" instead of integer
• dca.CalcDate: handle both Unix timestamp and YYYY-MM-DD formats returned by the API
• OperatingFinancial: renamed CounterID → Symbol (auto-converts ST/US/AAPL → AAPL.US)
• oauth: fixed panic (sync: unlock of unlocked mutex) when authorization flow fails

Upgrade

go get github.com/longbridge/openapi-go@v0.24.1

What's Changed

• optimize: Add some trade-related type constants. by @sunfuze in #87
• fix lost buy_power field by @wulianglongrd in #78

Full Changelog: v0.23.0...v0.24.0

Contributors

• @sunfuze
• @wulianglongrd

What's Changed

• feat(content): add ContentContext with topic and reply APIs by @huacnlee in #82
• feat(asset): add StatementContext for statement list and download APIs, support staging environment by @ZGeomantic in #83
• refactor: rename ListMyTopicsOptions to MyTopicsOptions by @wuxsoft in #84
• upgrade changelog by @wuxsoft in #85

New Contributors

• @huacnlee made their first contribution in #82
• @ZGeomantic made their first contribution in #83

Full Changelog: v0.22.0...v0.23.0

Contributors

• @huacnlee
• @hogan-yuan
• @ZGeomantic

What's Changed

migrate CN endpoints to longbridge.cn, update token storage path

Full Changelog: v0.21.0...v0.22.0

What's Changed

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

New Contributors

• @wuxsoft made their first contribution in #80

Full Changelog: v0.20.0...v0.21.0

Contributors

• @hogan-yuan

What's Changed

• feat: add OAuth 2.0 support by @sunli829 in #79

New Contributors

• @sunli829 made their first contribution in #79

Full Changelog: v0.17.1...v0.20.0

Contributors

• @sunli829

What's Changed

• fix: candle stick trade session is different to trade session in prot... by @sunfuze in #77

Full Changelog: v0.17.0...v0.17.1

Contributors

• @sunfuze