Government reference data for North America,
sold to machines.

Central-bank policy rates, VAT, minimum wages and public holidays for 10 North American countries — clean JSON, every value cited to its official gazette or central-bank source. Pay per call or buy prepaid credit.

Try us free — JSON + HTML Buy credit — from $10

Eval-free us on usaref. continent[0] owns the HTML canonical. The same ISO may 200 on another brand.

🇧🇸 The Bahamas 🇨🇦 Canada 🇨🇷 Costa Rica 🇩🇴 Dominican Republic 🇬🇹 Guatemala 🇭🇳 Honduras 🇲🇽 Mexico 🇵🇦 Panama 🇸🇻 El Salvador 🇺🇸 United States$0.005 per callor prepaid credit from $10🇺🇸 every US series free — try before you pay

Try it

Browse the catalog (free) to see every country and series held, or from a terminal:

# Free: what exists
curl https://usaref.dev/catalog

# Free for United States — every other country HTTP 402 quotes the price,
# unpaid calls return 402 with payment instructions; clients pay ~half a US
# cent and retry automatically
curl https://usaref.dev/v1/us/policy-rate

Every response looks like this — note the citation, dates and staleness flag:

{
  "country": "US",
  "series": "policy-rate",
  "value": 3.75,
  "unit": "percent (upper bound of 3.50-3.75% target range)",
  "effective_from": "2026-06-18",
  "last_confirmed": "2026-08-21",
  "source": {
    "name": "Federal Open Market Committee, FOMC statement of June 17, 2026 (Federal Reserve Board press release, monetary20260617a), with Implementation Note issued June 17, 2026 (monetary20260617a1); level reaffirmed without change by the FOMC statement of July 29, 2026 -- \"The Committee decided to maintain the target range for the federal funds rate at 3-1/2 to 3-3/4 percent\" (vote 9-3)",
    "url": "https://www.federalreserve.gov/newsevents/pressreleases/monetary20260617a.htm"
  },
  "stale": false
}

Why trust it

Check us before you pay. Every country's current value, its official citation and the date we last verified it are published free on the country pages — like this one. Payment buys JSON, history and point-in-time reads, not access to hidden numbers.

We publish our own mistakes. The accuracy record lists every correction we have made and every catch — including official values that most references still publish wrong.

Cited to the instrument

Not "sourced from official data" — every value links the specific gazette, statute or decision it was read from, with the section where it appears. See exactly what we hold.

The document is fingerprinted

We keep a SHA-256 of every cited document as archived, so you can prove the source you are reading today is the one the value was taken from. Published free at /provenance.

Verified adversarially

One agent researches a value against primary sources; a second is tasked with refuting it. Each value carries a confidence field saying which of our numbers we actually read, and where we could not.

We publish our own errors

Every mistake we have shipped is written up on the accuracy record — what it was, what caused it, and what changed so the class of error is caught next time. A vendor that publishes only other people's mistakes is marketing.

Refusals are free and explained

Where we cannot evidence an answer we return a reasoned refusal with a machine-readable code, validated before the payment gate. You are never charged for a question we know we cannot answer well.

Answers you can sign and file

Any value can be bought as an Ed25519-signed extract carrying its citation, the archived document's hash and the verification chain. Verify it against our public key without asking us.

Honest about staleness

Values past their expected update cycle self-flag stale: true rather than ageing quietly. Unverifiable values are null with a reason — never a plausible-looking number.

A named company, not an anonymous endpoint

Operated by 3L Group Consulting (PTY) LTD, a registered South African company, with a named contact who answers mail and a security.txt that resolves to a person. Reference data you rely on should come from someone you can find.

Pricing

Endpoint	Price
`GET /v1/{country}/{series}` — current value	$0.005
`GET /v1/{country}/{series}/history` — past values	$0.005
`GET /v1/changes?since=` — what changed, and how recently each series was re-verified	Free
`GET /v1/all` — full snapshot, all countries	$0.02
`POST /v1/answers/wage-check` — is this salary legal? verdict + margin	$0.05
`POST /v1/answers/vat` — net/tax/gross incl. levy components	$0.02
`POST /v1/answers/working-days` — business days, holidays, next working day	$0.02
`POST /v1/answers/income-tax` — statutory income tax + per-bracket workings	$0.05
`POST /v1/answers/employment-cost` — cost to employ (statutory contributions, both sides)	$0.10
`GET /v1/certified/{country}/{series}` — signed evidence extract: value + citation + source fingerprint + verification chain, for filing	$0.25
`POST /alerts` — HMAC-signed webhooks: series value changes, or byte changes on the 1,500+ official documents we fingerprint daily	$0.10
`/catalog` · `/v1/{country}/public-holidays`	Free

Two ways to pay, same data, same prices. Machines pay per call with x402 (USDC on Base — no signup, no key: the 402 response quotes the price, the client pays and retries). Humans and companies pay by card: prepaid credit packs from $10 via Paddle on the pricing page, VAT invoice included, sent as an X-API-Key header. Failed calls are refunded automatically on both rails.

Need a monthly invoice, a purchase order or volume pricing? Metered API keys are available — write to [email protected].

For agents & developers

OpenAPI

Machine-readable contract with x402 payment metadata on every route.

MCP server

Point any MCP client at https://usaref.dev/mcp — free discovery tools plus paid data tools.

llms.txt

Plain-language API guide for language models.

x402 manifest

Priced resource list for x402 discovery crawlers.