/ppp Endpoint

Endpoint

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

Returns the purchasing-power-parity (PPP) conversion factor for one country in one year. The factor is local currency units per international dollar, sourced from the IMF World Economic Outlook. It is the same factor used by /v1/convert?ppp=true.

This is a single-point lookup, not a time series. For trends, country comparisons, and movers, use /v1/ppp/analysis. For FX rates, use /v1/rates.

Plan requirement

/v1/ppp requires a valid API key but has no Growth tier gate. It is metered like any other keyed request: one call consumes one request against your monthly quota and the per-minute rate limit. On the Free plan, use a test key, because live keys require a paid plan. See Pricing for quotas.

Query parameters

Only one country per request is accepted. To compare countries or fetch a range of years, call /v1/ppp/analysis instead.

Country and currency handling

/v1/ppp has no currency parameter. The response identifies the country, and the factor is denominated in that country’s local currency. To see which currency a country uses, call /v1/countries and read its currencies array.

For a PPP-adjusted amount in a specific currency, use /v1/convert?ppp=true, which takes currency:country pairs such as INR:IND. The raw factor endpoint is useful when you want the price level itself rather than a converted amount.

Response

{
  "year": 2024,
  "countryCode": "IND",
  "pppFactor": 20.397,
  "projected": false
}

Response fields

Reading the factor

A PPP factor is a price level, not an exchange rate. A factor of 20.4 for India means that goods costing one international dollar in the United States would cost about 20.4 units of Indian currency in India at PPP. The market FX rate can be very different, so do not use this number as a currency quote.

• A rising factor over time means the country’s price level rose relative to the international dollar.
• A falling factor means its price level fell relative to the international dollar.
• projected: true marks forecast years. For historical analysis, prefer actual values or treat projections separately.

The endpoint returns the figure objectively; whether a change is “good” or “bad” depends on your use case.

Example requests

curl "https://api.currency-core.com/v1/ppp?country=IND&year=2024" \
  -H "Authorization: Bearer cc_live_your_key"

const res = await fetch(
  "https://api.currency-core.com/v1/ppp?country=IND&year=2024",
  { headers: { Authorization: "Bearer cc_live_your_key" } },
);
const { countryCode, pppFactor, projected } = await res.json();
console.log(countryCode, pppFactor, projected);

import requests

res = requests.get(
    "https://api.currency-core.com/v1/ppp",
    params={"country": "IND", "year": 2024},
    headers={"Authorization": "Bearer cc_live_your_key"},
)
print(res.json()["pppFactor"])

Use the default year by omitting year:

curl "https://api.currency-core.com/v1/ppp?country=DEU" \
  -H "Authorization: Bearer cc_live_your_key"

Common uses

• Price-level research: compare a country’s PPP factor across years without converting an amount.
• Validation: confirm the factor behind a /convert?ppp=true result for the same country and year.
• Dashboards: cache one factor per country and year, then label it clearly as a price level, not an FX rate.

Do not use this endpoint as a substitute for a market exchange rate. Use /v1/rates or /v1/convert for nominal FX.

Errors

A country that is not in the dataset and a country with no data for the requested year both return 404 unknown_ppp.

Limits and related

• One country and one year per request; there is no batch mode on this path.
• The default year comes from the deployed configuration (PPP_YEAR), currently 2024.
• Factors are read from the same PPP dataset used by conversions and analysis, so a factor returned here matches the one used by /v1/convert?ppp=true for that year.

Related pages:

• /v1/ppp/analysis for trends and comparisons
• /v1/convert for PPP-adjusted amounts
• /v1/countries for country codes and official currencies
• PPP calculator for a no-code check
• Pricing and rate limits for quotas