Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Migrate from Trading Economics

This guide helps Trading Economics users map their existing workflows to OMNI Datastream equivalents. OMNI provides a narrower but deeper macro surface focused on high-signal indicators with factor-aware intelligence overlays that Trading Economics does not offer.

​
Endpoint mapping

Trading EconomicsOMNI DatastreamNotes
GET /indicatorsGET /v1/macro/indicatorsFilter by country and indicator key
GET /calendarGET /v1/macro/calendarUpcoming macro events with country and days params
GET /forecastGET /v1/macro/forecastsForward estimates with horizons param
GET /historicalGET /v1/macro/indicatorsSame endpoint, use limit for depth
GET /markets/commoditiesGET /v1/market/snapshotsPass commodity ETF symbols
GET /markets/currencyGET /v1/market/snapshotsPass FX pair symbols
GET /markets/indexGET /v1/market/indicesSupported index inventory
GET /newsGET /v1/newsNews feed
Country overviewPOST /v1/intelligence/country-reportFactor-aware country analysis — goes beyond TE
N/AGET /v1/macro/high-signal-packCurated daily indicator bundles per country — no TE equivalent
N/AGET /v1/macro/regimesMacro regime classification — no TE equivalent

​
Key differences

​
What OMNI adds beyond Trading Economics

  • High-signal packs: Curated daily/weekly indicator bundles for 12 countries (US, CN, JP, TW, IL, CA, GB, EZ, KR, BR, IN, SA) including yield curves, credit spreads, breakeven inflation, and volatility.
  • Macro regime classification: Automated regime detection (expansion, contraction, recovery, overheating) with factor-aware conditioning.
  • Country reports: AI-powered country analysis that integrates macro data with factor positioning and risk signals.
  • Factor-conditioned macro: Unique overlay of macro indicators with equity factor performance.

​
What Trading Economics covers that OMNI does not (yet)

  • Breadth: TE covers 15,000+ series across 196 countries. OMNI focuses on the 100-200 highest-signal series for allocators.
  • Excel/Sheets plugins: TE has native spreadsheet integrations. OMNI provides SDKs (JS, Python, Go, Rust) and MCP.
  • Commodity/FX spot prices as dedicated series: OMNI provides these via market snapshots and factor proxies rather than as standalone macro series.

​
Authentication

Trading Economics uses a client key in the query string. OMNI uses a Bearer token in the Authorization header: 
# Trading Economics
curl "https://api.tradingeconomics.com/calendar?c=YOUR_KEY"

# OMNI Datastream
curl -H "Authorization: Bearer $OMNI_API_KEY" \
  "https://api.secapi.ai/v1/macro/calendar?country=US"

​
Example: get US macro indicators

# Trading Economics - US GDP
curl "https://api.tradingeconomics.com/historical/country/united%20states/indicator/gdp?c=KEY"

# OMNI Datastream - US GDP
curl -H "Authorization: Bearer $OMNI_API_KEY" \
  "https://api.secapi.ai/v1/macro/indicators?country=US&indicator=GDPC1"

​
Example: get macro calendar

# Trading Economics
curl "https://api.tradingeconomics.com/calendar?c=KEY"

# OMNI Datastream
curl -H "Authorization: Bearer $OMNI_API_KEY" \
  "https://api.secapi.ai/v1/macro/calendar?country=US&days=7"

​
Example: country analysis (OMNI exclusive)

curl -X POST -H "Authorization: Bearer $OMNI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "US", "lookback": "6m"}' \
  "https://api.secapi.ai/v1/intelligence/country-report"