Nexus - Short Report About the BIS Innovation Hub

Currencies

PreviousCountries NextAddress Types and Inputs

Last updated 7 months ago

Retrieve All Currencies in Nexus

get

Returns all the currencies available in Nexus, along with the countries where each currency is used, and corresponding symbols, names, and decimal places.

Responses

200

A list of currencies with their details.

application/json

get

GET /currencies HTTP/1.1
Host: localhost:3000
Accept: */*

200

A list of currencies with their details.

{
  "currencies": [
    {
      "currencyId": 360,
      "currencyCode": "IDR",
      "name": "Rupiah",
      "symbol": "Rp",
      "decimalPlaces": 0,
      "countries": [
        "ID"
      ]
    },
    {
      "currencyId": 458,
      "currencyCode": "MYR",
      "name": "Ringgit",
      "symbol": "RM",
      "decimalPlaces": 2,
      "countries": [
        "MY"
      ]
    },
    {
      "currencyId": 608,
      "currencyCode": "PHP",
      "name": "Peso",
      "symbol": "₱",
      "decimalPlaces": 2,
      "countries": [
        "PH"
      ]
    },
    {
      "currencyId": 702,
      "currencyCode": "SGD",
      "name": "Dollar",
      "symbol": "$",
      "decimalPlaces": 2,
      "countries": [
        "SG"
      ]
    },
    {
      "currencyId": 764,
      "currencyCode": "THB",
      "name": "Baht",
      "symbol": "฿",
      "decimalPlaces": 2,
      "countries": [
        "TH"
      ]
    },
    {
      "currencyId": 978,
      "currencyCode": "EUR",
      "name": "Euro",
      "symbol": "€",
      "decimalPlaces": 2,
      "countries": [
        "AT",
        "BE",
        "CY",
        "EE",
        "FI",
        "FR",
        "DE",
        "GR",
        "IE",
        "IT",
        "LV",
        "LT",
        "LU",
        "MT",
        "NL",
        "PT",
        "SK",
        "SI",
        "ES"
      ]
    }
  ]
}

Retrieve a Single Currency

get

Get a single currency by its 3-letter currency code, along with the countries where the currency is used, and corresponding symbols, name, and decimal places.

Path parameters

currencyCodestringRequired

The 3-letter currency code

Example: IDR

Responses

200

Currency information.

application/json

get

GET /currencies/{currencyCode} HTTP/1.1
Host: localhost:3000
Accept: */*

200

Currency information.

{
  "currencyId": 360,
  "currencyCode": "IDR",
  "name": "Rupiah",
  "symbol": "Rp",
  "decimalPlaces": 0,
  "countries": [
    "ID"
  ]
}