●

usaref — North American government reference data

Data PAYMENT-READY

payment-ready until 2026-09-21

North and Central American government reference data as clean, cited JSON: central-bank policy rates, VAT and sales tax, corporate and personal income tax, minimum wages, CPI inflation, official FX fixes and public holidays across 10 countries. Every value returns with the official source URL it was verified against, the date it took effect and the date we last checked it, so an answer can be audited rather than trusted. Each series also declares how it was obtained — GET /catalog?confidence=primary returns only values with no recorded verification limitation. Out-of-scope questions are refused free, with an explanation, rather than guessed. Includes sub-national public-holiday calendars for 10 US states and all 13 Canadian provinces and territories, each cited to that jurisdiction's own statute rather than inferred from a federal list. Paid per call in USDC on Base via x402 — no key, no signup. Public holidays are free. The United States is the free evaluation country.

Pay from $0.005 per request in USDC on Base, settled onchain via the x402 protocol, no signup, no API key needed.

measured since 2026-07-15 (start of our harvest window) · $0 all-time · last settled 2026-09-11

BASE URL https://usaref.dev │ WEBSITE https://usaref.dev │ ENDPOINTS 2 │ NETWORK Base │ ASSET USDC │ MEMBER SINCE 2026-09-14 │ MONITORED SINCE 2026-09-14

VERDICT

ranking generation 3

solid 85/100 #100 of 302 in Data by measured score

What the score read on this service: status online, 100% uptime 24h (no 30d window yet), 728ms response p95, x402 compliance 14 of 14, $0.005 price against the category, on-chain traction measured. Each of those is measured, and each is published in full below.

The score comes from our own monitoring, never from reviews, operator claims, or a language model: reliability, x402 compliance, price against the category, a deterministic risk flag, and a small on-chain traction term, weighted by ranking generation 3. It is not placement anyone can buy: the paid verify tier is reported beside it and is not one of its inputs. Every component below stays published and read-only.

It is a score inside Data, and only there: price and speed are scored against the whole category field, every listing in it that carries no danger flag, the scored service included, which here means 302 listings, this one among them. That set is wider than the 302 the position above is counted against, because a listing we have measured too little of to rank still sits in the field the price and the speed are normalized over. The same service in a different field would read differently. The same engine answers GET /api/v1/best, and asked for a different pool (the whole directory, or another filter) it returns a different number for this service under this same ranking generation. Neither is more correct: they answer different questions, and the methodology states which is which.

Bands on the 0 to 100 measured score: strong at 93 and above, solid from 75, mixed from 55, weak below 55. Price and speed are scored against the whole category field, every listing in it that carries no danger flag, the scored service included, so the score places a service in its own field.

ALTERNATIVES IN DATA

Other Data services in this directory, ordered by the same measured score. The figures are ours: 30-day uptime from our own probes, 30-day settlement volume read on-chain (a conservative undercount, and null where we cannot measure it, never a zero).

Ranked alternative x402 services in the same category, with band, measured score, 30-day uptime and 30-day on-chain settlement volume
SERVICE	BAND	SCORE	UPTIME 30D	VOL 30D
StableEnrich	strong	96	100%	$1.9k
glim.sh	strong	95	100%	$51.85
SniperX•x402	strong	95	100%	$508.77
cn402	strong	93	100%	$38.86
API Acre	solid	92	99.8%	$34.06

5 of 301 other ranked services in Data · see the whole category

ASSESSMENT

updated 2h ago

The parts the verdict above is computed from, each with its proof. Click any chip. Measured values stay read-only; unknown is honest, and an unknown is never counted as a zero.

reliability 100%

uptime 24h: -
uptime 7d: -
uptime 30d: -
uptime 90d: -
response p95: 728ms
avg response: 728ms
total checks: 1

Measured on the unpaid 402 handshake, not the paid call. A service can 402 correctly and still fail after payment.

compliance A (14/14)

14 of 14 x402 conformance checks pass. Full checklist below.

jump to compliance checklist

price $0.005 (p40 in Data)

price (min): $0.005
category percentile (min): p40 in Data
endpoints / prices: 2 / 1
model: flat
stability: 100%

risk clean

No deterministic risk flag. Risk fires only on an exact blocklist match, or a reserved-brand name with a mismatched verified payTo. Never from low uptime, a high price, or a model guess.

domain age: -
registrar: -
hosting: custom
domain created: ---

Identity facts, not a risk score.

traction $0.00 30d · 0 buyers

volume 30d: $0.00
buyers 30d: 0
settlements 30d: 0
measured since: 2026-07-15 (start of our harvest window)
last settlement: 2026-09-11
top buyer share: -
trend 7d vs 30d: -
networks: eip155:8453
volume all-time: $0
settlements all-time: 0
median settlement 30d: -
max settlement 30d: -
settled via: -

Conservative undercount: only USDC settlements via facilitators we measure are counted. A measured floor, not an estimate.

Top buyer share is a concentration signal, not part of the ranking score.

WHAT IT DOES

ai-derived

No AI synthesis has been produced for this service yet.

ENDPOINTS

Service endpoints with HTTP method, path, description, pricing, and network
METHOD	PATH	DESCRIPTION	PRICE	NETWORK	ASSET	402 CHANNEL
GET	/v1/ca/policy-rate		$0.005	Base	USDC	header
GET	/v1/ca/vat		$0.005	Base	USDC	header

2 endpoints

REQUEST / RESPONSE EXAMPLE

An unpaid request to GET /v1/ca/policy-rate returns HTTP 402 with the payment terms. Settle onchain via your facilitator, then retry with the X-Payment header.

// request

curl -i 'https://usaref.dev/v1/ca/policy-rate'

// 402 response (captured by monitor) · 2 payloads · click to expand

[
  {
    "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/ca/vat",
      "tags": [
        "reference-data",
        "central-bank",
        "interest-rates",
        "vat",
        "tax",
        "minimum-wage",
        "public-holidays",
        "north-america",
        "united-states",
        "usa",
        "canada",
        "mexico"
      ],
      "mimeType": "application/json",
      "description": "usaref - North American government reference data. us eval free. $0.005 Base USDC. Cited.",
      "serviceName": "usaref - North American government reference data. us eval free. $0.005 Base USDC. Cited."
    },
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "pathParams": {
              "series": "vat",
              "country": "ca"
            },
            "queryParams": {}
          },
          "output": {
            "type": "json",
            "example": {
              "unit": "percent",
              "notes": "5% is the FEDERAL GST — the only nationally uniform consumption tax rate — and is served deliberately unblended. Canada layers three distinct regimes on top of it, so the rate a buyer actually pays depends on the place of supply: (1) HST provinces, where the federal 5% and a provincial component are collected as a single harmonised tax administered by the CRA under s. 165(2) — Ontario 13%, New Brunswick 15%, Newfoundland and Labrador 15%, Prince Edward Island 15%, and Nova Scotia 14% (Nova Scotia's provincial component was cut from 10% to 9% effective 1 April 2025, taking its HST from 15% to 14%); (2) GST + separate provincial retail sales tax (PST), levied and administered by the province, not the CRA — British Columbia PST 7%, Manitoba PST 7%, Saskatchewan PST 6%, and Quebec QST 9.975% (administered by Revenu Québec, and unlike a true PST the QST is a value-added tax); (3) GST only, at a flat 5% — Alberta, Northwest Territories, Nunavut and Yukon, which levy no sales tax of their own. A blended or population-weighted national figure would be an invention and is not served. Basic groceries, prescription drugs, medical devices and exports are zero-rated (0%) everywhere in Canada; financial services, most residential rent and most health/education services are exempt. Rate history: GST introduced at 7% on 1 January 1991, cut to 6% on 1 July 2006 and to 5% on 1 January 2008; the federal 5% has been unchanged for over 18 years. Note the temporary GST/HST holiday on certain goods that ran 14 December 2024 to 15 February 2025 — this was a targeted zero-rating measure, not a change to the 5% statutory rate, but it distorts CPI year-over-year comparisons for those months. canada.ca returns HTTP 403 to plain scripted fetchers (re-confirmed 2026-07-20); this page was read through a real browser session.",
              "stale": false,
              "value": 5,
              "series": "vat",
              "source": {
                "url": "https://www.canada.ca/en/revenue-agency/services/tax/businesses/topics/gst-hst-businesses/charge-collect-which-rate.html",
                "name": "Excise Tax Act, RSC 1985, c. E-15, Part IX, s. 165(1) (GST imposed at 5%); rate reduced from 6% to 5% by the Budget and Economic Statement Implementation Act, 2007 (SC 2007, c. 35…"
              },
              "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": "2008-01-01",
              "last_confirmed": "2026-09-09",
              "last_confirmed_by": "provenance-value-match"
            }
          }
        },
        "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
  },
  {
    "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/ca/policy-rate",
      "tags": [
        "reference-data",
        "central-bank",
        "interest-rates",
        "vat",
        "tax",
        "minimum-wage",
        "public-holidays",
        "north-america",
        "united-states",
        "usa",
        "canada",
        "mexico"
      ],
      "mimeType": "application/json",
      "description": "usaref - North American government reference data. us eval free. $0.005 Base USDC. Cited.",
      "serviceName": "usaref - North American government reference data. us eval free. $0.005 Base USDC. Cited."
    },
    "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%.' 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); 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-11",
              "last_confirmed_by": "provenance-byte-identity"
            }
          }
        },
        "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
  }
]

OVER TIME

All charts use the 7d selector; each series spans only the dates it has data for. Every series is also served as JSON at /api/v1/services/usaref-north-american-government-reference-data/price, /scores, /volume and /buyers. On-chain volume and distinct buyers are measured over the service's settlement address and are a conservative undercount (only settlements that reach a measured facilitator are counted). The on-chain series roll up hourly, so the latest day can be up to about an hour behind; distinct buyers are counted per payout address, so a service that settles to more than one address is an upper bound.

UPTIME

7d UPTIME 100%

RESPONSE TIME

AVG RESP 632ms

PRICE (captured 402, USD)

Median across 2 endpoints. Use the selector to isolate one.

SUB-SCORES (uptime + x402 compliance)

checklist grew 11->14 on 2026-07-28; a step here is a metric change, not a regression

VOLUME (on-chain settlement, USD)

DISTINCT BUYERS

COMPLIANCE

14/14 checks pass · grade A

last 402 captured 2026-09-14 · last up 2026-09-14

402 payload captured
accepts[] array present
payTo address recoverable
payTo at accepts[0].payTo (conformant shape)
payTo is a valid on-chain address
atomic price declared
atomic price in a sane range
asset (token) address declared
network resolves to CAIP-2
payment scheme declared
served over HTTPS
declares the current x402 version (2)
EIP-712 domain parameters present on every EVM entry
x402 v2 envelope delivered in the payment-required header

SITE PILLARS

homepage reachable
openapi doc
pricing page
llms.txt
robots.txt
terms page

recent checks (9) live · click to expand

TIME STATUS RESP CAUSE

21:33:01 UTC ● OK 680ms

21:17:01 UTC ● OK 609ms

21:01:01 UTC ● OK 620ms

20:45:01 UTC ● OK 546ms

20:29:01 UTC ● OK 618ms

20:13:01 UTC ● OK 628ms

19:57:01 UTC ● OK 621ms

19:41:01 UTC ● OK 639ms

19:25:01 UTC ● OK 728ms

EMBED THIS BADGE

Show that usaref — North American government reference data is monitored on x402-list. Paste this on your site or README, it links back to this live listing.

status

usaref — North American government reference data uptime on x402-list — live uptime

// HTML

<a href="https://x402-list.com/services/usaref-north-american-government-reference-data?utm_source=badge&utm_medium=referral&utm_campaign=embed">
  <img src="https://x402-list.com/badge/usaref-north-american-government-reference-data.svg" alt="usaref — North American government reference data listed on x402-list" height="28">
</a>

// Markdown

[![usaref — North American government reference data on x402-list](https://x402-list.com/badge/usaref-north-american-government-reference-data.svg)](https://x402-list.com/services/usaref-north-american-government-reference-data?utm_source=badge&utm_medium=referral&utm_campaign=embed)

// HTML · live uptime variant

<a href="https://x402-list.com/services/usaref-north-american-government-reference-data?utm_source=badge&utm_medium=referral&utm_campaign=embed">
  <img src="https://x402-list.com/badge/usaref-north-american-government-reference-data.svg?data=uptime" alt="usaref — North American government reference data uptime on x402-list" height="28">
</a>

RUN THIS SERVICE?

Keep this listing accurate: propose changes to the name, description, website, category or add new endpoints to monitor. Ownership is verified with a domain proof and every change is reviewed manually; measured data stays read-only.

[ update this listing ]

Earn the verified tier: x402list pays a real call to this endpoint and, if it delivers, the service is delivery-verified. The fee covers the cost of the probe, not the badge; there is no refund if the call does not deliver. Agent and API only, no in-browser signing. See /api.

[ verify this service ($0.25) ]

To request delisting, email info@x402-list.com or update your listing at /services/usaref-north-american-government-reference-data/update.