{
  "name": "MacroPulse",
  "description": "Real-time macro intelligence API for forex and CFD traders. Synthesizes live data from FRED, CFTC, Alpha Vantage, EIA, CoinGecko, and Tavily into structured, actionable intelligence. 9 endpoints covering session briefs, economic events, COT positioning, commodities, equities, economic calendar, crypto, EIA inventory, and directional sentiment. Pay-per-query via x402 micropayments on Base.",
  "url": "https://macropulse-alpha.vercel.app",
  "version": "1.0.0",
  "capabilities": [
    "forex-intelligence",
    "session-briefs",
    "economic-events",
    "cot-positioning",
    "commodity-prices",
    "equity-indices",
    "economic-calendar",
    "crypto-context",
    "petroleum-inventory",
    "directional-sentiment",
    "institutional-positioning",
    "central-bank-analysis"
  ],
  "supported_instruments": [
    "EURUSD", "GBPUSD", "USDJPY", "AUDUSD", "USDCAD", "USDCHF", "NZDUSD",
    "XAUUSD (gold)", "WTI crude oil", "Brent crude oil", "silver",
    "BTC/USD", "ETH/USD",
    "S&P 500 (SPY)", "Nasdaq 100 (QQQ)", "Dow Jones (DIA)",
    "DAX", "FTSE 100", "Nikkei", "ASX 200"
  ],
  "data_sources": [
    "FRED (Federal Reserve Economic Data) — rates, FX, CPI, unemployment, commodities",
    "CFTC Socrata API — Commitment of Traders positioning (free, no key)",
    "Alpha Vantage — US equity index EOD data",
    "EIA — weekly petroleum inventory",
    "CoinGecko — BTC/ETH prices and market data",
    "alternative.me — Fear & Greed index",
    "Tavily — real-time news synthesis"
  ],
  "payment": {
    "protocol": "x402",
    "network": "eip155:8453",
    "asset": "USDC",
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc"
  },
  "endpoints": [
    { "path": "/api/session-brief", "method": "GET", "description": "Forex session intelligence — risk tone, top pair biases with key levels, scheduled events, rates snapshot, equity context, crypto context, and agent action. Session auto-detected from UTC time.", "parameters": [{"name": "session", "in": "query", "required": false, "description": "asian|london|newyork"}], "price_usd": 0.10, "payment_required": true },
    { "path": "/api/event-pulse", "method": "GET", "description": "Economic event deep-dive — forecast vs consensus, historical context, forex market impact. Supported: NFP, CPI, FOMC, GDP, PPI, PCE, ISM, JOLTS, RETAIL_SALES, ECB, BOJ, BOE, RBA, RBNZ, BOC.", "parameters": [{"name": "event", "in": "query", "required": true}], "price_usd": 0.20, "payment_required": true },
    { "path": "/api/crypto-pulse", "method": "GET", "description": "BTC/ETH snapshot, Fear & Greed index, market dominance, macro link to traditional markets and forex risk appetite.", "price_usd": 0.05, "payment_required": true },
    { "path": "/api/commodities-pulse", "method": "GET", "description": "Gold, silver, WTI, Brent crude — prices, posture, Brent/WTI spread, and forex impact on commodity-linked currencies (AUD, CAD, NOK, JPY).", "price_usd": 0.10, "payment_required": true },
    { "path": "/api/equities-pulse", "method": "GET", "description": "Global equity index snapshot — US indices via Alpha Vantage EOD, international context via news synthesis. Session-aware: Asian session leads with Nikkei/ASX, London with DAX/FTSE, NY with S&P/Nasdaq.", "parameters": [{"name": "session", "in": "query", "required": false}], "price_usd": 0.10, "payment_required": true },
    { "path": "/api/calendar", "method": "GET", "description": "Weekly economic calendar — high-impact events by currency, central bank meeting schedule, peak volatility windows, and agent action.", "price_usd": 0.10, "payment_required": true },
    { "path": "/api/cot", "method": "GET", "description": "CFTC Commitment of Traders positioning for 7 major currency pairs (EUR, GBP, JPY, AUD, CAD, CHF, NZD). Net speculator positions, week-over-week change, extreme/crowded trade flags, and contrarian alerts.", "price_usd": 0.15, "payment_required": true },
    { "path": "/api/eia-inventory", "method": "GET", "description": "EIA weekly petroleum status report — crude oil, gasoline, and distillate stocks with draw/build direction, WTI price impact, and forex impact on CAD and NOK.", "price_usd": 0.10, "payment_required": true },
    { "path": "/api/sentiment", "method": "GET", "description": "Directional sentiment for any forex pair — score 0-100, conviction level, component breakdown (news tone, technical bias, risk environment, momentum), key level to watch, and next catalyst.", "parameters": [{"name": "pair", "in": "query", "required": true, "description": "e.g. EURUSD, GBPUSD, USDJPY, XAUUSD"}], "price_usd": 0.05, "payment_required": true }
  ],
  "openapi": "https://macropulse-alpha.vercel.app/openapi.json",
  "llms_txt": "https://macropulse-alpha.vercel.app/llms.txt",
  "contact": "https://macropulse-alpha.vercel.app"
}