Countries using a currency API

Given an ISO 4217 currency code, list every country that uses it (sorted by population) with the currency name/symbol and aggregate population. Useful for currency-union mapping. Answers 'which countries use the EUR/XOF/USD', 'how many countries share a currency', 'total population of a currency zone'.

Price$0.01per request

MethodPOST

Route/v1/data/places-countries-by-currency

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

dataplacescountrycurrencyiso-4217monetary-unionrest-countries

API URLhttps://x402.hexl.dev/v1/data/places-countries-by-currency

Integration docs

Example request

{
  "currency": "XOF"
}

Example response

{
  "currency": "XOF",
  "currencyName": "West African CFA franc",
  "currencySymbol": "Fr",
  "countryCount": 8,
  "totalPopulation": 146192275,
  "countries": [
    {
      "name": "Ivory Coast",
      "officialName": "Republic of Côte d'Ivoire",
      "code": "CI",
      "code3": "CIV",
      "capital": "Yamoussoukro",
      "region": "Africa",
      "subregion": null,
      "population": 31719275,
      "flag": null
    },
    {
      "name": "Niger",
      "officialName": "Republic of Niger",
      "code": "NE",
      "code3": "NER",
      "capital": "Niamey",
      "region": "Africa",
      "subregion": null,
      "population": 26312034,
      "flag": null
    },
    {
      "name": "Burkina Faso",
      "officialName": "Burkina Faso",
      "code": "BF",
      "code3": "BFA",
      "capital": "Ouagadougou",
      "region": "Africa",
      "subregion": null,
      "population": 24070553,
      "flag": null
    },
    {
      "name": "Mali",
      "officialName": "Republic of Mali",
      "code": "ML",
      "code3": "MLI",
      "capital": "Bamako",
      "region": "Africa",
      "subregion": null,
      "population": 22395489,
      "flag": null
    },
    {
      "name": "Senegal",
      "officialName": "Republic of Senegal",
      "code": "SN",
      "code3": "SEN",
      "capital": "Dakar",
      "region": "Africa",
      "subregion": null,
      "population": 18593258,
      "flag": null
    },
    {
      "name": "Benin",
      "officialName": "Republic of Benin",
      "code": "BJ",
      "code3": "BEN",
      "capital": "Porto-Novo",
      "region": "Africa",
      "subregion": null,
      "population": 13224860,
      "flag": null
    },
    {
      "name": "Togo",
      "officialName": "Togolese Republic",
      "code": "TG",
      "code3": "TGO",
      "capital": "Lomé",
      "region": "Africa",
      "subregion": null,
      "population": 8095498,
      "flag": null
    },
    {
      "name": "Guinea-Bissau",
      "officialName": "Republic of Guinea-Bissau",
      "code": "GW",
      "code3": "GNB",
      "capital": "Bissau",
      "region": "Africa",
      "subregion": null,
      "population": 1781308,
      "flag": null
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "currency"
  ],
  "properties": {
    "currency": {
      "type": "string"
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}