{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"exchange-rate.schema.json","title":"Official central bank exchange rate, one publisher, base currency, quote currency and date","description":"Daily official reference, fixing or indicative exchange rates from central bank publications (Bank of Canada, Reserve Bank of Australia, Federal Reserve Board H.10, Sveriges Riksbank, Czech National Bank, Central Bank of Iceland), stored exactly as each bank publishes them: its own base and quote currency and unit amount, no cross rates, no rounding. rate is the number of units of the quote currency for amount units of the base currency. These rates are published for information and statistics; they are not market quotes or transaction rates. Rolling window of about two years.","type":"object","required":["id","date","publisher","publisher_name","base","quote","rate","amount","rate_type","series","shard","source_id","source_url","verification","paid_placement","retrieved_at"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Z]+-[A-Z]{3}-[A-Z]{3}-\\d{4}-\\d{2}-\\d{2}$","description":"Publisher, base currency, quote currency and date, for example BOC-USD-CAD-2026-11-06"},"date":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date the rate applies to (ISO 8601), a business day of the publishing central bank"},"publisher":{"type":"string","enum":["BOC","RBA","FED","RIKSBANK","CNB","CBI","DN","ECB"],"description":"Publishing central bank: BOC Bank of Canada, RBA Reserve Bank of Australia, FED Federal Reserve Board, RIKSBANK Sveriges Riksbank, CNB Czech National Bank, CBI Central Bank of Iceland (DN and ECB are registered but not collected)"},"publisher_name":{"type":"string","description":"Full name of the publishing central bank, also the source attribution"},"base":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 code of the base currency (the currency being priced)"},"quote":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 code of the quote currency the rate is expressed in"},"rate":{"type":"number","exclusiveMinimum":0,"description":"Units of the quote currency per amount units of the base currency, as published"},"amount":{"type":"integer","enum":[1,100,1000],"description":"Number of base currency units the rate is for (the Czech National Bank quotes some currencies per 100 or 1000 units)"},"rate_type":{"type":"string","enum":["daily-average","indicative-rate","noon-buying-rate","mid-rate","fixing","reference-rate"],"description":"Kind of official rate: daily-average (Bank of Canada), indicative-rate (RBA, around 16:00 Sydney time), noon-buying-rate (Federal Reserve H.10, New York), mid-rate (Riksbank, Central Bank of Iceland), fixing (Czech National Bank), reference-rate"},"series":{"type":"string","description":"Series code or label of the publisher, for example FXUSDCAD, FXRJY, RXI_N.B.JA, SEKUSDPMI"},"shard":{"type":"string","pattern":"^[A-Z]+-[A-Z]{3}-[A-Z]{3}$","description":"Publisher, base and quote, the history shard of the pair, for example BOC-USD-CAD"},"source_id":{"type":"string","enum":["ca-boc-exchange-rates","au-rba-exchange-rates","us-fed-h10-exchange-rates","se-riksbank-exchange-rates","cz-cnb-exchange-rate-fixing","is-cbi-official-exchange-rates","dk-nationalbanken-exchange-rates","ecb-euro-reference-rates"]},"source_notice":{"type":"string","description":"Attribution and, for ECB-based rates, the statement that the rates are free of charge on the publisher's website"},"source_url":{"type":"string","format":"uri","description":"Official file or API URL the record was collected from"},"verification":{"type":"string","enum":["official-publication"],"description":"Taken from the official publication of the central bank"},"paid_placement":{"type":"boolean","const":false,"description":"Always false; no record is paid for"},"retrieved_at":{"type":"string","format":"date-time"}}}