HistoricalResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/exchangerate-dev/json-schema/exchangerate-dev-historical-response-schema.json",
  "title": "HistoricalResponse",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/exchangerate-dev-openapi.json#/components/schemas/HistoricalResponse",
  "properties": {
    "result": {
      "type": "string",
      "title": "Result",
      "default": "success"
    },
    "base": {
      "type": "string",
      "title": "Base"
    },
    "date": {
      "type": "string",
      "title": "Date"
    },
    "source": {
      "$ref": "#/$defs/Source"
    },
    "sources": {
      "additionalProperties": {
        "$ref": "#/$defs/Source"
      },
      "type": "object",
      "title": "Sources"
    },
    "market_session": {
      "$ref": "#/$defs/MarketSession"
    },
    "timestamp": {
      "type": "string",
      "title": "Timestamp"
    },
    "data_updated_at": {
      "type": "string",
      "title": "Data Updated At"
    },
    "is_forward_filled": {
      "type": "boolean",
      "title": "Is Forward Filled"
    },
    "rates": {
      "additionalProperties": {
        "type": "number"
      },
      "type": "object",
      "title": "Rates"
    },
    "derived_symbols": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Derived Symbols"
    },
    "notice": {
      "type": "string",
      "title": "Notice"
    }
  },
  "type": "object",
  "required": [
    "base",
    "date",
    "source",
    "sources",
    "market_session",
    "timestamp",
    "data_updated_at",
    "is_forward_filled",
    "rates",
    "derived_symbols",
    "notice"
  ],
  "$defs": {
    "MarketSession": {
      "type": "string",
      "enum": [
        "open",
        "weekend",
        "interbank_closed"
      ],
      "title": "MarketSession",
      "description": "Computed from a clock, no feed (D9). `interbank_closed` = a known non-weekend closure\n(e.g. an ECB/TARGET2 holiday detected via an empty Tier-C response — INGESTION §4)."
    },
    "Source": {
      "type": "string",
      "enum": [
        "live",
        "ecb_daily",
        "market_daily"
      ],
      "title": "Source",
      "description": "Public `source` enum — wire contract (D2). NO `cached` value (cache lives in X-Cache).\n\n`ecb_daily` is the only reference source (October 2026).\n`market_daily` labels the stored daily close of the live market feed, for the currencies with\nno reference fix, in date history and 1d time series; it is never a live rate."
    }
  }
}