Enterprise

Nations Atlas API

One endpoint for live sports data, the full 197-nation database, the weekly snapshot archive, commodity prices and exchange rates.

Live data status

Global sports feed

Updated 57 min ago

Player stats — Rugby

Updated 57 min ago

Player stats — Cricket

Updated 58 min ago

Player stats — Olympics

Updated 58 min ago

Player stats — NFL

Updated 58 min ago

Formula 1 hub

Updated 58 min ago

NFL hub

Updated 158 min ago

Player stats — Golf

Updated 158 min ago

Golf hub

Updated 158 min ago

Rugby hub

Updated 159 min ago

Cricket hub

Updated 159 min ago

Tennis hub

Updated 163 min ago

Olympics hub

Updated 550 min ago

Player stats — Football (Soccer)

Updated 1284 min ago

Player stats — MLB

Updated 4850 min ago

Player stats — NBA

Updated 7494 min ago

Country feeds warm for 66 countries · Latest weekly snapshot: 2026-10-24

Full freshness for every feed — including player statistics and per-country feeds — is on the data freshness page.

Authentication

Every request needs a personal API key, created in your profile under Nations Enterprise. Send it in the x-api-key header.

curl -H "x-api-key: YOUR_KEY" "https://global-nations-pulse.base44.app/functions/apiDataAccess?resource=nations"

Rate limits

Each key may make 10,000 requests per calendar month. Usage is shown live per key in your profile, and the counter resets automatically at the start of each month. Exceeding the quota returns HTTP 429.

Endpoints

sports

Global live sports feed

The complete live feed — matches in progress, latest results and upcoming fixtures across every sport, refreshed every 5 minutes. Add &format=csv for a flat CSV export.

curl -H "x-api-key: YOUR_KEY" "https://global-nations-pulse.base44.app/functions/apiDataAccess?resource=sports"
sports_country

Country sports feed

Results, fixtures and league ladders for a supported country.

  • country — Country slug, e.g. australia, england, india, usa. The full list is returned when an unsupported value is sent.
curl -H "x-api-key: YOUR_KEY" "https://global-nations-pulse.base44.app/functions/apiDataAccess?resource=sports_country&country=australia"
head_to_head

Head-to-head analytics

All-time record, last 5 meetings, current form and the next fixture for any two teams in any sport. Generated on demand (allow 10-20 seconds) and cached for 6 hours.

  • team_a — First team name, e.g. Australia.
  • team_b — Second team name, e.g. England.
curl -X POST -H "x-api-key: YOUR_KEY" -H "Content-Type: application/json" -d '{"resource":"head_to_head","team_a":"Australia","team_b":"England"}' https://global-nations-pulse.base44.app/functions/apiDataAccess
{
  "team_a": "Australia", "team_b": "England", "sport": "Cricket",
  "record": { "team_a_wins": 88, "team_b_wins": 110, "draws": 6 },
  "last_meetings": [ { "date": "…", "competition": "…", "result": "…" } ],
  "form_a": "…", "form_b": "…",
  "next_meeting": { "date_time": "…", "competition": "…", "venue": "…" }
}
player_stats

Live player statistics by sport

The top individual performers per sport — leading scorers, rankings, wickets, championship points — refreshed at least every 3 hours via live web search.

  • sport — One of soccer (default), cricket, tennis, f1, rugby, golf, nfl, olympics.
  • format — json (default) or csv.
curl -H "x-api-key: YOUR_KEY" "https://global-nations-pulse.base44.app/functions/apiDataAccess?resource=player_stats&sport=cricket"
price_history

Historical price series — commodities & stocks

Closing-price history for any tracked commodity or its associated stock tickers. Pass a Yahoo-style symbol, or a commodity slug and we resolve the symbol for you.

  • symbol — Yahoo-style symbol, e.g. GC=F (gold), SI=F (silver), or a stock ticker like NEM.
  • commodity — Alternative to symbol — an atlas slug like gold, silver, natural-gas.
  • range — 1mo, 3mo, 6mo, 1y (default) or 5y.
  • format — json (default) or csv.
curl -H "x-api-key: YOUR_KEY" "https://global-nations-pulse.base44.app/functions/apiDataAccess?resource=price_history&commodity=gold&range=1y&format=csv"
commodity_atlas

Commodity atlas — regions, producers & stocks

For every tracked commodity: producing regions, ranked producer nations with approximate production shares, and the publicly-listed companies associated with it. Leave commodity off for the full atlas.

  • commodity — Optional slug, e.g. gold, silver, crude-oil-wti, natural-gas, iron-ore.
  • format — json (default) or csv.
curl -H "x-api-key: YOUR_KEY" "https://global-nations-pulse.base44.app/functions/apiDataAccess?resource=commodity_atlas&commodity=gold"
olympics · f1 · tennis · cricket · rugby · golf · nfl

Sports hub feeds

Dedicated hub feeds — Olympic Games and medal tables, F1 drivers' standings, Grand Slam finals, ICC events, rugby results, golf majors and Super Bowl results. Hub feeds are generated when the in-app hub is visited and cached for 12 hours. Add &format=csv to any hub feed for a flat CSV export.

curl -H "x-api-key: YOUR_KEY" "https://global-nations-pulse.base44.app/functions/apiDataAccess?resource=f1"
nations

Full nations database

All 197 nations with live-updated statistics. Add &format=csv for a bulk CSV download.

  • format — json (default) or csv.
curl -H "x-api-key: YOUR_KEY" "https://global-nations-pulse.base44.app/functions/apiDataAccess?resource=nations&format=csv" -o nations.csv
{
  "count": 197,
  "nations": [ { "name": "Australia", "region": "Oceania", "population": 27000000, "gdp_usd_billion": 1790, "…": "…" } ]
}
stat_history

Historical data archive

The weekly snapshot archive — how each nation's population, GDP, per-capita and defence figures changed over time. Add &format=csv for a bulk CSV download.

  • nation_id — Optional. Filter to a single nation's history.
  • format — json (default) or csv.
curl -H "x-api-key: YOUR_KEY" "https://global-nations-pulse.base44.app/functions/apiDataAccess?resource=stat_history&format=csv" -o stat_history.csv
{
  "count": 2364,
  "snapshots": [ { "nation_id": "…", "snapshot_date": "2026-09-06", "population": 27000000, "…": "…" } ]
}
commodities · rates

Commodity prices & exchange rates

Live commodity prices (gold, oil, gas, wheat and more) and USD-based exchange rates for every currency.

curl -H "x-api-key: YOUR_KEY" "https://global-nations-pulse.base44.app/functions/apiDataAccess?resource=commodities"

Error codes

400

Bad request — missing or invalid parameters, or an unsupported resource.

401

Unauthorized — missing or invalid API key.

403

Forbidden — the Enterprise subscription is inactive or cancelled.

429

Too many requests — the key's monthly quota (10,000) is exhausted. Resets at the start of next calendar month.

502

On-demand generation failed (head-to-head). Safe to retry.

503

Feed is warming up. Retry in a minute.

Webhooks

Don't poll — register a webhook URL in your profile and we push fresh data to you the moment it updates. Each endpoint gets its own signing secret (shown once).

  • sports.refresh — the full live sports feed, pushed after each 5-minute refresh.
  • weekly_stats.refresh — pushed each Sunday after the weekly nation stats refresh.
  • commodities.refresh — live prices for every tracked commodity, pushed after each 4-hourly price sweep.
  • player_stats.refresh — the current top performers for every sport (scorers, rankings, wickets), pushed after each 4-hourly sweep when fresh stats exist.
  • Threshold rules — when adding a commodities webhook you can attach alert conditions (e.g. daily change below -3 for GC=F); the endpoint then only receives a push when one of your rules matches.
  • test — a manual test delivery from your profile.

Every delivery includes x-nations-event and x-nations-signature — an HMAC-SHA256 hex digest of the raw request body, signed with your endpoint secret.

// Node.js — verify a Nations Atlas webhook
import crypto from 'node:crypto';
const expected = crypto.createHmac('sha256', ENDPOINT_SECRET)
  .update(rawBody) // the exact request body bytes
  .digest('hex');
if (expected === req.headers['x-nations-signature']) {
  // authentic Nations Atlas delivery
}

Data dictionary

nations

  • name — Nation name
  • region — Continent / region grouping
  • capital_city — Capital city name
  • largest_city — Largest city name
  • population — Latest official population estimate
  • population_live — Live population estimate
  • gdp_usd_billion — Nominal GDP (USD billions)
  • gdp_usd_billion_live — Live nominal GDP estimate (USD billions)
  • gdp_per_capita_usd — GDP per capita (USD)
  • gdp_per_capita_usd_live — Live GDP per capita estimate (USD)
  • currency_code — ISO 4217 currency code
  • calling_code — International dialling prefix
  • total_area_km2 — Total area (km²)
  • active_troops — Active military personnel
  • defence_spending_usd_billion — Annual defence spending (USD billions)

stat_history

  • nation_id — Stable nation identifier
  • nation_name — Nation name
  • snapshot_date — Snapshot date (YYYY-MM-DD) — one per nation per weekly refresh
  • population — Population at snapshot time
  • gdp_usd_billion — Nominal GDP (USD billions)
  • gdp_per_capita_usd — GDP per capita (USD)
  • defence_spending_usd_billion — Defence spending (USD billions)
  • active_troops — Active military personnel

Need a key?

The API is included with Nations Enterprise — $100 USD/month or $1,000 USD/year.

Get Nations Enterprise