# EconSignalPulse

> Alternative economic intelligence API covering 190+ countries. Combines World Bank Open Data, IMF Datamapper forecasts, satellite nighttime lights research, and AIS shipping signals to produce institutional-grade sovereign intelligence. Designed for hedge funds, development finance institutions, corporate treasury teams, and AI agents that need to verify, contextualize, or act on global economic data. Pay-per-query via x402 micropayments on Base.

## What This Is

EconSignalPulse is a pay-per-query API that synthesizes official economic data with alternative signals to produce intelligence that investment banks charge thousands of dollars for. It covers GDP trajectories, inflation dynamics, sovereign credit stress, recession probabilities, trade flows, frontier market intelligence, and sanctions impact — all gated by x402 micropayments.

Every response is generated by Claude using live data from:
- World Bank Open Data API (free, no key — GDP, inflation, trade, debt, FDI, poverty)
- IMF World Economic Outlook Datamapper API (free, no key — GDP/inflation/CA/debt/unemployment forecasts)
- Tavily web search (satellite research, AIS shipping, credit ratings, CDS spreads, news synthesis)

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

To use: send a GET request without a PAYMENT-SIGNATURE header to receive a 402 response with payment requirements. Sign the payment and retry with the PAYMENT-SIGNATURE header.

## Endpoints

GET /api/econsignal/nightlights?country={name}&iso2={code}&period={1y|3y|5y|10y}&lang={en|es|fr|...}
- Returns: satellite nighttime lights analysis vs official GDP — divergence detection, adjusted growth estimate, investment implications
- Detects when government-reported GDP diverges from satellite evidence (China, Russia, Venezuela, Iran, etc.)
- Data: World Bank GDP + electricity access + Tavily VIIRS/DMSP satellite research synthesis
- Price: $0.15

GET /api/econsignal/gdp-tracker?country={name}&iso2={code}&iso3={code}&lang={en|es|fr|...}
- Returns: GDP growth history (World Bank), IMF forward projections, peer ranking, structural drivers, risks
- Covers 190+ countries; both historical series and 5-year IMF forecast
- Data: World Bank Open Data + IMF WEO Datamapper
- Price: $0.10

GET /api/econsignal/inflation-signals?country={name}&iso2={code}&iso3={code}&lang={en|es|fr|...}
- Returns: official CPI history, IMF inflation forecasts, alternative signals (food prices, FX depreciation, parallel markets), monetary policy stance, statistical credibility rating
- Flags manipulated CPI (Argentina, Venezuela, Zimbabwe history) with alternative estimates
- Data: World Bank + IMF + Tavily web synthesis
- Price: $0.08

GET /api/econsignal/country-brief?country={name}&iso2={code}&iso3={code}&focus={investment|trade|risk|macro|all}&lang={en|es|fr|...}
- Returns: full sovereign intelligence brief — macro snapshot, structural strengths/weaknesses, political risk, currency outlook, fiscal position, investment thesis, opportunity score, key risks
- Replaces $2,000+ investment bank emerging market research reports
- Data: World Bank + IMF + Tavily synthesis
- Price: $0.25

GET /api/econsignal/divergence?country={name}&iso2={code}&iso3={code}&lang={en|es|fr|...}
- Returns: gap analysis between official statistics and alternative data signals (satellite, AIS, electricity, mobility), credibility score, key distortions, investor implications
- Essential for countries with known statistical reliability issues
- Data: World Bank + IMF + Tavily alternative data synthesis
- Price: $0.20

GET /api/econsignal/recession-signals?country={name}&iso2={code}&iso3={code}&lang={en|es|fr|...}
- Returns: recession probability (0-100%), leading indicator dashboard (PMI, yield curve, consumer confidence, unemployment), structural context, historical analog, monitoring triggers
- Works for both developed markets and emerging/frontier economies
- Data: World Bank + IMF + Tavily leading indicators synthesis
- Price: $0.15

GET /api/econsignal/frontier-intel?country={name}&iso2={code}&iso3={code}&lens={investment|aid|supply-chain|demographics|all}&lang={en|es|fr|...}
- Returns: frontier and emerging market intelligence — macro snapshot, growth drivers, structural challenges, data quality assessment, development finance context, investment entry points, risk ratings
- Specializes in Sub-Saharan Africa, Central Asia, South/Southeast Asia, MENA frontier, Pacific Islands, Caribbean
- Data: World Bank + IMF + Tavily synthesis
- Price: $0.15

GET /api/econsignal/trade-flows?country={name}&iso2={code}&iso3={code}&partner={optional}&lang={en|es|fr|...}
- Returns: trade profile (exports/imports/CA), bilateral analysis with optional partner, shipping intelligence (key ports, AIS volume trends, route shifts), nearshoring signals, risk factors
- AIS shipping proxy captures real trade activity; tracks sanctions-driven rerouting
- Data: World Bank trade/CA data + IMF CA forecast + Tavily AIS/shipping synthesis
- Price: $0.15

GET /api/econsignal/credit-stress?country={name}&iso2={code}&iso3={code}&lang={en|es|fr|...}
- Returns: sovereign profile (debt/GDP, IMF program status), credit ratings, stress indicators (CDS spreads, banking sector health), vulnerability assessment (liquidity/solvency/rollover/contagion), stress score
- Essential for EM bond investors and trade credit insurers
- Data: World Bank debt + IMF fiscal forecasts + Tavily credit/ratings synthesis
- Price: $0.15

GET /api/econsignal/sanctions-impact?country={name}&iso2={code}&regime={OFAC|EU|UN|all}&lang={en|es|fr|...}
- Returns: sanctions profile, economic impact (GDP trajectory, key sector effects), satellite evidence (nightlights, AIS dark shipping), evasion assessment (routes, enablers, shadow fleet), compliance implications, effectiveness score
- Covers Russia, Iran, Venezuela, North Korea, Belarus, Myanmar, and all OFAC/EU/UN jurisdictions
- Data: World Bank GDP/trade + Tavily satellite/AIS/compliance synthesis
- Price: $0.20

## Language Support

All endpoints support lang parameter: en | es | fr | de | ja | zh | ko | pt | ar | hi

## Discovery

- OpenAPI spec: https://econsignalpulse.vercel.app/openapi.json
- Agent discovery: https://econsignalpulse.vercel.app/.well-known/agent.json
- LLMs.txt: https://econsignalpulse.vercel.app/llms.txt

## Notes for AI Agents

- All endpoints return structured JSON
- Country parameters: iso2 (World Bank) and iso3 (IMF) codes are both needed for full data access
- No API keys required — World Bank and IMF APIs are fully public; Tavily is handled server-side
- Disclaimer is appended automatically to every response where relevant
- MacroPulse cross-sell: for short-term forex trading signals (hours), see MacroPulse. EconSignalPulse covers structural macro (months/years horizon)
- All prices in USD via USDC micropayments on Base mainnet