bigdata_country_tearsheet - Bigdata.com API developer docs

Overview

The Country Tearsheet provides comprehensive macroeconomic analysis and market intelligence for 42+ countries worldwide. This tool delivers economic calendar events, market indices, currency data, and US Treasury yields in a single API call.

When to Use

The Country Tearsheet is ideal for:

Economic Calendar: Upcoming releases and recent economic data
Macroeconomic Analysis: GDP, CPI, unemployment, interest rates
Country Comparisons: G7 peer analysis across key indicators
Market Performance: Stock market indices and technical analysis
Currency Intelligence: Forex rates, trends, and cross-currency positioning
Yield Curve Analysis: US Treasury yields and spread analysis (US only)

How It Works

The Country Tearsheet aggregates data from multiple authoritative sources to provide a comprehensive economic overview:

Economic calendar data is pulled from FXStreet
Market indices are retrieved in real-time from FMP
Currency data is sourced from FMP
Treasury yields (US only) come from FMP

All data is returned in a single response, providing a complete macroeconomic picture of the requested country.

Parameters

Parameter	Type	Required	Description
`country`	string	Yes	2-letter country code (default: “US”). Only ONE country per request.

Important Notes

Each API call supports a single country - for multi-country analysis, multiple calls are required
If no country is specified, “US” is used as the default
Country codes are case-sensitive and must use the standard 2-letter ISO format

Supported Countries

Americas (7)

US CA MX BR AR CL CO

Europe (23)

UK DE FR IT ES NL SE NO DK FI CH AT BE IE PL PT GR CZ HU RO SK IS TR

Asia-Pacific (10)

JP CN HK SG KR IN AU NZ ID TH

Middle East & Africa (7)

AE SA QA KW IL EG ZA

Special

EMU (Eurozone) Total: 42 countries

Data Returned

1. Upcoming Events

Economic calendar for the next 14 days with HIGH and MEDIUM impact events:

Event name and indicator
Forecast value
Previous value
Release date and time (UTC)
Impact level
Data source

Example Events: GDP releases, CPI reports, unemployment data, central bank meetings, retail sales, manufacturing PMI, trade balance

2. Recent Economic Releases

Past 14 days of economic data with actual results:

Event name and indicator
Actual value (as released)
Forecast value (consensus)
Previous value
Release date and time
Variance from forecast

3. Country Comparison (G7 Peer Analysis)

Side-by-side comparison of key economic indicators across major economies:

Metric	Description
GDP Growth (QoQ)	Quarter-over-quarter GDP growth rate
GDP Growth (YoY)	Year-over-year GDP growth rate
GDP Growth (Annualized)	Annualized GDP growth rate
CPI (YoY)	Year-over-year consumer price inflation
Unemployment Rate	Current unemployment percentage
Interest Rate	Central bank policy rate

Countries Included: United States, Canada, United Kingdom, Germany, France, Italy, Japan

4. Market Indices

Real-time stock market performance data:

Primary Index

The country’s flagship stock market index:

US: S&P 500
Germany: DAX
UK: FTSE 100
Japan: Nikkei 225
France: CAC 40

Metrics Provided

Current price/level
Daily change (points and percentage)
52-week high and low
50-day moving average
200-day moving average
Trading volume

Regional Comparisons

Related regional indices for market context

5. Currencies

Comprehensive forex market analysis for the country’s base currency:

Spot Overview

Reference currency pair (e.g., EUR/USD, USD/JPY)
Current spot price
Previous close
24-hour percentage change
Direction indicator (up/down)

Trend & Momentum

50-day moving average
200-day moving average
MA spread (trend strength)
Distance to 52-week high
Distance to 52-week low

Performance Snapshot

Returns across multiple time horizons with trend classification:

1-day return
5-day return
1-month return
3-month return
Year-to-date return
1-year return

Cross-Currency Positioning

Multiple currency pairs showing strength relative to base currency:

Current exchange rates
Previous close
24-hour percentage change
Strength indicators (strengthening/weakening)

Example pairs: EUR/USD, USD/JPY, GBP/USD, USD/CHF, AUD/USD, USD/CAD

6. Yields (US Only)

Real-time US Treasury yield curve data across all maturities:

Yield Curve Overview

Short-term: 1M, 3M, 6M
Medium-term: 1Y, 2Y, 3Y, 5Y, 7Y
Long-term: 10Y, 20Y, 30Y

Current Rates

Latest yield rates for each maturity

Daily Changes

Basis point changes from previous close
Percentage changes
Direction indicators

Yield Curve Analysis

2s10s Spread: 10-year minus 2-year yield (recession indicator)
2s30s Spread: 30-year minus 2-year yield (curve steepness)
Curve shape classification (normal, flat, inverted)
Steepening/flattening indicators

Historical Context

Comparison to recent highs and lows
Trend indicators (rising/falling)
Volatility metrics

Example Usage

Basic Country Analysis

# Get me the economic tearsheet for the US
us_data = bigdata_country_tearsheet(country="US")

# Get German economic data
germany_data = bigdata_country_tearsheet(country="DE")

# Get Japanese country data
japan_data = bigdata_country_tearsheet(country="JP")

Use Case Examples

Macro Economic Research

# Compare European economies
countries = ["DE", "FR", "IT", "ES", "UK"]
for country in countries:
    data = bigdata_country_tearsheet(country=country)
    # Analyze economic indicators, market performance

Currency Trading Analysis

# Analyze EUR currency with Eurozone data
eur_data = bigdata_country_tearsheet(country="EMU")
# Review forex trends, cross-currency positioning, economic calendar

Fixed Income Analysis

# US Treasury yield curve analysis
us_treasuries = bigdata_country_tearsheet(country="US")
# Examine yield curve, spreads, curve shape

Emerging Markets Research

# Analyze emerging market economy
brazil_data = bigdata_country_tearsheet(country="BR")
india_data = bigdata_country_tearsheet(country="IN")
# Compare development indicators, growth metrics

Understanding the Data

Economic Calendar Events

Economic calendar events are classified by impact level:

HIGH Impact: Major releases that typically move markets (GDP, CPI, employment data, central bank decisions)
MEDIUM Impact: Important indicators that can influence specific sectors or markets
LOW Impact: Minor releases with limited market impact (excluded from tearsheet for clarity)

The tearsheet includes both upcoming events (next 14 days) and recent releases (past 14 days) for HIGH and MEDIUM impact events only.

G7 Peer Comparison

The G7 comparison provides context by showing how the requested country’s economic indicators compare to other major economies. This is particularly useful for:

Assessing relative economic strength
Identifying policy divergence (e.g., interest rate differentials)
Understanding competitive positioning
Spotting inflation or growth outliers

Yield Curve Analysis (US Only)

The yield curve shows the relationship between interest rates and time to maturity for US Treasury securities: Normal Curve: Long-term yields higher than short-term (healthy economy expecting growth) Flat Curve: Similar yields across maturities (economic uncertainty) Inverted Curve: Short-term yields higher than long-term (recession warning) The 2s10s spread (10-year minus 2-year) is the most watched recession indicator. A negative spread (inversion) has preceded every US recession in the past 50 years.

Use Cases

Macroeconomic Research

Monitor upcoming economic releases, track recent data surprises, and compare economic performance across countries to build macro investment themes.

Currency Trading

Use forex data, cross-currency positioning, and economic calendar events to inform currency trading strategies and risk management.

Fixed Income Strategy

Analyze US Treasury yield curves, spreads, and curve shape to develop duration and curve positioning strategies.

International Portfolio Allocation

Compare economic indicators, market performance, and development trends to allocate capital across countries and regions.

Economic Forecasting

Combine recent economic releases and upcoming events to build economic forecasts and scenario analysis.

Risk Management

Monitor economic calendars for high-impact events that could introduce volatility, and assess country-level risks using development indicators.

MCP Reference

Tools

OAuth MCP Integrations

API MCP Integrations

Prompt examples

​Overview

​When to Use

​How It Works

​Parameters

​Important Notes

​Supported Countries

​Americas (7)

​Europe (23)

​Asia-Pacific (10)

​Middle East & Africa (7)

​Special

​Data Returned

​1. Upcoming Events

​2. Recent Economic Releases

​3. Country Comparison (G7 Peer Analysis)

​4. Market Indices

​Primary Index

​Metrics Provided

​Regional Comparisons

​5. Currencies

​Spot Overview

​Trend & Momentum

​Performance Snapshot

​Cross-Currency Positioning

​6. Yields (US Only)

​Yield Curve Overview

​Current Rates

​Daily Changes

​Yield Curve Analysis

​Historical Context

​Example Usage

​Basic Country Analysis

​Use Case Examples

​Macro Economic Research

​Currency Trading Analysis

​Fixed Income Analysis

​Emerging Markets Research

​Understanding the Data

​Economic Calendar Events

​G7 Peer Comparison

​Yield Curve Analysis (US Only)

​Use Cases

​Macroeconomic Research

​Currency Trading

​Fixed Income Strategy

​International Portfolio Allocation

​Economic Forecasting

​Risk Management