Quickstart

curl "https://api.financialdatapi.com/observations/latest?country=USA&indicator=cpi_inflation_yoy" \
  -H "x-api-key: $FINANCIALDATA_API_KEY"

import os, requests

resp = requests.get(
    "https://api.financialdatapi.com/observations/latest",
    headers={"x-api-key": os.environ["FINANCIALDATA_API_KEY"]},
    params={"country": "USA", "indicator": "cpi_inflation_yoy"},
)
resp.raise_for_status()
print(resp.json()["data"])

import { FinancialDataApiClient } from "@financialdatapi/client";

const client = new FinancialDataApiClient({ apiKey: process.env.FINANCIALDATA_API_KEY! });

const { data } = await client.getLatestObservations({
  country: "USA",
  indicator: "cpi_inflation_yoy",
});
console.log(data[0].actual, data[0].unit, data[0].period);

import os, requests

BASE = "https://api.financialdatapi.com/observations"
HEADERS = {"x-api-key": os.environ["FINANCIALDATA_API_KEY"]}
params = {"country": "USA", "indicator": "cpi_inflation_yoy", "limit": 500}

cursor = None
while True:
    page = {**params, **({"cursor": cursor} if cursor else {})}
    body = requests.get(BASE, headers=HEADERS, params=page).json()
    for obs in body["data"]:
        print(obs["periodEnd"], obs["actual"])
    pagination = body["meta"]["pagination"]
    if not pagination["has_more"]:
        break
    cursor = pagination["next_cursor"]

import { FinancialDataApiClient } from "@financialdatapi/client";

const client = new FinancialDataApiClient({ apiKey: process.env.FINANCIALDATA_API_KEY! });

// The SDK auto-paginates: async iteration follows next_cursor for you.
for await (const obs of client.paginate("/observations", {
  country: "USA",
  indicator: "cpi_inflation_yoy",
})) {
  console.log(obs.periodEnd, obs.actual);
}