💸 parity-factor

Purchasing Power Parity (PPP) Conversion Factor

A lightweight Node.js package and CLI tool to fetch real-time Purchasing Power Parity (PPP) conversion factors (GDP-based, LCU per international $).
Data is sourced from the World Bank and cached via CDN + fallback JSON for reliability.

☕ This package runs on caffeine. If it helped you, consider buying me a coffee.

✨ Features

• Fetch PPP conversion factor by country ISO3 code.
• Data refreshed daily via CDN
• Works both as Node.js library and CLI tool
• Simple, lightweight, no API key required 🚀
• Unlimited data fetches

📦 Installation

npm install parity-factor

Or with yarn:

yarn add parity-factor

🚀 Usage

In Node.js

import { getParity } from "ppp-conversion";

const value = await getParity("AFG");
console.log("PPP for Afghanistan:", value);

Output:

{
  "last_updated": "2025-08-18",
  "data": [
    {
      "sourceid": "2",
      "indicator": {
        "id": "PA.NUS.PPP",
        "value": "PPP conversion factor, GDP (LCU per international $)"
      },
      "country": {
        "id": "AF",
        "value": "Afghanistan"
      },
      "countryiso3code": "AFG",
      "date": "2023",
      "value": 14.8009414284672,
      "unit": "",
      "obs_status": "",
      "decimal": 2
    }
  ]
}

In CLI

npx parityfactor AFG

Output:

{
  "sourceid": "2",
  "indicator": {
    "id": "PA.NUS.PPP",
    "value": "PPP conversion factor, GDP (LCU per international $)"
  },
  "country": {
    "id": "AF",
    "value": "Afghanistan"
  },
  "countryiso3code": "AFG",
  "date": "2023",
  "value": 14.8009414284672,
  "unit": "",
  "obs_status": "",
  "decimal": 2
}

🌍 Supported Countries

This package provides support for the following countries. Each entry contains the ISO Alpha-3 country code and the country name.

📌 Countries List

| Code | Country | |------|---------| | AFG | Afghanistan | | ALB | Albania | | DZA | Algeria | | AND | Andorra | | AGO | Angola | | ATG | Antigua and Barbuda | | ARG | Argentina | | ARM | Armenia | | ABW | Aruba | | AUS | Australia | | AUT | Austria | | AZE | Azerbaijan | | BHS | Bahamas, The | | BHR | Bahrain | | BGD | Bangladesh | | BRB | Barbados | | BLR | Belarus | | BEL | Belgium | | BLZ | Belize | | BEN | Benin | | BMU | Bermuda | | BTN | Bhutan | | BOL | Bolivia | | BIH | Bosnia and Herzegovina | | BWA | Botswana | | BRA | Brazil | | BRN | Brunei Darussalam | | BGR | Bulgaria | | BFA | Burkina Faso | | BDI | Burundi | | CPV | Cabo Verde | | KHM | Cambodia | | CMR | Cameroon | | CAN | Canada | | CAF | Central African Republic | | TCD | Chad | | CHL | Chile | | CHN | China | | COL | Colombia | | COM | Comoros | | COD | Congo, Dem. Rep. | | COG | Congo, Rep. | | CRI | Costa Rica | | CIV | Cote d'Ivoire | | HRV | Croatia | | CUW | Curacao | | CYP | Cyprus | | CZE | Czechia | | DNK | Denmark | | DJI | Djibouti | | DMA | Dominica | | DOM | Dominican Republic | | ECU | Ecuador | | EGY | Egypt, Arab Rep. | | SLV | El Salvador | | GNQ | Equatorial Guinea | | ERI | Eritrea | | EST | Estonia | | SWZ | Eswatini | | ETH | Ethiopia | | FJI | Fiji | | FIN | Finland | | FRA | France | | GAB | Gabon | | GMB | Gambia, The | | GEO | Georgia | | DEU | Germany | | GHA | Ghana | | GRC | Greece | | GRL | Greenland | | GRD | Grenada | | GTM | Guatemala | | GIN | Guinea | | GNB | Guinea-Bissau | | GUY | Guyana | | HTI | Haiti | | HND | Honduras | | HKG | Hong Kong SAR, China | | HUN | Hungary | | ISL | Iceland | | IND | India | | IDN | Indonesia | | IRN | Iran, Islamic Rep. | | IRQ | Iraq | | IRL | Ireland | | ISR | Israel | | ITA | Italy | | JAM | Jamaica | | JPN | Japan | | JOR | Jordan | | KAZ | Kazakhstan | | KEN | Kenya | | KIR | Kiribati | | KOR | Korea, Rep. | | XKX | Kosovo | | KWT | Kuwait | | KGZ | Kyrgyz Republic | | LAO | Lao PDR | | LVA | Latvia | | LBN | Lebanon | | LSO | Lesotho | | LBR | Liberia | | LBY | Libya | | LTU | Lithuania | | LUX | Luxembourg | | MAC | Macao SAR, China | | MDG | Madagascar | | MWI | Malawi | | MYS | Malaysia | | MDV | Maldives | | MLI | Mali | | MLT | Malta | | MHL | Marshall Islands | | MRT | Mauritania | | MUS | Mauritius | | MEX | Mexico | | FSM | Micronesia, Fed. Sts. | | MDA | Moldova | | MNG | Mongolia | | MNE | Montenegro | | MAR | Morocco | | MOZ | Mozambique | | MMR | Myanmar | | NAM | Namibia | | NRU | Nauru | | NPL | Nepal | | NLD | Netherlands | | NZL | New Zealand | | NIC | Nicaragua | | NER | Niger | | NGA | Nigeria | | MKD | North Macedonia | | NOR | Norway | | OMN | Oman | | PAK | Pakistan | | PLW | Palau | | PAN | Panama | | PNG | Papua New Guinea | | PRY | Paraguay | | PER | Peru | | PHL | Philippines | | POL | Poland | | PRT | Portugal | | PRI | Puerto Rico (US) | | QAT | Qatar | | ROU | Romania | | RUS | Russian Federation | | RWA | Rwanda | | WSM | Samoa | | STP | Sao Tome and Principe | | SAU | Saudi Arabia | | SEN | Senegal | | SRB | Serbia | | SYC | Seychelles | | SLE | Sierra Leone | | SGP | Singapore | | SVK | Slovak Republic | | SVN | Slovenia | | SLB | Solomon Islands | | SOM | Somalia | | ZAF | South Africa | | ESP | Spain | | LKA | Sri Lanka | | KNA | St. Kitts and Nevis | | LCA | St. Lucia | | VCT | St. Vincent and the Grenadines | | SDN | Sudan | | SUR | Suriname | | SWE | Sweden | | CHE | Switzerland | | SYR | Syrian Arab Republic | | TJK | Tajikistan | | TZA | Tanzania | | THA | Thailand | | TLS | Timor-Leste | | TGO | Togo | | TON | Tonga | | TTO | Trinidad and Tobago | | TUN | Tunisia | | TUR | Turkiye | | TKM | Turkmenistan | | TCA | Turks and Caicos Islands | | TUV | Tuvalu | | UGA | Uganda | | UKR | Ukraine | | ARE | United Arab Emirates | | GBR | United Kingdom | | USA | United States | | URY | Uruguay | | UZB | Uzbekistan | | VUT | Vanuatu | | VNM | Viet Nam | | PSE | West Bank and Gaza | | YEM | Yemen, Rep. | | ZMB | Zambia | | ZWE | Zimbabwe |

✅ Total Supported Countries: 191

🔗 Data Source

All parity conversion factors are updated monthly and served from CDN:
👉 https://cdn.jsdelivr.net/npm/parity-factor@latest/v1/parity.json

📜 License

ISC – © Jayadev Panthaplavil