feat(fundamental): add macroeconomic_indicators and macroeconomic methods by hogan-yuan · Pull Request #540 · longbridge/openapi

hogan-yuan · 2026-06-09T11:33:41Z

Summary

Two new methods on FundamentalContext across all language SDKs (Rust, Python, Node.js, Java):

macroeconomic_indicators(country, offset, limit) — GET /v1/quote/macrodata — list macroeconomic indicators; filter by country; response includes count (total matching)
macroeconomic(indicator_code, start_date, end_date, offset, limit) — GET /v1/quote/macrodata/{indicator_code} — historical data for a specific indicator; start_date / end_date accept "YYYY-MM-DD" strings; response includes count (total data points)

New Types

Type	Description
`MultiLanguageText`	Localized text (English / Simplified Chinese / Traditional Chinese)
`MacroeconomicCountry`	Country filter enum: `HongKong` / `China` / `UnitedStates` / `EuroZone` / `Japan` / `Singapore` (SDK accepts short codes, converts to full names for API)
`MacroeconomicImportance`	Importance level: `Low=1` / `Medium=2` / `High=3`
`MacroeconomicIndicator`	Indicator metadata (code, country, category, periodicity, importance, etc.)
`MacroeconomicIndicatorListResponse`	`data: Vec<MacroeconomicIndicator>` + `count: i32`
`Macroeconomic`	One historical data point (period, actual/previous/forecast/revised values, release timestamps, unit)
`MacroeconomicResponse`	`info: MacroeconomicIndicator` + `data: Vec<Macroeconomic>` + `count: i32`

Fixes

MacroeconomicIndicator.describe / name / MacroeconomicResponse.info: handle null API responses without deserializing error

… methods Two new methods on FundamentalContext across all language SDKs: - economic_indicator_list: GET /v1/quote/macrodata - economic_indicator: GET /v1/quote/macrodata/{indicator_code} New types: MultiLanguageText, EconomicIndicatorInfo, EconomicIndicatorData, EconomicIndicatorResponse. Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

- EconomicIndicatorInfo.start_date: String -> Option<OffsetDateTime> - EconomicIndicatorData.release_at/next_release_at: String -> Option<OffsetDateTime> Python: PyOffsetDateTimeWrapper (datetime), Node.js: Option<i64> (unix seconds). Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

…FC3339) Input params now accept OffsetDateTime and are serialized as RFC3339 (2024-01-01T00:00:00Z) to match API requirements. - Rust/Python: Option<OffsetDateTime> - Node.js: Option<i64> unix seconds (converted internally) - Java: Option<OffsetDateTime> - Go: *time.Time Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

start_date -> start_time: YYYY-MM-DDT00:00:00Z end_date -> end_time: YYYY-MM-DDT23:59:59Z Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

EconomicIndicatorInfo -> MacrodataIndicatorInfo EconomicIndicatorData -> MacrodataRecord EconomicIndicatorResponse -> MacrodataResponse Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

MacrodataIndicatorInfo -> MacrodataIndicator MacrodataRecord -> Macrodata Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

- start_date/release_at/next_release_at: timestamp_opt -> rfc3339_opt (API returns RFC3339 strings, not unix seconds) - EconomicIndicatorListResponse: rename data field to list Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

describe field can be null in API response; use null_as_default deserializer to map null -> Default (empty strings). Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Vec<T> does not implement IntoJValue; ObjectArray<T> does. Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

…uild Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

## Summary Two new methods on `FundamentalContext`: - `MacrodataIndicators(ctx, offset, limit)` — `GET /v1/quote/macrodata` — list all macroeconomic indicators (~619 total) - `Macrodata(ctx, indicatorCode, startDate, endDate, limit)` — `GET /v1/quote/macrodata/{indicator_code}` — fetch historical data for one indicator `startDate` / `endDate` accept `"YYYY-MM-DD"` strings and are sent to the API as `YYYY-MM-DDT00:00:00Z` / `YYYY-MM-DDT23:59:59Z`. ## New Types | Type | Description | |------|-------------| | `MultiLanguageText` | Localized text (English / Simplified Chinese / Traditional Chinese) | | `MacrodataIndicator` | Indicator metadata (code, country, category, periodicity, importance, etc.) | | `Macrodata` | One historical data point (period, actual/previous/forecast/revised values, release timestamps, unit) | | `MacrodataResponse` | `Info MacrodataIndicator` + `Data []Macrodata` | ## Time field formats All timestamp fields (`StartDate`, `ReleaseAt`, `NextReleaseAt`) are returned as `*time.Time` (UTC) — consistent with other SDK methods. ## Related - Upstream (all language SDKs): longbridge/openapi#540 --------- Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

…istResponse Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

- MacrodataIndicator.name: #[serde(default)] -> null_as_default - Macrodata.unit / unit_prefix: same - MacrodataResponse.info: add null_as_default (was missing entirely) - Derive Default on MacrodataIndicator and Macrodata to support null_as_default Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

- macrodata_indicators: add country param (MacrodataCountry enum), returns MacrodataIndicatorListResponse with count - macrodata: add offset param for pagination, response includes count - Add MacrodataImportance (1=Low/2=Medium/3=High) and MacrodataCountry enums Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

SDK accepts HK/CN/US/EU/JP/SG shortcodes; serde renames to full strings ('Hong Kong SAR China'/'China (Mainland)'/etc.) when serializing to query params. Java JNI also accepts both shortcodes and full strings. Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

…factor Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

…ng for country query param serde_urlencoded cannot serialize enums — convert MacrodataCountry to its API string value before building the query struct. Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

New SDK changes: - macrodata_indicators() gains country filter (MacrodataCountry enum) - macrodata() gains offset parameter for pagination - Both responses now include count (total records) - null deserialization bug fixed in SDK (name/unit/unit_prefix/info) CLI changes: - Add --country flag (HK/CN/US/EU/JP/SG) for indicator list filtering - --page now applies to both list and history (offset = (page-1) * limit) - JSON output includes top-level count field in both modes - Pretty list output prints total count above the table Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Syncs with longbridge/openapi#540 rename commits: - CLI command: macrodata → macroeconomic - SDK methods: macrodata_indicators → macroeconomic_indicators, macrodata → macroeconomic - SDK types: MacrodataIndicator → MacroeconomicIndicator, MacrodataResponse → MacroeconomicResponse, etc. - Internal functions renamed accordingly finance-calendar macrodata subcommand is unaffected (different feature). Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

…ods (#99) ## Summary Two new methods on `FundamentalContext`: - `MacroeconomicIndicators(ctx, country, offset, limit)` — `GET /v1/quote/macrodata` — list macroeconomic indicators; filter by country (`MacroeconomicCountryHK/CN/US/EU/JP/SG`); response includes `Count` (total matching) - `Macroeconomic(ctx, indicatorCode, startDate, endDate, offset, limit)` — `GET /v1/quote/macrodata/{indicator_code}` — historical data for a specific indicator; `startDate` / `endDate` accept `"YYYY-MM-DD"` strings; response includes `Count` (total data points) ## New Types | Type | Description | |------|-------------| | `MultiLanguageText` | Localized text (English / Simplified Chinese / Traditional Chinese) | | `MacroeconomicCountry` | Country filter (`MacroeconomicCountryHK/CN/US/EU/JP/SG`); converts to full name for API | | `MacroeconomicImportance` | `MacroeconomicImportanceLow=1` / `Medium=2` / `High=3` | | `MacroeconomicIndicator` | Indicator metadata | | `MacroeconomicIndicatorListResponse` | `Data []MacroeconomicIndicator` + `Count int32` | | `Macroeconomic` | One historical data point | | `MacroeconomicResponse` | `Info MacroeconomicIndicator` + `Data []Macroeconomic` + `Count int32` | ## Related - Upstream (all language SDKs): longbridge/openapi#540 --------- Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

## Summary New `longbridge macrodata` command — the indicator-dimension counterpart of `finance-calendar macrodata` (which is the release-time dimension). Same underlying data, organised by indicator instead of by date. Two modes: - **List**: `longbridge macrodata` — all supported indicators (619 total: US/JP/EU/CN/HK/SG) - **History**: `longbridge macrodata <CODE>` — historical releases for one indicator ## Usage ```bash # List all indicators (default 20/page) longbridge macrodata longbridge macrodata --page 2 longbridge macrodata --country US --limit 50 # Query historical data longbridge macrodata US00175 longbridge macrodata US00175 --start 2024-01-01 --end 2024-12-31 # Language control longbridge --lang en macrodata US00175 longbridge --lang zh-CN macrodata --country US --limit 5 # AI/scripting longbridge macrodata --format json longbridge macrodata US00175 --format json ``` ## Options | Flag | Description | |------|-------------| | `[CODE]` | Indicator code. Omit to list all. | | `--country` | Filter list: `HK` / `CN` / `US` / `EU` / `JP` / `SG` | | `--start YYYY-MM-DD` | History start (sent as `T00:00:00Z`) | | `--end YYYY-MM-DD` | History end (sent as `T23:59:59Z`) | | `--limit` | Records per page, default 20 | | `--page` | 1-based page number | | `--lang` | Language for names/descriptions (`zh-CN` / `zh-HK` / `en`) | ## JSON output ```json // List { "count": 619, "page": 1, "limit": 20, "has_more": true, "list": [{ "indicator_code": "US00175", "name": "CPI ...", "category": "...", ... }] } // History { "count": 1, "page": 1, "limit": 20, "has_more": false, "info": { "indicator_code": "US00175", "name": "CPI ...", ... }, "data": [{ "period": "2026-05-01", "actual_value": "0.5", "release_at": 1781094600, ... }] } ``` - `name` / `describe` / `unit` collapsed to a single string per the `--lang` flag - Timestamps are Unix integers (consistent with other CLI commands) - `count` + `has_more` allow reliable pagination ## SDK dependency Uses `FundamentalContext::macroeconomic_indicators` / `FundamentalContext::macroeconomic` from `longbridge/openapi#540` (merged into main). ## Test plan - [ ] `longbridge macrodata` — list with Total, 20 rows - [ ] `longbridge macrodata --country JP` — 94 Japanese indicators - [ ] `longbridge macrodata --page 2` — next page - [ ] `longbridge macrodata US00175` — history pretty, shows actual/forecast/previous - [ ] `longbridge macrodata --format json` — has `count`, `page`, `limit`, `has_more` - [ ] `longbridge macrodata US00175 --format json` — timestamps are integers - [ ] `longbridge --lang en macrodata US00175` — English name - [ ] `longbridge macrodata INVALID` — `Error: Indicator code 'INVALID' not found` - [ ] `longbridge macrodata US00175 --country US` — warns `--country is ignored when CODE is specified` - [ ] `longbridge finance-calendar macrodata` — unaffected 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: Jason Lee <huacnlee@gmail.com>

…1085) ## Summary 新增宏观经济数据相关文档，三语言（en / zh-CN / zh-HK）同步。 ### SDK docs（`docs/{lang}/docs/fundamental/fundamental/`） - 新增 `macroeconomic-indicators.md` — `macroeconomic_indicators` 方法（参数：country、keyword、offset、limit） - 新增 `macroeconomic.md` — `macroeconomic` 方法 - Schema 字段类型修正：`name`、`describe`、`unit`、`unit_prefix` 已改为 `string`（v2 breaking change） - MacroeconomicCountry value 改为缩写：HK / CN / US / EU / JP / SG - JSON 示例仅保留 v2 实际返回字段 ### CLI docs（`docs/{lang}/docs/cli/fundamentals/`） - 新增 `macrodata.md` — `longbridge macrodata` 命令 - 选项：`--country`、`--keyword`、`--lang`、`--start`/`--end`、`--limit`、`--page`、`--format` - JSON 响应结构说明（含 `page`、`limit`、`has_more`） ### MCP docs - `mcp.md` 三语言 capabilities 表格追加宏观经济指标、补充实时行情链接 ### Changelog & Release Notes - `changelog.md` 追加 2026-06-25 条目（SDK v4.3.3 + CLI v0.23.4） - `cli/release-notes.md` 追加 v0.23.4 条目 ## Related PRs - CLI: longbridge/longbridge-terminal#239 - SDK: longbridge/openapi#540 (merged), #543 (merged, v2 endpoints) - MCP: longbridge/longbridge-mcp#79 - Go SDK: longbridge/openapi-go#100 (merged) 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

hogan-yuan and others added 10 commits June 9, 2026 19:33

refactor: rename macrodata_list to macrodata_indicators

6a63c8a

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

fix: macrodata params use YYYY-MM-DD date strings

4f8c163

start_date -> start_time: YYYY-MM-DDT00:00:00Z end_date -> end_time: YYYY-MM-DDT23:59:59Z Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

refactor: rename EconomicIndicator* types to Macrodata* prefix

72fe728

EconomicIndicatorInfo -> MacrodataIndicatorInfo EconomicIndicatorData -> MacrodataRecord EconomicIndicatorResponse -> MacrodataResponse Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

refactor: simplify Macrodata type names

c419216

MacrodataIndicatorInfo -> MacrodataIndicator MacrodataRecord -> Macrodata Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

fix(ci): fix format and stale method name in Java JNI binding

591849d

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

chore: remove accidentally committed test file and worktree

a73cbe6

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

hogan-yuan changed the title ~~feat(fundamental): add economic_indicator_list and economic_indicator~~ feat(fundamental): add macrodata_indicators and macrodata methods Jun 10, 2026

hogan-yuan mentioned this pull request Jun 10, 2026

feat(fundamental): add MacrodataIndicators and Macrodata methods longbridge/openapi-go#98

Merged

hogan-yuan and others added 3 commits June 10, 2026 11:50

fix: handle null MultiLanguageText in MacrodataIndicator

65a99d4

describe field can be null in API response; use null_as_default deserializer to map null -> Default (empty strings). Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

fix(java): wrap Vec<MacrodataIndicator> in ObjectArray for JNI return

18076a0

Vec<T> does not implement IntoJValue; ObjectArray<T> does. Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

chore: update nodejs/index.d.ts with auto-generated types from napi b…

3117cf0

…uild Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

hogan-yuan and others added 2 commits June 10, 2026 13:58

refactor: rename EconomicIndicatorListResponse to MacrodataIndicatorL…

b52beed

…istResponse Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

chore: release 4.3.1

3292649

hogan-yuan mentioned this pull request Jun 10, 2026

feat: add macrodata_indicators and macrodata tools longbridge/longbridge-mcp#79

Merged

3 tasks

hogan-yuan and others added 8 commits June 10, 2026 17:00

fix: trim MacrodataCountry to 6 supported countries (HK/CN/US/EU/JP/SG)

103ea5b

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

fix(python): restore MacrodataIndicatorListResponse struct lost in re…

4e3e012

…factor Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

fix(ci): apply cargo fmt formatting fixes

fd091ea

fix(ci): apply nightly cargo fmt to fix all formatting issues

0dece23

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

hogan-yuan and others added 2 commits June 10, 2026 19:26

Merge remote-tracking branch 'origin/main' into feat/economic-indicator

ebb624b

refactor: rename macrodata -> macroeconomic in all interfaces and types

779f78c

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

hogan-yuan and others added 4 commits June 11, 2026 10:05

refactor: rename Macrodata (data point type) to Macroeconomic

b7b3664

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

refactor: rename all remaining macrodata -> macroeconomic

537bc83

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

style: apply cargo fmt

226eec2

docs: update CHANGELOG for macroeconomic API with correct naming

82b417e

hogan-yuan changed the title ~~feat(fundamental): add macrodata_indicators and macrodata methods~~ feat(fundamental): add macroeconomic_indicators and macroeconomic methods Jun 11, 2026

hogan-yuan mentioned this pull request Jun 11, 2026

feat(fundamental): add MacroeconomicIndicators and Macroeconomic methods longbridge/openapi-go#99

Merged

hogan-yuan merged commit 534dfe0 into main Jun 11, 2026
56 checks passed

hogan-yuan deleted the feat/economic-indicator branch June 11, 2026 09:29

This was referenced Jun 12, 2026

chore: release 4.3.2 #544

Closed

docs: add macrodata SDK + CLI + MCP docs (SDK v4.3.3, CLI v0.23.4) longbridge/developers#1085

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(fundamental): add macroeconomic_indicators and macroeconomic methods#540

feat(fundamental): add macroeconomic_indicators and macroeconomic methods#540
hogan-yuan merged 29 commits into
mainfrom
feat/economic-indicator

hogan-yuan commented Jun 9, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

hogan-yuan commented Jun 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

New Types

Fixes

Related

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

hogan-yuan commented Jun 9, 2026 •

edited

Loading