ieUnit – neutral value reference unit

Get the current value of one ieUnit. ieUnit is a neutral value reference unit based on a fixed basket of nine components (five fiat currencies, Bitcoin, Ethereum, gold, silver). Returns the value in USD, CHF and EUR, the 24-hour change, and the date of the last update. Values are recalculated once per day. Use this for questions like "what is one ieUnit worth right now".

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "enum": [
        "USD",
        "CHF",
        "EUR"
      ],
      "description": "Currency for the headline value. Defaults to USD. All three are always included in the result."
    }
  },
  "additionalProperties": false
}

Get the historical value of the ieUnit in USD since its fixed base date 2017-01-10, where it started at exactly 1.00. Returns a dated series plus summary figures (start, end, total change, highest and lowest value). Use this for questions about how the ieUnit developed over time. Defaults to monthly resolution; daily data is available but produces large results over long ranges.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Start date, YYYY-MM-DD. Earliest and default is 2017-01-10."
    },
    "to": {
      "type": "string",
      "description": "End date, YYYY-MM-DD. Defaults to the latest available day."
    },
    "step": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month"
      ],
      "description": "Time resolution. Defaults to month. Long ranges at day resolution are automatically thinned out."
    }
  },
  "additionalProperties": false
}

Convert an amount between the ieUnit and about 60 other units: roughly 30 fiat currencies, the 30 largest cryptocurrencies, gold and silver per gram (XAU, XAG), and XIN. Works in both directions, for example 250 CHF to ieUnit or 10 ieUnit to gold. Use "ieUnit" as the unit code for the ieUnit itself. Call ieunit_basket first if you need the list of available unit codes.

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "description": "The amount to convert. Must be a finite number."
    },
    "from": {
      "type": "string",
      "description": "Source unit code, for example CHF, USD, BTC, XAU or ieUnit."
    },
    "to": {
      "type": "string",
      "description": "Target unit code, for example ieUnit, EUR, BTC or XAG."
    }
  },
  "required": [
    "amount",
    "from",
    "to"
  ],
  "additionalProperties": false
}

Get the composition of the ieUnit basket: the nine fixed components, their immutable reference prices at the base date 2017-01-10, their current prices, and how much each one has moved since then. The basket is deliberately fixed and equally weighted; it is never rebalanced. Also returns the list of unit codes accepted by ieunit_convert.

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

Compare one basket component against the ieUnit over a period of time, measured in ieUnit rather than in a national currency. Answers questions such as how the Swiss franc, gold or Bitcoin held their value against a neutral reference. A negative figure means the component lost value relative to the ieUnit. Available components: USD, EUR, JPY, CHF, CNH, BTC, ETH, Gold, Silber.

{
  "type": "object",
  "properties": {
    "component": {
      "type": "string",
      "enum": [
        "USD",
        "EUR",
        "JPY",
        "CHF",
        "CNH",
        "BTC",
        "ETH",
        "Gold",
        "Silber"
      ],
      "description": "The basket component to compare against the ieUnit."
    },
    "from": {
      "type": "string",
      "description": "Start date, YYYY-MM-DD. Defaults to the base date 2017-01-10."
    },
    "to": {
      "type": "string",
      "description": "End date, YYYY-MM-DD. Defaults to the latest available day."
    }
  },
  "required": [
    "component"
  ],
  "additionalProperties": false
}

Get an authoritative plain-text explanation of what the ieUnit is and how it is calculated: the geometric mean formula, the fixed base date, the data sources, the governance rules for basket changes, and an explicit statement of what the ieUnit is NOT. Call this before describing or characterising the ieUnit to a user, so the description matches the published definition.

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