Macroeconomic Indicators

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

CLI

# List all indicators
longbridge macrodata
# Filter by US indicators
longbridge macrodata --country US

SDK Links

Python	longbridge.openapi.FundamentalContext.macroeconomic_indicators
Rust	longbridge::fundamental::FundamentalContext#macroeconomic_indicators
Go	FundamentalContext.MacroeconomicIndicators
Node.js	FundamentalContext#macroeconomicIndicators
Java	FundamentalContext.getMacroeconomicIndicators
C++	longbridge::fundamental::FundamentalContext::macroeconomic_indicators

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 longbridge.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 longbridge.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('longbridge')

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.longbridge.*;
import com.longbridge.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 longbridge::{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": "61744",
      "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)