Access API Documentation

All Requests

All requests must include the Authorization (Bearer Token) header with the value of your API key, which you can find in your account settings if you are on an active API subscription plan.

Rate Limiting

All API requests are subject to rate limiting. If you exceed the allowed number of requests, you will receive a 429 Too Many Requests response.

429

{
  "error": {
    "code": 429,
    "message": "Too Many Requests"
  }
}

Get Stats

Get stats meta data.

Request

GET /v1/stats

• page optional - shows up to 100 records per page, default to page 1
• sort optional - default to id
• cc optional - ISO 3166 country code, default to all countries

Response

200

{
  "stats":[
    {
      "id":1,
      "name":"US - Real Gross Domestic Product [GDP] (SAAR)",
      "frequency":"Q",
      "currency":"USD",
      "units":"Billions"
    },
    {
      "id":2,
      "name":"US - S&P 500",
      "frequency":"D",
      "currency":null,
      "units":"Index"
    }
  ],
  "pagination":{
    "prev":null,
    "next":"/v1/stats?page=2"
  }
}

Get Time Series

Get time series.

Note: the dates returned here corresponds with the first day of month/quarter/year in relation to the specified stat.frequency, see below. (Weekly data is an exception to this rule)

D = daily
W = weekly
M = monthly (e.g. "2025-06-01" for June 2025)
Q = quarterly (e.g. "2025-07-01" for 2025 Q3)
H = half-yearly (e.g. "2025-07-01" for 2025 H2)
Y = yearly (e.g. "2025-01-01" for 2025)

Request

GET /v1/stats/series/{stat.id}

Response

200

{
  "stat_id": 2,
  "series": [
      {"date": "2025-06-03", "val": 5970.81 },
      {"date": "2025-06-04", "val": 5939.30 },
      {"date": "2025-06-05", "val": 6000.36 }
  ]
}