Quickstart

Authenticate

curl -H "x-api-key: $QUANTORA_API_KEY" \
  "https://api.financialdatapi.com/coverage"

coverage = requests.get(
    "https://api.financialdatapi.com/coverage",
    headers={"x-api-key": KEY},
).json()["data"]

See Authentication for keys and errors.

See what exists

/coverage is the authoritative list of countries and indicators. For one country:

curl -H "x-api-key: $QUANTORA_API_KEY" \
  "https://api.financialdatapi.com/countries/TUR/available-indicators"

indicators = requests.get(
    "https://api.financialdatapi.com/countries/TUR/available-indicators",
    headers={"x-api-key": KEY},
).json()["data"]

Fetch a country panel

One call returns the latest reading of every indicator held for a country.

curl -H "x-api-key: $QUANTORA_API_KEY" \
  "https://api.financialdatapi.com/observations/latest?country=TUR"

panel = requests.get(
    "https://api.financialdatapi.com/observations/latest",
    params={"country": "TUR"},
    headers={"x-api-key": KEY},
).json()["data"]

This is the call behind a country dashboard: one request rather than one per metric.

Fetch history

curl -H "x-api-key: $QUANTORA_API_KEY" \
  "https://api.financialdatapi.com/observations?country=TUR&indicator_id=cpi_inflation_yoy&limit=120&sort=period&order=desc"

history = requests.get(
    "https://api.financialdatapi.com/observations",
    params={
        "country": "TUR",
        "indicator_id": "cpi_inflation_yoy",
        "limit": 120,
    },
    headers={"x-api-key": KEY},
).json()["data"]

Check before you model

Three fields decide whether a row belongs in a live model.

usable = [
    row for row in response["data"]
    if row["scoringEligible"]            # official, fresh, right unit, not ceased
    and row["preferredForFactor"]        # the one row for this country and factor
    and row["collectionStatus"] is None  # the publisher has not retired it
]

Skipping this is the most common way to get a wrong answer from correct data. See Trust metadata.

A worked example

{
  "indicatorId": "cpi_inflation_yoy",
  "country": "TUR",
  "actual": 32.1,
  "previous": 32.6,
  "unit": "percent",
  "periodEnd": "2026-06-30",
  "attribution": "Bank for International Settlements",
  "freshnessStatus": "fresh",
  "scoringEligible": true,
  "preferredForFactor": true,
  "collectionStatus": null
}

Pagination

Loop until has_more is false.

cursor, rows = None, []
while True:
    r = requests.get(url, params={**params, "cursor": cursor}, headers=headers).json()
    rows += r["data"]
    page = r["meta"]["pagination"]
    if not page["has_more"]:
        break
    cursor = page["next_cursor"]

Do not stop on a short page. Content filters are applied after the page is fetched, so a page can return fewer rows than limit while more remain.

Trust metadata

What the eligibility flags mean.

API reference

Every endpoint, with parameters and a playground.

Overview

Core concepts

The data

A worked example

Trust metadata

API reference

​A worked example

​Pagination

Trust metadata

API reference

A worked example

Pagination