{"uid":"cap_Jj53MlDTolU2zRErO2JOs","slug":"usaref-north-american-government-reference-data-history-series-5f834f9b","name":"usaref North American Government Reference Data – History Series","description":"Authoritative North American government reference values as clean JSON: central-bank policy rates, VAT rates, national minimum wages and public holidays for Canada (ca), United States (us). Every value carries a citation to its official primary source (government gazette or central-bank statement), an effective date, a last-confirmed date and a staleness flag.","url":"https://usaref.dev/v1/%7Bcountry%7D/%7Bseries%7D/history","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"unit":"percent","notes":"The 15 July 2026 release states verbatim: 'The Bank of Canada today held its target for the overnight rate at 2.25%, with the Bank Rate at 2.5% and the deposit rate at 2.20%.' effective_from is 2025-10-29, the date of the last CHANGE (a 25 bp cut from 2.50% to 2.25%), not the date of the most recent reaffirmation — the Bank has since held at 2.25% at all SIX subsequent fixed announcement dates: 10 December 2025, 28 January 2026, 18 March 2026, 29 April 2026, 10 June 2026 and 15 July 2026. The full 2026 FAD schedule published by the Bank in August 2025 is 28 January, 18 March, 29 April, 10 June, 15 July, 2 September, 28 October and 9 December, with the Monetary Policy Report released alongside the January, April, July and October decisions. Canada's operating band is 25 bp wide: the Bank Rate (upper limit, standing liquidity facility) is the target +25 bp = 2.50%, and the deposit rate (lower limit, remuneration on settlement balances) is 2.20% — 5 bp below target, a spread the Bank narrowed from the earlier target-minus-25bp convention. The target for the overnight rate is the correct headline policy rate; do not substitute the Bank Rate. Next scheduled fixed announcement date: 2 September 2026. bankofcanada.ca serves clean HTML and is reliably fetchable.","stale":false,"value":2.25,"series":"policy-rate","source":{"url":"https://www.bankofcanada.ca/2026/07/fad-press-release-2026-07-15/","name":"Bank of Canada, Fixed Announcement Date press release 15 July 2026, 'Bank of Canada maintains the policy rate at 2¼%' (decision under the Bank of Canada Act, RSC 1985, c. B-2); rate level set by the FAD press release of 29 October 2025"},"country":"CA","disclaimer":"Independent service, not affiliated with any government. Verify against the cited official source before legal or financial use.","effective_from":"2025-10-29","last_confirmed":"2026-07-20"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZOuoXtY-Atmtn9FDNsDQ2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the full historical time-series for a specific government reference data series (e.g. policy rates, VAT rates, minimum wages, public holidays) for a given North American country (CA or US), with citations to official primary sources.","exampleAgentPrompt":"Can you pull the full history of Bank of Canada overnight policy rate changes, including each effective date and the official citation, so I can see how rates have evolved?","exampleUseCases":[{"title":"Track central bank rate history for modeling","prompt":"Get me the complete historical series of the Bank of Canada's overnight policy rate — every value, when it changed, and a link to the official announcement — so I can plug it into my interest rate model."},{"title":"Audit US minimum wage compliance timeline","prompt":"I need the full historical record of the US federal minimum wage, with effective dates and official government sources, to verify our payroll compliance over the last decade."},{"title":"Chart Canadian VAT rate changes over time","prompt":"Pull the full history of Canada's VAT or GST rate changes with the official government citation for each entry so I can build a chart showing how it's moved over the years."}],"resultDescription":"A JSON array of historical entries for the requested series, each containing the numeric value and unit, the effective_from date (when the value came into force), the last_confirmed date (most recent verification), a staleness boolean flag, an official primary source object with URL and name, country and series identifiers, and a legal disclaimer. The Bank of Canada policy-rate example shows value: 2.25, unit: 'percent', effective_from: '2025-10-29', last_confirmed: '2026-07-20', stale: false.","failureModes":["Unknown country code returns an error — only 'ca' and 'us' are supported","Unknown or misspelled series name returns an error — must match supported slugs like policy-rate, minimum-wage, vat-rate, public-holidays","Payment failure or missing x402 payment header results in 402 Payment Required response","Network timeout on the upstream service","Stale flag may be true if the official source has not been recently verified, indicating data may be outdated"],"whenToPreferThis":"Choose this endpoint when you need the full chronological history of a North American government reference value (not just the current value), with official government citations and staleness signals. It is ideal for compliance audits, economic modeling, regulatory research, or any use case requiring an auditable chain of authoritative government data points rather than a single current figure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:41:22.090Z","isFirstParty":false}