Roundhouse AI

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
https://usaref.dev/v1/:country/:series
Reference-dataCentral-bankInterest-ratesVatTax
Calls · 30d
1→ 0%
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 20 snapshots so far.
$8.21
Verified settled volume
257 settlements proven x402 by their on-chain EIP-3009 marker.
$0.0050
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-09-03 15:32Z
—
Upstream on-chain volume
Reported by the source catalog.
Paid to
0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6

The 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",
    "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"
    }
  },
  "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.005USDC≈ $0.005 USD
on Base · exact scheme

Pay 0.005 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
5000 smallest units
The catalog’s raw entry
[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
    "amount": "5000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "type": "http",
        "method": "GET",
        "pathParams": {
          "series": "policy-rate",
          "country": "ca"
        },
        "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%.' eff…",
          "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); ra…"
          },
          "country": "CA",
          "confidence": "primary",
          "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-09-03"
        }
      }
    },
    "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"
  }
}

Provenance

Seen in the source catalog
2026-09-03 15:32Z
Last indexed by Roundhouse
2026-09-25 02:40Z
Last enriched (probe, favicon, geo)
2026-09-11 07:45Z
x402 version
2
Max timeout
300s
Liveness probe
HTTP 402
Report

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

This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 20 snapshots so far. Verified volume counts only settlements with an on-chain EIP-3009 marker.

Open skill.md
Show 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, 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.