bigdata_country_tearsheet

Returns a comprehensive country economic tearsheet.

Overview

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

When to Use

The Country Tearsheet is ideal for:

• Economic Calendar: Upcoming economic releases and calendar events
• Macroeconomic Analysis: GDP, CPI, unemployment, interest rates
• Sector-Specific Data: Housing, manufacturing, retail, trade, energy, and more
• Central Bank & Monetary Policy: Interest rate decisions, QE/QT programs, policy statements
• Fiscal Policy: Government budget, debt data, securities auctions
• 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:

1. Economic calendar data is pulled from official government and central bank sources
2. Macroeconomic indicators are organized into 15 sectoral categories with latest releases
3. Market indices are retrieved in real-time from major stock exchanges
4. Currency data is sourced from forex markets with live pricing
5. Treasury yields (US only) come from the US Department of Treasury
6. G7 comparisons provide peer context across major economies

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 (Historical economic indicators available for all supported countries where data is published)

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. Macroeconomic Overview

Sectoral breakdown of recent economic indicators organized into 15 comprehensive categories. Category availability varies by country - some countries may have data across all 15 categories (e.g., United States), while others may have a subset based on what economic indicators are published by that country’s statistical agencies.

Each available indicator shows:

• Latest Release Value (actual)
• Consensus Forecast (expected)
• Surprise Percentage (actual vs. consensus)
• Release Frequency (monthly, quarterly, annual)
• Impact Level (HIGH, MEDIUM, LOW)

Available Categories (US Example - Coverage Varies by Country)

GDP & Growth

Economic output and expansion metrics:

• GDP growth rates (QoQ, YoY, annualized)
• GDP components (consumption, investment, government spending, net exports)
• GDP deflator and real vs nominal GDP
• Economic growth momentum indicators

Labor Market

Employment and workforce indicators:

• Employment change and job creation data
• Unemployment rates (headline, underemployment)
• Labor force participation rates
• Average hourly earnings and wage growth
• Initial and continuing jobless claims
• Non-farm payrolls and private sector employment

Inflation & Prices

Price level and inflation metrics:

• Consumer Price Index (CPI) - headline and core
• Producer Price Index (PPI)
• Personal Consumption Expenditures (PCE) Price Index
• Import/export price indices
• Month-over-month and year-over-year inflation rates

Consumer & Business Sentiment

Economic confidence and survey data:

• Consumer confidence indices
• Business sentiment surveys
• Manufacturing and services PMI (Purchasing Managers’ Index)
• Leading economic indicators
• Small business optimism
• Regional Fed surveys (e.g., Philly Fed, Empire State)

Manufacturing & Services

Industrial production and factory activity:

• Manufacturing output and capacity utilization
• Industrial production indices
• Factory orders (durable and non-durable goods)
• Manufacturing PMI and ISM indices
• Services sector activity and growth
• New orders and production backlogs

Housing Market

Residential real estate and construction:

• Housing starts and building permits
• New and existing home sales
• Home price indices (Case-Shiller, FHFA)
• Mortgage applications and rates
• Housing inventory levels
• Construction spending

Retail & Consumer Spending

Consumer spending and sales data:

• Retail sales (headline and ex-autos)
• E-commerce sales
• Same-store sales growth
• Consumer spending patterns by category
• Holiday shopping metrics
• Auto sales

Trade & International

International trade and balance of payments:

• Trade balance (goods and services)
• Exports and imports by category
• Current account balance
• Trade deficit/surplus trends
• Major trading partner data

Inventories & Supply Chain

Business inventory levels:

• Wholesale inventories
• Retail inventories
• Manufacturing inventories
• Inventory-to-sales ratios
• Supply chain indicators

Credit & Monetary

Lending and credit conditions:

• Consumer credit outstanding
• Credit card debt and revolving credit
• Auto loans and mortgages
• Credit growth rates
• Delinquency and default rates
• Bank lending standards

Central Bank & Monetary Policy

Monetary policy and central bank actions:

• Interest rate decisions (policy rates)
• Federal Reserve/ECB/BOJ meeting minutes and statements
• Quantitative easing/tightening programs
• Forward guidance and policy outlook
• Balance sheet changes
• Voting member positions (hawks vs doves)

Regional Economic Indicators

Sub-national and regional economic data:

• State-level employment and GDP
• Regional manufacturing indices
• Metropolitan area economic indicators
• Regional housing markets
• Local business conditions

Energy & Commodities

Energy production, consumption, and prices:

• Crude oil inventories (EIA data)
• Natural gas storage levels
• Gasoline prices and demand
• Energy production by source
• Refinery utilization rates

Government Securities Auctions

Treasury auctions and debt issuance:

• Treasury bill, note, and bond auctions
• Auction bid-to-cover ratios
• Yield outcomes and demand metrics
• Primary dealer participation
• Foreign and domestic demand breakdown

Fiscal Policy

Government spending and budget data:

• Budget balance (deficit/surplus)
• Government spending by category
• Tax revenue collections
• Debt ceiling developments
• Fiscal stimulus programs

Note on Data Availability: The categories shown above represent the maximum coverage available (as seen for major economies like the United States). Individual countries will return different subsets based on their published economic data. For example:

• Major Economies (US, UK, Germany, Japan): Typically 10-15 categories available
• Emerging Markets: May have 5-10 categories available
• Smaller Markets: May focus on core categories (GDP, Labor, Inflation, Trade, Central Bank)

The tearsheet will only return categories that have published data for the requested country.

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

Macroeconomic Overview

The sectoral organization of economic indicators allows for:

• Thematic Analysis: Group related indicators to understand specific aspects of the economy (e.g., all housing data together)
• Surprise Tracking: Monitor which sectors are beating or missing expectations consistently
• Leading vs Lagging: Identify which sectors provide early signals (sentiment, housing permits) vs confirmatory data (unemployment, inflation)
• Frequency Awareness: Understand release schedules (monthly retail sales, quarterly GDP, etc.)
• Impact Assessment: Prioritize high-impact releases that drive market movements

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.

Sector-Specific Analysis

Deep dive into specific economic sectors (housing, manufacturing, retail) to identify trends, turning points, and investment opportunities.

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.

Nowcasting

Combine recent releases across all 15 sectors to estimate current economic state in real-time, before official GDP releases.

Policy Analysis

Track central bank decisions, fiscal policy changes, and government auctions to understand policy direction and market implications.

---