usaref.dev
Central-bank policy rates, VAT, minimum wages and public holidays for 10 North American countries. Every value cited to its official source, with the date it was last verified.
DataLiveeip155:8453Exactvia cdp
Reference-dataCentral-bankInterest-ratesVatTax
Settlements · 30d
101↑ 4000%
No per-endpoint history for this service yet, so this is payments indexed to its PROVIDER's wallet over 30 days.
$8.07
Verified settled volume
232 settlements proven x402 by their on-chain EIP-3009 marker.
$0.0010
Listed price
As published in the catalog. Always read the live 402 before paying.
1
Calls · 30d
Upstream's own call count for this endpoint, not ours.
1
Unique payers · 30d
Last called 2026-07-22 17:12Z
—
Upstream on-chain volume
Reported by the source catalog.
Paid to
0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.
Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Provider
The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.
Live 402 challenge
Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "5000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://usaref.dev/v1/:country/:series/history",
"tags": [
"reference-data",
"central-bank",
"interest-rates",
"vat",
"tax",
"minimum-wage",
"public-holidays",
"north-america",
"united-states",
"usa",
"canada",
"mexico"
],
"mimeType": "application/json",
"description": "Government reference data series",
"serviceName": "usaref - North American government reference data"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"pathParams": {
"series": ":series",
"country": ":country"
},
"queryParams": {}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"pathParams": {
"type": "object",
"required": [
"country",
"series"
],
"properties": {
"series": {
"enum": [
"policy-rate",
"vat",
"vat-registration-threshold",
"minimum-wage",
"public-holidays",
"cpi",
"corporate-tax",
"withholding-tax",
"statutory-interest",
"income-tax",
"social-contributions",
"fx-reference",
"sales-tax"
],
"type": "string",
"description": "Reference series id"
},
"country": {
"enum": [
"bs",
"ca",
"cr",
"do",
"gt",
"hn",
"mx",
"pa",
"sv",
"us"
],
"type": "string",
"description": "ISO country code"
}
}
},
"queryParams": {
"type": "object",
"properties": {},
"additionalProperties": false
}
},
"additionalProperties": false
}
}
},
"routeTemplate": "/v1/:country/:series/history"
}
},
"x402Version": 2
}Accepts
The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.
0.001USDC≈ $0.001 USD
on Base · exact scheme
Pay 0.001 USDC on Base to 0x1F04…8FeA6. The signed payment is good for 5 minutes.
- Paid to
- 0x1F04…8FeA6
- USD Coin contract
- 0x8335…02913
- Payment window
- 5 minutes
- As published
- 1000 smallest units
The catalog’s raw entry
[
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "1000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
]Extensions
{
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"pathParams": {
"series": "policy-rate",
"country": "us"
},
"queryParams": {}
},
"output": {
"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"
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"pathParams": {
"type": "object",
"required": [
"country",
"series"
],
"properties": {
"series": {
"enum": [
"policy-rate",
"vat",
"minimum-wage",
"public-holidays",
"cpi",
"corporate-tax",
"income-tax"
],
"type": "string",
"description": "Reference series id"
},
"country": {
"enum": [
"ca",
"us"
],
"type": "string",
"description": "ISO country code"
}
}
},
"queryParams": {
"type": "object",
"properties": {},
"additionalProperties": false
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"country",
"series",
"value",
"effective_from",
"last_confirmed",
"source",
"stale"
],
"properties": {
"unit": {
"type": "string"
},
"notes": {
"type": "string"
},
"stale": {
"type": "boolean",
"description": "True when past the expected update cycle — treat with caution"
},
"value": {
"description": "Number for rates/wages; array of {date,name} for holiday calendars"
},
"series": {
"type": "string"
},
"source": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
}
}
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code"
},
"components": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"rate"
],
"properties": {
"name": {
"type": "string"
},
"rate": {
"type": "number"
}
}
},
"description": "Optional. Breakdown of a composite rate into its named statutory components (present only where applicable, e.g. Ghana VAT)."
},
"effective_from": {
"type": "string",
"format": "date"
},
"effective_rate": {
"type": "number",
"description": "Optional. Combined effective rate where statutory levies stack on top of the standard rate (e.g. Ghana VAT 15% + NHIL 2.5% + GETFund 2.5% = 20%). Present only where it differs from value."
},
"last_confirmed": {
"type": "string",
"format": "date",
"description": "When this value was last verified against the official source"
}
}
}
}
}
}
},
"routeTemplate": "/v1/:country/:series/history"
}
}Provenance
- Seen in the source catalog
- 2026-07-22 17:12Z
- Last indexed by Roundhouse
- 2026-08-21 17:10Z
- Last enriched (probe, favicon, geo)
- 2026-09-11 07:45Z
- x402 version
- 2
- Max timeout
- 300s
- Liveness probe
- HTTP 402
Hand this page to an agent
Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.
GET api.roundhouseai.io/v0/endpoints
No per-endpoint history for this service yet, so this is payments indexed to its PROVIDER's wallet over 30 days. Verified volume counts only settlements with an on-chain EIP-3009 marker.
Show the promptHide the prompt
Using Roundhouse, look up the x402 service usaref.dev and tell me whether it is worth paying: what a call costs, whether the endpoint answered when last probed, and what its payment record actually shows. curl -s 'https://api.roundhouseai.io/v0/endpoints?q=usaref.dev' curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>' Then call it: read the price from the live 402 at https://usaref.dev/v1/:country/:series/history, never from a cached figure, and pay with an x402 client. The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except /v0/unified* and /v0/endpoints. Mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402, or use an organization key from https://roundhouseai.io/dashboard/team. If you do not have Roundhouse tools or skills installed, read https://roundhouseai.io/skill.md first — it is the whole procedure.