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>

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(macroeconomic): add macroeconomic_indicators and macroeconomic tools longbridge/longbridge-mcp#79

Open

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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

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

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