macropulse
MacroPulse: Real-time macro intelligence for forex and CFD traders. All endpoints require x402 payment (USDC on Base mainnet) via the PAYMENT-SIGNATURE header.
Coverage: Global
Endpoints: • session-brief ($0.10): Forex session brief • event-pulse ($0.20): Economic event deep-dive • crypto-pulse ($0.05): Crypto market context • commodities-pulse ($0.10): Commodities brief • calendar ($0.10): Weekly economic calendar • cot ($0.02): CFTC Commitments of Traders positioning — 21 markets, deterministic • bls-series ($0.02): US labor statistics by BLS series id — deterministic, computed YoY • eia-inventory ($0.10): Weekly EIA petroleum inventory intelligence for energy and macro agents — crude, gasoline and distillate builds and draws versus expectations, with the oil-price and CAD/NOK implications. • intermarket ($0.15): Cross-asset intermarket synthesis for macro agents — bond yields, equities, commodities and FX read together to surface the dominant regime and the divergences that tend to lead price. • rates-differential ($0.10): Interest-rate differential and carry intelligence for FX agents — G10 policy rates, yield spreads and the carry-trade map that drives durable currency trends. • regime ($0.10): Macro regime classifier for multi-asset agents — labels the current environment (risk-on/off, reflation, stagflation, tightening) and its directional implications for FX, rates and equities. • convert ($0.005): Currency conversion at the official ECB reference rate • is-open ($0.005): Is the stock market open right now? Exchange status, trading hours and holiday calendar • us ($0.01): Official US macro indicators read from Chainlink contracts (GDP, PCE, SOFR) • us-revisions ($0.02): The revision trail of a US macro series, from immutable on-chain round history • sentiment ($0.05): Real-time directional sentiment for any forex pair or gold — retail crowd positioning, COT institutional alignment, and a clear contrarian bias call. Built for FX trading and advisor agents.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | ISO 8601 timestamp to evaluate. Default: now. | |
| to | No | Target currency, or a comma-separated list (max 30). | |
| date | No | YYYY-MM-DD. Returns that day's ECB fixing, or the last fixing on or before it (whose date is reported back in `date`, with is_last_available_fixing=true). Omit for the latest. | |
| from | No | Source currency, ISO 4217 alpha-3. | |
| lang | No | Response language code (en | es | fr | de | zh | hi | ar | pt | ja | ko | etc.) | |
| pair | No | pair | |
| event | No | Economic event identifier | |
| limit | No | How many prints to walk back. Default 8, max 24. | |
| action | Yes | Which endpoint to call. Options: session-brief | event-pulse | crypto-pulse | commodities-pulse | calendar | cot | bls-series | eia-inventory | intermarket | rates-differential | regime | convert | is-open | us | us-revisions | sentiment | |
| amount | No | Amount to convert. Default 1 (the raw rate). | |
| series | No | Up to 5 comma-separated BLS series ids or aliases | |
| session | No | Trading session. Auto-detected from UTC time if omitted. | |
| exchange | No | Exchange code. Aliases accepted (TSE->JPX, XNYS->NYSE, FRANKFURT->XETRA, ...). |