Macroeconomic Indicators

List macroeconomic indicators available through LongPort, optionally filtered by country.

SDK Links

Python	longport.openapi.FundamentalContext.macroeconomic_indicators
Rust	longport::fundamental::FundamentalContext#macroeconomic_indicators
Go	FundamentalContext.MacroeconomicIndicators
Node.js	FundamentalContext#macroeconomicIndicators

Parameters

SDK method parameters.

Name	Type	Required	Description
country	MacroeconomicCountry	NO	Filter by country. Omit for all countries.
keyword	string	NO	Fuzzy search by indicator name (case-insensitive)
offset	int	NO	Pagination offset. Default: 0
limit	int	NO	Max records per page. Default: 100, max: 1000

MacroeconomicCountry

Value	Country
HK	Hong Kong SAR
CN	China (Mainland)
US	United States
EU	Euro Zone
JP	Japan
SG	Singapore

Request Example

from longport.openapi import FundamentalContext, Config, OAuthBuilder, MacroeconomicCountry

oauth = OAuthBuilder("your-client-id").build(lambda url: print("Visit:", url))
config = Config.from_oauth(oauth)
ctx = FundamentalContext(config)

# All indicators
resp = ctx.macroeconomic_indicators()
print(resp)

# US only
resp = ctx.macroeconomic_indicators(country=MacroeconomicCountry.UnitedStates, limit=50)
print(resp)

# Search by keyword
resp = ctx.macroeconomic_indicators(keyword="payroll")
print(resp)

import asyncio
from longport.openapi import AsyncFundamentalContext, Config, OAuthBuilder, MacroeconomicCountry

async def main() -> None:
    oauth = await OAuthBuilder("your-client-id").build_async(lambda url: print("Visit:", url))
    config = Config.from_oauth(oauth)
    ctx = AsyncFundamentalContext.create(config)
    resp = await ctx.macroeconomic_indicators(country=MacroeconomicCountry.UnitedStates)
    print(resp)

if __name__ == "__main__":
    asyncio.run(main())

const { Config, FundamentalContext, OAuth, MacroeconomicCountry } = require('longport')

async function main() {
  const oauth = await OAuth.build('your-client-id', (_, url) => {
    console.log('Open this URL to authorize: ' + url)
  })
  const config = Config.fromOAuth(oauth)
  const ctx = FundamentalContext.new(config)
  const resp = await ctx.macroeconomicIndicators({ country: MacroeconomicCountry.UnitedStates })
  console.log(resp)
}
main().catch(console.error)

import com.longport.*;
import com.longport.fundamental.*;

class Main {
    public static void main(String[] args) throws Exception {
        try (OAuth oauth = new OAuthBuilder("your-client-id").build(url -> System.out.println("Open to authorize: " + url)).get();
             Config config = Config.fromOAuth(oauth);
             FundamentalContext ctx = FundamentalContext.create(config)) {
            var resp = ctx.getMacroeconomicIndicators(null, null, null).get();
            System.out.println(resp);
        }
    }
}

use std::sync::Arc;
use longport::{oauth::OAuthBuilder, fundamental::FundamentalContext, Config};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let oauth = OAuthBuilder::new("your-client-id").build(|url| println!("Open: {url}")).await?;
    let config = Arc::new(Config::from_oauth(oauth));
    let ctx = FundamentalContext::new(config);
    let resp = ctx.macroeconomic_indicators(None, None, None).await?;
    println!("{:?}", resp);
    Ok(())
}

Response

Response Example

{
  "count": 619,
  "list": [
    {
      "indicator_code": "62267",
      "country": "US",
      "name": "Non-Farm Payroll",
      "periodicity": "Monthly",
      "describe": "Employment situation report...",
      "importance": 3
    }
  ]
}

Response Status

Status	Description	Schema
200	Success	MacroeconomicIndicatorListResponse
400	Bad request	None

Schemas

MacroeconomicIndicatorListResponse

Name	Type	Required	Description
list	MacroeconomicIndicator[]	true	Indicator list
count	int	true	Total number of matching indicators

MacroeconomicIndicator

Name	Type	Required	Description
indicator_code	string	true	Indicator code (use as input to macroeconomic)
country	string	true	Country name
name	string	true	Indicator name
periodicity	string	true	Release periodicity (e.g. Monthly, Quarterly)
describe	string	true	Indicator description
importance	int	true	Importance level (1 = Low, 2 = Medium, 3 = High)