/ppp/analysis Endpoint

Endpoint

GET https://api.currency-core.com/v1/ppp/analysis

Answers analytical questions over the yearly IMF purchasing-power-parity (PPP) conversion factors in a single call: how a country’s PPP changed over time, which countries’ PPP rose or fell most, and side-by-side comparisons, each with a % change and an optional min/max/avg. For a single pairwise purchasing-power conversion use /v1/convert?ppp=true; for FX-rate trends use /v1/history/analysis.

Plan requirement

/v1/ppp/analysis is available on the Growth plan and higher (same entitlement as /history). Free / Starter keys receive HTTP 403 forbidden.

Two modes

• Compare: pass countries (a comma-separated list of ISO 3166-1 alpha-3 codes). You get one result per country, in the order requested, each with a year-by-year series.
• Movers: omit countries. Every country is ranked by PPP-factor change and the top limit are returned (sorted by sort).

Query parameters

Metric

The PPP factor is local currency units per international dollar (the same value behind /convert?ppp=true). A rising factor means the country’s price level rose relative to the international dollar over the window; a falling factor means it fell. The endpoint reports the figures objectively:

• startFactor / endFactor: the factor at the start/end of the window.
• startYear / endYear: the actual years used (the nearest available within the window), so you know exactly what it anchored to.
• changePct: % change in the factor over the window.
• projected: true when the end value is an IMF projection (forecast), not an actual observation.
• stats: { min, max, avg } over the window’s years (when stats=true).

Examples

Has India’s PPP changed over the last decade (compare, with the yearly series):

curl "https://api.currency-core.com/v1/ppp/analysis?countries=IND&period=10y" \
  -H "Authorization: Bearer cc_live_your_key"

const res = await fetch(
  "https://api.currency-core.com/v1/ppp/analysis?countries=IND&period=10y",
  { headers: { Authorization: "Bearer cc_live_your_key" } },
);
const { results } = await res.json();
console.log(results[0].country, results[0].changePct);

import requests

res = requests.get(
    "https://api.currency-core.com/v1/ppp/analysis",
    params={"countries": "IND", "period": "10y"},
    headers={"Authorization": "Bearer cc_live_your_key"},
)
print(res.json()["results"][0])

{
  "from": 2015, "to": 2025, "mode": "compare", "stats": true,
  "results": [
    {
      "country": "IND",
      "startYear": 2015, "endYear": 2025,
      "startFactor": 19.687, "endFactor": 20.078,
      "changePct": 1.9861, "projected": true,
      "stats": { "min": 19.687, "max": 20.728, "avg": 20.31 },
      "series": { "2015": 19.687, "2016": 20.08, "2024": 20.397, "2025": 20.078 }
    }
  ]
}

Which countries’ PPP rose most over 20 years (movers):

curl "https://api.currency-core.com/v1/ppp/analysis?period=20y&sort=increased&limit=10" \
  -H "Authorization: Bearer cc_live_your_key"

Compare India, Germany and the US over a fixed window:

curl "https://api.currency-core.com/v1/ppp/analysis?countries=IND,DEU,USA&from=2010&to=2024" \
  -H "Authorization: Bearer cc_live_your_key"

In compare mode each result carries a series (year → factor) for charting.

Errors