usaref · North American government reference data
payment-ready until 2026-11-05
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.
Compare: all VAT and tax APIs · all exchange rate APIs
Call it x402 v2
x402 v2
- Base URL
- https://usaref.dev
- Payment
- x402 v2, header channel
$ curl -i 'https://usaref.dev/v1/all' An unpaid request returns HTTP 402 with the payment terms. Sign a payment authorization, then retry with the PAYMENT-SIGNATURE header.
Endpoints 12 paid routes on usaref.dev
GET/v1/all Base$0.02since 10-27
POST/v1/answers/income-tax Base$0.02since 10-27
POST/v1/answers/settlement-date Base$0.02since 10-27
POST/v1/answers/statutory-interest Base$0.02since 10-27
POST/v1/answers/vat Base$0.01since 10-27
POST/v1/answers/wage-check Base$0.02since 10-27
POST/v1/answers/working-days Base$0.002since 10-27
GET/v1/ca/cpi Base$0.003since 10-27
4 more in Example 402 response
Prices as captured in the 402 response: median $0.0065 across the 12 endpoints.
Example 402 response
Endpoints and prices
| Method | Path | Description | Price | Network | Asset | 402 channel | Captured |
|---|---|---|---|---|---|---|---|
| GET | / | Bulk snapshot of every North American government reference series in one JSON file for 10 North American countries: policy rates, VAT/GST, statutory interest, minimum wages, CPI, income, corporate and withholding tax, social contributions and holidays, plus official FX reference rates. Every value cited with source URL, effective date and last_confirmed. Suited to caching the full dataset; single values are GET /v1/{country}/{series}. | $0.02 | Base | USDC | header | since 10-27 |
| POST | / | Statutory income tax on a taxable-income figure: per-bracket workings, effective + marginal rate | $0.02 | Base | USDC | header | since 10-27 |
| POST | / | Settlement/value date: T+n business days across national statutory calendars (intersected), with the market cycle cited to its primary source and a per-day trail | $0.02 | Base | USDC | header | since 10-27 |
| POST | / | Statutory interest calculator for North American countries: simple interest on a principal between two dates at the cited statutory-interest rate (Actual/365), with the rate, day count and workings. Countries whose statute sets no numeric rate are refused without charge. | $0.02 | Base | USDC | header | since 10-27 |
| POST | / | VAT/GST calculation for North American countries with a national VAT or GST (10 North American countries covered): add VAT to a net amount or extract it from a gross one at the cited statutory rate. Returns net, tax and gross, including stacked statutory levies where a country has them, with the official source. | $0.01 | Base | USDC | header | since 10-27 |
| POST | / | Minimum-wage compliance check for North American countries with a statutory minimum wage (10 North American countries covered): is this salary at or above the statutory minimum wage? Returns a verdict, the margin, the applicable wage floor and the legal instrument that set it, cited. | $0.02 | Base | USDC | header | since 10-27 |
| POST | / | Working days / next working day in a date range: weekends + gazetted public holidays | $0.002 | Base | USDC | header | since 10-27 |
| GET | / | Central-bank policy rates, VAT/GST rates and thresholds, statutory interest and minimum wages for 10 North American countries including United States, Canada, Mexico; also CPI, income, corporate and withholding tax, social contributions, holidays. Official central-bank FX reference rates for CA, MX, US. JSON with value, unit, effective date, official source URL and last_confirmed; a country with no such rate says so. GET /v1/{country}/{series}, e.g. /v1/us/policy-rate. | $0.003 | Base | USDC | header | since 10-27 |
| GET | / | Central-bank policy rates, VAT/GST rates and thresholds, statutory interest and minimum wages for 10 North American countries including United States, Canada, Mexico; also CPI, income, corporate and withholding tax, social contributions, holidays. Official central-bank FX reference rates for CA, MX, US. JSON with value, unit, effective date, official source URL and last_confirmed; a country with no such rate says so. GET /v1/{country}/{series}, e.g. /v1/us/policy-rate. | $0.003 | Base | USDC | header | since 09-14 |
| GET | / | Central-bank policy rates, VAT/GST rates and thresholds, statutory interest and minimum wages for 10 North American countries including United States, Canada, Mexico; also CPI, income, corporate and withholding tax, social contributions, holidays. Official central-bank FX reference rates for CA, MX, US. JSON with value, unit, effective date, official source URL and last_confirmed; a country with no such rate says so. GET /v1/{country}/{series}, e.g. /v1/us/policy-rate. | $0.003 | Base | USDC | header | since 09-14 |
| GET | / | Official public holidays for 10 North American countries, cited to the government gazette or official source: date, holiday name, source URL and last_confirmed. For payroll, settlement and working-day calendars. ?year=YYYY to filter. GET /v1/holidays/{country}, e.g. /v1/holidays/us. | $0.002 | Base | USDC | header | since 10-27 |
| GET | / | Official public holidays for 10 North American countries, cited to the government gazette or official source: date, holiday name, source URL and last_confirmed. For payroll, settlement and working-day calendars. ?year=YYYY to filter. GET /v1/holidays/{country}, e.g. /v1/holidays/us. | $0.002 | Base | USDC | header | since 10-27 |
Payment evidence
402 payload captured at . Check evidence JSON · Measurement methodology.
First of 12 payloads captured by the monitor.
195 lines, scroll inside
{
"mpp": "Also payable via MPP (mpp.dev): see the WWW-Authenticate: Payment challenge on this response (evm/charge, Base USDC).",
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "20000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"message": "Payment required: $0.02 USDC on Base. Pay with x402 (PAYMENT-SIGNATURE) or MPP, or buy card credit at /pricing.",
"free_key": "Free API key by email, no card, commercial use allowed: 50 calls a day on the computed answer endpoints (POST /v1/answers/* and POST /v1/vat/determine). POST /v1/keys/free {\"email\": \"...\"} or visit /free-key.",
"resource": {
"url": "https://usaref.dev/v1/answers/settlement-date",
"tags": [
"settlement-date",
"working-days",
"calendar",
"north-america"
],
"iconUrl": "https://usaref.dev/logo.png",
"mimeType": "application/json",
"description": "Settlement/value date: T+n business days across national statutory calendars (intersected), with the market cycle cited to its primary source and a per-day trail",
"serviceName": "Usaref - N America reference"
},
"price_usd": "$0.02",
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"calendars": [
"za",
"us"
],
"trade_date": "2026-08-06",
"business_days": 2
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json"
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"trade_date",
"calendars"
],
"properties": {
"market": {
"type": "string",
"description": "ISO country of the market whose settlement cycle should be applied (with instrument_class)"
},
"receipt": {
"type": "boolean",
"description": "Optional. true adds an Ed25519 answer receipt on a paid 200, included in this price. Not a certified extract."
},
"calendars": {
"type": "array",
"items": {
"type": "string"
},
"description": "1-4 calendar ids to intersect: ISO 3166-1 alpha-2 country codes, plus 'eu.t2' for the euro cash leg. The date must be a business day on every one."
},
"trade_date": {
"type": "string",
"format": "date",
"description": "Trade/reference date. It is day 0: never counted, never rolled."
},
"business_days": {
"type": "integer",
"description": "The offset you are trading under (0-30). Supply this, or market + instrument_class to have a cited cycle applied."
},
"instrument_class": {
"enum": [
"cash_equity",
"etf",
"corporate_bond",
"government_bond",
"tbill",
"repo",
"primary_issuance",
"other"
],
"type": "string",
"description": "Instrument class — a government bond never inherits an equity cycle"
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"status",
"settlement_date",
"convention_applied",
"trail"
],
"properties": {
"trail": {
"type": "array",
"description": "Per-day walk: counted days and skipped days with the reason on each calendar"
},
"status": {
"type": "string"
},
"caveats": {
"type": "array"
},
"receipt": {
"type": "object",
"description": "Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key."
},
"disclaimer": {
"type": "string"
},
"calendars_used": {
"type": "array",
"description": "Each calendar's basis, weekend rule, coverage and official source"
},
"settlement_date": {
"type": "string",
"format": "date"
},
"convention_applied": {
"type": "object",
"description": "The cycle applied, whether it was cited or caller-asserted, its authority tier and citations"
}
}
}
}
}
}
}
}
},
"free_trial": "Try first: 3 free answer or job calls per day per IP, shared — no special header needed. Or buy card credit at /pricing.",
"x402Version": 2
} Other captured 402 responses (11)
Captured payload 2 of 12
{
"mpp": "Also payable via MPP (mpp.dev): see the WWW-Authenticate: Payment challenge on this response (evm/charge, Base USDC).",
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "2000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"message": "Payment required: $0.002 USDC on Base. Pay with x402 (PAYMENT-SIGNATURE) or MPP, or buy card credit at /pricing.",
"resource": {
"url": "https://usaref.dev/v1/holidays/ca",
"tags": [
"public-holidays",
"holidays",
"calendar",
"business-days",
"north-america"
],
"iconUrl": "https://usaref.dev/logo.png",
"mimeType": "application/json",
"description": "North American public holidays by country, cited to the official gazette or government source: date, name, source URL, last_confirmed. ?year=YYYY to filter. GET /v1/holidays/{country}, e.g. /v1/holidays/us.",
"serviceName": "Usaref - N America reference"
},
"price_usd": "$0.002",
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"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"
},
"queryParams": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"additionalProperties": false
}
}
},
"routeTemplate": "/v1/holidays/:country"
}
},
"x402Version": 2
}Captured payload 3 of 12
{
"mpp": "Also payable via MPP (mpp.dev): see the WWW-Authenticate: Payment challenge on this response (evm/charge, Base USDC).",
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "2000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"message": "Payment required: $0.002 USDC on Base. Pay with x402 (PAYMENT-SIGNATURE) or MPP, or buy card credit at /pricing.",
"resource": {
"url": "https://usaref.dev/v1/holidays/mx",
"tags": [
"public-holidays",
"holidays",
"calendar",
"business-days",
"north-america"
],
"iconUrl": "https://usaref.dev/logo.png",
"mimeType": "application/json",
"description": "North American public holidays by country, cited to the official gazette or government source: date, name, source URL, last_confirmed. ?year=YYYY to filter. GET /v1/holidays/{country}, e.g. /v1/holidays/us.",
"serviceName": "Usaref - N America reference"
},
"price_usd": "$0.002",
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"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"
},
"queryParams": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"additionalProperties": false
}
}
},
"routeTemplate": "/v1/holidays/:country"
}
},
"x402Version": 2
}Captured payload 4 of 12
{
"mpp": "Also payable via MPP (mpp.dev): see the WWW-Authenticate: Payment challenge on this response (evm/charge, Base USDC).",
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "3000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"message": "Payment required: $0.003 USDC on Base. Pay with x402 (PAYMENT-SIGNATURE) or MPP, or buy card credit at /pricing.",
"resource": {
"url": "https://usaref.dev/v1/ca/cpi",
"tags": [
"cpi",
"canada",
"reference-data",
"inflation"
],
"iconUrl": "https://usaref.dev/logo.png",
"mimeType": "application/json",
"description": "Canada: Consumer Price Index (Inflation Rate), cited JSON with source URL, effective date and last_confirmed. GET /v1/ca/cpi.",
"serviceName": "Usaref - N America reference"
},
"price_usd": "$0.003",
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {}
},
"output": {
"type": "json",
"example": {
"unit": "percent",
"value": 3,
"series": "cpi",
"source": {
"url": "https://www150.statcan.gc.ca/n1/daily-quotidien/260914/dq260914a-eng.htm",
"name": "Statistics Canada, The Daily, Consumer Price Index, August 2026, released 14 September 2026; Tab"
},
"country": "CA",
"effective_from": "2026-08-01",
"last_confirmed": "2026-10-09"
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input",
"output"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"properties": {},
"additionalProperties": false
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"properties": {
"unit": {
"type": "string"
},
"stale": {
"type": "boolean"
},
"value": {},
"series": {
"type": "string"
},
"source": {
"type": "object"
},
"country": {
"type": "string"
},
"last_confirmed": {
"type": "string"
}
},
"description": "Cited series value (JSON)"
}
}
},
"routeTemplate": "/v1/:country/:series"
}
},
"free_sample": "Human try-before-you-pay: every US series is free for browsers, or with header X-Free-Sample: 1 (or ?sample=1), e.g. /v1/us/policy-rate. Indexers and agents see the normal 402 so every paid op is discoverable. Card credit: /pricing.",
"x402Version": 2
}Captured payload 5 of 12
{
"mpp": "Also payable via MPP (mpp.dev): see the WWW-Authenticate: Payment challenge on this response (evm/charge, Base USDC).",
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "20000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"message": "Payment required: $0.02 USDC on Base. Pay with x402 (PAYMENT-SIGNATURE) or MPP, or buy card credit at /pricing.",
"resource": {
"url": "https://usaref.dev/v1/all",
"tags": [
"reference-data",
"snapshot",
"bulk",
"north-america"
],
"iconUrl": "https://usaref.dev/logo.png",
"mimeType": "application/json",
"description": "Snapshot of every series, all countries",
"serviceName": "Usaref - N America reference"
},
"price_usd": "$0.02",
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {}
},
"output": {
"type": "json"
}
},
"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"
},
"queryParams": {
"type": "object",
"properties": {},
"additionalProperties": false
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "array",
"items": {
"type": "object",
"required": [
"country",
"series"
],
"properties": {
"series": {
"type": "array",
"items": {
"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",
"null"
],
"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"
},
"effective_from_basis": {
"enum": [
"restatement"
],
"type": "string",
"description": "Optional. Absent: effective_from is the date the value became the law (a genuine change point). 'restatement': effective_from is the date the value's CURRENT LEGAL BASIS took effect (a new tax code, an annual finance law) while the value itself is older and its true origin is not primary-verifiable — a verified floor, not a change. Do not read a restatement row as the value having changed on that date."
}
}
}
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code"
}
}
},
"description": "One entry per country, each with all its series values"
}
}
}
}
}
}
},
"x402Version": 2
}Captured payload 6 of 12
{
"mpp": "Also payable via MPP (mpp.dev): see the WWW-Authenticate: Payment challenge on this response (evm/charge, Base USDC).",
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"message": "Payment required: $0.01 USDC on Base. Pay with x402 (PAYMENT-SIGNATURE) or MPP, or buy card credit at /pricing.",
"free_key": "Free API key by email, no card, commercial use allowed: 50 calls a day on the computed answer endpoints (POST /v1/answers/* and POST /v1/vat/determine). POST /v1/keys/free {\"email\": \"...\"} or visit /free-key.",
"resource": {
"url": "https://usaref.dev/v1/answers/vat",
"tags": [
"vat",
"tax",
"gst",
"north-america"
],
"iconUrl": "https://usaref.dev/logo.png",
"mimeType": "application/json",
"description": "VAT rate gross-up or extract for an amount: net/tax/gross incl. statutory levy components",
"serviceName": "Usaref - N America reference"
},
"price_usd": "$0.01",
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"mode": "add",
"amount": 1000,
"country": "bs"
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json"
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"country",
"amount"
],
"properties": {
"band": {
"type": "string",
"description": "Optional. Apply a statutory reduced/zero/super-reduced band instead of the standard rate. Valid keys per country: GET /catalog (vat_bands_available). Omit for the standard rate — we say when we assumed it. Unknown key is refused free with the list."
},
"mode": {
"enum": [
"add",
"extract"
],
"type": "string",
"description": "add = amount is net, add VAT on top; extract = amount is gross, back the VAT out (default add)"
},
"amount": {
"type": "number",
"description": "Amount in the country's own currency"
},
"country": {
"enum": [
"bs",
"ca",
"cr",
"do",
"gt",
"hn",
"mx",
"pa",
"sv",
"us"
],
"type": "string",
"description": "ISO country code"
},
"receipt": {
"type": "boolean",
"description": "Optional. true adds an Ed25519 answer receipt on a paid 200, included in this price. Not a certified extract."
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"status",
"rate",
"net",
"tax",
"gross"
],
"properties": {
"net": {
"type": "number"
},
"tax": {
"type": "number"
},
"rate": {
"type": "number",
"description": "Rate applied (combined effective rate where levies stack)"
},
"gross": {
"type": "number"
},
"status": {
"type": "string"
},
"receipt": {
"type": "object",
"description": "Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key."
},
"workings": {
"type": "string"
},
"components": {
"type": "array",
"description": "Per-levy breakdown where the rate is composite (e.g. Ghana VAT + NHIL + GETFund)"
},
"disclaimer": {
"type": "string"
},
"provenance": {
"type": "object",
"description": "The statutory instrument the answer rests on: effective_from, last_confirmed, official source URL, notes"
}
}
}
}
}
}
}
}
},
"free_trial": "Try first: 3 free answer or job calls per day per IP, shared — no special header needed. Or buy card credit at /pricing.",
"x402Version": 2
}Captured payload 7 of 12
{
"mpp": "Also payable via MPP (mpp.dev): see the WWW-Authenticate: Payment challenge on this response (evm/charge, Base USDC).",
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "2000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"message": "Payment required: $0.002 USDC on Base. Pay with x402 (PAYMENT-SIGNATURE) or MPP, or buy card credit at /pricing.",
"free_key": "Free API key by email, no card, commercial use allowed: 50 calls a day on the computed answer endpoints (POST /v1/answers/* and POST /v1/vat/determine). POST /v1/keys/free {\"email\": \"...\"} or visit /free-key.",
"resource": {
"url": "https://usaref.dev/v1/answers/working-days",
"tags": [
"working-days",
"public-holidays",
"calendar",
"north-america"
],
"iconUrl": "https://usaref.dev/logo.png",
"mimeType": "application/json",
"description": "Working days / next working day in a date range: weekends + gazetted public holidays",
"serviceName": "Usaref - N America reference"
},
"price_usd": "$0.002",
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"to": "2026-08-31",
"from": "2026-08-01",
"country": "bs"
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json"
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"country",
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"format": "date",
"description": "Range end, inclusive (max 366 days)"
},
"from": {
"type": "string",
"format": "date",
"description": "Range start, inclusive"
},
"country": {
"enum": [
"bs",
"ca",
"cr",
"do",
"gt",
"hn",
"mx",
"pa",
"sv",
"us"
],
"type": "string",
"description": "ISO country code"
},
"receipt": {
"type": "boolean",
"description": "Optional. true adds an Ed25519 answer receipt on a paid 200, included in this price. Not a certified extract."
},
"subdivision": {
"type": "string",
"description": "Optional. Apply a sub-national statutory holiday calendar (national + that region's days) instead of national-only. ISO 3166-2 code, e.g. 'DE-BY'. Countries that offer regions expose them as `subdivisions` on GET /:country/public-holidays. Unknown code is refused free with the list."
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"status",
"total_days",
"working_days",
"next_working_day"
],
"properties": {
"status": {
"type": "string"
},
"caveats": {
"type": "array"
},
"receipt": {
"type": "object",
"description": "Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key."
},
"weekend": {
"type": "array",
"description": "This country's weekly rest days (Egypt: Fri–Sat)"
},
"disclaimer": {
"type": "string"
},
"provenance": {
"type": "object",
"description": "The statutory instrument the answer rests on: effective_from, last_confirmed, official source URL, notes"
},
"total_days": {
"type": "integer"
},
"subdivision": {
"type": [
"object",
"null"
],
"description": "The sub-national calendar applied (code, name, source, the region's added days), or null when the national calendar was used"
},
"weekend_days": {
"type": "integer"
},
"working_days": {
"type": "integer"
},
"public_holidays": {
"type": "array",
"description": "Statutory holidays falling on weekdays in the range"
},
"next_working_day": {
"type": "string",
"format": "date"
}
}
}
}
}
}
}
}
},
"free_trial": "Try first: 3 free answer or job calls per day per IP, shared — no special header needed. Or buy card credit at /pricing.",
"x402Version": 2
}Captured payload 8 of 12
{
"mpp": "Also payable via MPP (mpp.dev): see the WWW-Authenticate: Payment challenge on this response (evm/charge, Base USDC).",
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "20000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"message": "Payment required: $0.02 USDC on Base. Pay with x402 (PAYMENT-SIGNATURE) or MPP, or buy card credit at /pricing.",
"free_key": "Free API key by email, no card, commercial use allowed: 50 calls a day on the computed answer endpoints (POST /v1/answers/* and POST /v1/vat/determine). POST /v1/keys/free {\"email\": \"...\"} or visit /free-key.",
"resource": {
"url": "https://usaref.dev/v1/answers/income-tax",
"tags": [
"income-tax",
"tax",
"north-america"
],
"iconUrl": "https://usaref.dev/logo.png",
"mimeType": "application/json",
"description": "Statutory income tax on a taxable-income figure: per-bracket workings, effective + marginal rate",
"serviceName": "Usaref - N America reference"
},
"price_usd": "$0.02",
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"country": "ca",
"taxable_income": 5000000
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json"
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"country",
"taxable_income"
],
"properties": {
"country": {
"enum": [
"bs",
"ca",
"cr",
"do",
"gt",
"hn",
"mx",
"pa",
"sv",
"us"
],
"type": "string",
"description": "ISO country code"
},
"receipt": {
"type": "boolean",
"description": "Optional. true adds an Ed25519 answer receipt on a paid 200, included in this price. Not a certified extract."
},
"taxable_income": {
"type": "number",
"description": "Taxable income in the country's local currency, in the schedule's own period basis (annual for most, monthly for CI/UG/ET/CR). NOT gross pay — reliefs are applied before this."
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"status",
"tax",
"effective_rate",
"breakdown"
],
"properties": {
"tax": {
"type": "number",
"description": "Statutory income tax on the taxable income"
},
"status": {
"type": "string"
},
"receipt": {
"type": "object",
"description": "Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key."
},
"tax_unit": {
"type": "object",
"description": "Present for UVT/UTA/UIT/BPC schedules — the unit's currency value used to scale the bands"
},
"breakdown": {
"type": "array",
"description": "Per-bracket workings: band, rate, taxable-in-band, tax"
},
"disclaimer": {
"type": "string"
},
"net_of_tax": {
"type": "number"
},
"provenance": {
"type": "object",
"description": "The statutory instrument the answer rests on: effective_from, last_confirmed, official source URL, notes"
},
"scope_note": {
"type": "string",
"description": "Explicit boundary: this is tax on taxable income, NOT net take-home (reliefs + social security excluded)"
},
"marginal_rate": {
"type": "number"
},
"effective_rate": {
"type": "number"
}
}
}
}
}
}
}
}
},
"free_trial": "Try first: 3 free answer or job calls per day per IP, shared — no special header needed. Or buy card credit at /pricing.",
"x402Version": 2
}Captured payload 9 of 12
{
"mpp": "Also payable via MPP (mpp.dev): see the WWW-Authenticate: Payment challenge on this response (evm/charge, Base USDC).",
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "20000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"message": "Payment required: $0.02 USDC on Base. Pay with x402 (PAYMENT-SIGNATURE) or MPP, or buy card credit at /pricing.",
"free_key": "Free API key by email, no card, commercial use allowed: 50 calls a day on the computed answer endpoints (POST /v1/answers/* and POST /v1/vat/determine). POST /v1/keys/free {\"email\": \"...\"} or visit /free-key.",
"resource": {
"url": "https://usaref.dev/v1/answers/wage-check",
"tags": [
"wage-check",
"minimum-wage",
"salary",
"north-america"
],
"iconUrl": "https://usaref.dev/logo.png",
"mimeType": "application/json",
"description": "Wage check: is this salary legal vs statutory minimum wage? Verdict + margin + instrument",
"serviceName": "Usaref - N America reference"
},
"price_usd": "$0.02",
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"amount": 85000,
"period": "month",
"country": "bs"
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json"
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"country",
"amount",
"period"
],
"properties": {
"amount": {
"type": "number",
"description": "Wage to check, in the country's own currency"
},
"period": {
"enum": [
"month",
"day",
"hour",
"week"
],
"type": "string",
"description": "Period the amount covers — must match the statutory floor's period (no guessed conversions)"
},
"country": {
"enum": [
"bs",
"ca",
"cr",
"do",
"gt",
"hn",
"mx",
"pa",
"sv",
"us"
],
"type": "string",
"description": "ISO country code"
},
"receipt": {
"type": "boolean",
"description": "Optional. true adds an Ed25519 answer receipt on a paid 200, included in this price. Not a certified extract."
},
"schedule": {
"type": "string",
"description": "Optional. Measure against a sectoral, zonal or occupation-grade floor instead of the general one — 'above the national floor' is not the same as compliant. Valid keys per country: GET /catalog (wage_schedules_available). Unknown key is refused free with the list."
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"status",
"verdict"
],
"properties": {
"floor": {
"type": "object",
"description": "The statutory minimum: value, unit, period"
},
"margin": {
"type": "object",
"description": "amount and percent above/below the floor"
},
"status": {
"enum": [
"ok",
"not_comparable",
"no_statutory_minimum"
],
"type": "string"
},
"receipt": {
"type": "object",
"description": "Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key."
},
"verdict": {
"enum": [
"above",
"at",
"below",
null
],
"type": [
"string",
"null"
]
},
"workings": {
"type": "string"
},
"disclaimer": {
"type": "string"
},
"provenance": {
"type": "object",
"description": "The statutory instrument the answer rests on: effective_from, last_confirmed, official source URL, notes"
}
}
}
}
}
}
}
}
},
"free_trial": "Try first: 3 free answer or job calls per day per IP, shared — no special header needed. Or buy card credit at /pricing.",
"x402Version": 2
}Captured payload 10 of 12
{
"mpp": "Also payable via MPP (mpp.dev): see the WWW-Authenticate: Payment challenge on this response (evm/charge, Base USDC).",
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "20000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"message": "Payment required: $0.02 USDC on Base. Pay with x402 (PAYMENT-SIGNATURE) or MPP, or buy card credit at /pricing.",
"free_key": "Free API key by email, no card, commercial use allowed: 50 calls a day on the computed answer endpoints (POST /v1/answers/* and POST /v1/vat/determine). POST /v1/keys/free {\"email\": \"...\"} or visit /free-key.",
"resource": {
"url": "https://usaref.dev/v1/answers/statutory-interest",
"tags": [
"statutory-interest",
"interest-rates",
"north-america"
],
"iconUrl": "https://usaref.dev/logo.png",
"mimeType": "application/json",
"description": "Simple statutory interest on a principal at the cited statutory-interest series rate (Actual/365 simple). A series with no numeric rate is refused free",
"serviceName": "Usaref - N America reference"
},
"price_usd": "$0.02",
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"days": 30,
"country": "bs",
"principal": 1000
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json"
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"country",
"principal"
],
"properties": {
"to": {
"type": "string",
"format": "date",
"description": "Period end, exclusive (YYYY-MM-DD, UTC)."
},
"days": {
"type": "number",
"description": "Day-count days, finite and greater than 0. Supply this, or from and to. If both are sent they must agree."
},
"from": {
"type": "string",
"format": "date",
"description": "Period start, inclusive (YYYY-MM-DD, UTC). With `to`: day count is to − from. `to` is exclusive."
},
"country": {
"enum": [
"bs",
"ca",
"cr",
"do",
"gt",
"hn",
"mx",
"pa",
"sv",
"us"
],
"type": "string",
"description": "ISO country code that holds a statutory-interest series on this brand"
},
"receipt": {
"type": "boolean",
"description": "Optional. true adds an Ed25519 answer receipt on a paid 200, included in this price. Not a certified extract."
},
"principal": {
"type": "number",
"description": "Principal in the country's own currency, finite and greater than 0"
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"status",
"rate",
"interest",
"workings"
],
"properties": {
"days": {
"type": "number"
},
"rate": {
"type": "number",
"description": "Headline statutory-interest series rate, percent, after derived materialization"
},
"status": {
"enum": [
"ok"
],
"type": "string"
},
"receipt": {
"type": "object",
"description": "Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key."
},
"interest": {
"type": "number",
"description": "principal × (rate/100) × (days/365), rounded to 2 decimal places"
},
"workings": {
"type": "string"
},
"principal": {
"type": "number"
},
"rate_unit": {
"type": "string"
},
"disclaimer": {
"type": "string"
},
"provenance": {
"type": "object",
"description": "The statutory instrument the answer rests on: effective_from, last_confirmed, official source URL, notes"
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"day_count_basis": {
"type": "string",
"description": "actual/365_simple — no jurisdiction compounding"
}
}
}
}
}
}
}
}
},
"free_trial": "Try first: 3 free answer or job calls per day per IP, shared — no special header needed. Or buy card credit at /pricing.",
"x402Version": 2
}Captured payload 11 of 12
{
"mpp": "Also payable via MPP (mpp.dev): see the WWW-Authenticate: Payment challenge on this response (evm/charge, Base USDC).",
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "3000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"message": "Payment required: $0.003 USDC on Base. Pay with x402 (PAYMENT-SIGNATURE) or MPP, or buy card credit at /pricing.",
"resource": {
"url": "https://usaref.dev/v1/ca/vat",
"tags": [
"vat",
"canada",
"reference-data",
"tax",
"gst"
],
"iconUrl": "https://usaref.dev/logo.png",
"mimeType": "application/json",
"description": "Canada: Goods and Services Tax (GST), cited JSON with source URL, effective date and last_confirmed. GET /v1/ca/vat.",
"serviceName": "Usaref - N America reference"
},
"price_usd": "$0.003",
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {}
},
"output": {
"type": "json",
"example": {
"unit": "percent",
"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% "
},
"country": "CA",
"effective_from": "2008-01-01",
"last_confirmed": "2026-10-10"
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input",
"output"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"properties": {},
"additionalProperties": false
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"properties": {
"unit": {
"type": "string"
},
"stale": {
"type": "boolean"
},
"value": {},
"series": {
"type": "string"
},
"source": {
"type": "object"
},
"country": {
"type": "string"
},
"last_confirmed": {
"type": "string"
}
},
"description": "Cited series value (JSON)"
}
}
},
"routeTemplate": "/v1/:country/:series"
}
},
"free_sample": "Human try-before-you-pay: every US series is free for browsers, or with header X-Free-Sample: 1 (or ?sample=1), e.g. /v1/us/policy-rate. Indexers and agents see the normal 402 so every paid op is discoverable. Card credit: /pricing.",
"x402Version": 2
}Captured payload 12 of 12
{
"mpp": "Also payable via MPP (mpp.dev): see the WWW-Authenticate: Payment challenge on this response (evm/charge, Base USDC).",
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
"amount": "3000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"message": "Payment required: $0.003 USDC on Base. Pay with x402 (PAYMENT-SIGNATURE) or MPP, or buy card credit at /pricing.",
"resource": {
"url": "https://usaref.dev/v1/ca/policy-rate",
"tags": [
"policy-rate",
"canada",
"reference-data",
"central-bank",
"interest-rates"
],
"iconUrl": "https://usaref.dev/logo.png",
"mimeType": "application/json",
"description": "Canada: Policy Interest Rate, cited JSON with source URL, effective date and last_confirmed. GET /v1/ca/policy-rate.",
"serviceName": "Usaref - N America reference"
},
"price_usd": "$0.003",
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {}
},
"output": {
"type": "json",
"example": {
"unit": "percent",
"value": 2.25,
"series": "policy-rate",
"source": {
"url": "https://www.bankofcanada.ca/2026/09/fad-press-release-2026-09-02/",
"name": "Bank of Canada, Fixed Announcement Date press release 2 September 2026, 'Bank of Canada maintain"
},
"country": "CA",
"effective_from": "2025-10-29",
"last_confirmed": "2026-10-24"
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input",
"output"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"properties": {},
"additionalProperties": false
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"properties": {
"unit": {
"type": "string"
},
"stale": {
"type": "boolean"
},
"value": {},
"series": {
"type": "string"
},
"source": {
"type": "object"
},
"country": {
"type": "string"
},
"last_confirmed": {
"type": "string"
}
},
"description": "Cited series value (JSON)"
}
}
},
"routeTemplate": "/v1/:country/:series"
}
},
"free_sample": "Human try-before-you-pay: every US series is free for browsers, or with header X-Free-Sample: 1 (or ?sample=1), e.g. /v1/us/policy-rate. Indexers and agents see the normal 402 so every paid op is discoverable. Card credit: /pricing.",
"x402Version": 2
}Can I trust it score from our own monitoring
score from our own monitoring
87/100 Solid
#121 of 446 in Data. Bands: strong 93+, solid 75+, mixed 55+, weak below 55.
- Reliability
- 99.7% uptime 30d
- Compliance
- A 14/14 checks pass
- Price
- $0.002 to $0.02 p25 in Data
- Risk
- clean no risk flag
- Traction
- $0.00 30d 0 buyers
- Last change
- schema changed 3d ago 2 in 30d
14/14 compliance checks
- 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
402 terms unchanged since 2026-10-27. Last up 2026-10-29.
── Site signals
- homepage reachable
- openapi doc
- pricing page
- llms.txt
- robots.txt
- terms page
How the score works
What the score read on this service: status online, 99.7% uptime 30d, 468ms response p95, x402 compliance 14 of 14, $0.002 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.
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.
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 446 listings, this one among them: the same 446 the position above is counted against. When the two differ, the field is the wider one, 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.
Traction is a conservative undercount.
All measured facts
What it does
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. Finished jobs, one paid call returning one cited dossier: cost this hire ($0.50, POST /v1/jobs/cost-hire: wage-floor verdict, employer and employee contributions, total employer cost and first working day for the United States, Canada and Mexico) and charge this sale ($0.50, POST /v1/jobs/charge-sale, or $0.75 with a signed certified extract of the governing rate: whether to charge VAT, which country's and how much, under EU, UK and South African place-of-supply rules). Anything that cannot be answered in full is refused free, with no charge. One free catalog of all seven regional brands: https://afriref.dev/fleet/catalog.json. Paid per call in USDC on Base via x402 or MPP, no key, no signup. Public holidays are free. The United States is the free evaluation country.
usaref · North American government reference data is a listed x402 Data API. Captured payment terms name Base. Monitoring and settlement figures below describe the observations available to this directory; an unpaid HTTP 402 check does not prove that a paid call will deliver.
Assessment computed at . Latest service check observed at . Service data JSON · Measurement methodology.
Page rendered at . This response time is separate from the observation and computation times attached to each measurement.
Latest endpoint observation: . Latest price capture: . Prices are recorded quotes, not a promise of availability. Token assets and payment terms are listed separately. Endpoint data JSON · Price history JSON · Measurement methodology.
Assessment computed at . Uptime uses the stated daily-rollup window; response times are in milliseconds, compliance is passed/evaluated checks, and traction is a measured settlement floor. The comparison score is out of 100 within this category. Assessment JSON · Measurement methodology.
Observed daily coverage: 2026-09-30 to 2026-10-29 UTC. Daily monitoring and settlement rollups do not expose their computation time; a bucket date is not an update timestamp. Uptime and response JSON · Volume JSON · Buyers JSON · Measurement methodology.
Ranked from the measured category pool, refreshed at most once a minute. The comparison has no persisted computation timestamp; the assessment time above belongs to this service only. Ranking API documentation · Ranking methodology.
x402 List home · Services · Data
- uptime · latest daily rollup
- 100%
- uptime 7d
- 100%
- uptime 30d
- 99.7%
- uptime 90d
- 99.8%
- response p95
- 468ms
- avg response
- 801ms
- total checks
- 2,998
Measured on the unpaid 402 handshake, not the paid call. A service can 402 correctly and still fail after payment.
- price (min)
- $0.002
- price (max)
- $0.02
- category percentile (min)
- p25 in Data
- category percentile (max)
- p40 in Data
- endpoints / prices
- 12 / 4
- model
- tiered
- stability
- 0%
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
- 104d
- registrar
- CloudFlare, Inc.
- hosting
- custom
- domain created
- 2026-07-15
Identity facts, not a risk score.
- assessment volume 30d
- $0.00
- exact assessment volume 30d (USD)
- 0
- assessment recorded at (UTC)
- 2026-10-29T19:33:03.519Z
- buyers 30d
- 0
- settlements 30d
- 0
- measured since
- --- (start of our harvest window)
- last settlement
- ---
- top buyer share
- -
- top 3 buyers share
- -
- concentrated volume
- no
- trend 7d vs 30d
- -
- networks
- eip155:8453
- volume all-time
- $0
- settlements all-time
- 0
- median settlement 30d
- -
- max settlement 30d
- -
Assessment volume uses the latest 30d assessment. Over time sums daily address snapshots, rounded to cents and refreshed separately. The two sources can differ in timing, precision and shared-address attribution. Amounts use cents for comparison; known sub-cent values keep up to 12 significant digits. The exact stored assessment value is shown above.
Conservative undercount: only USDC settlements via facilitators we measure are counted. A measured floor, not an estimate.
Top buyer share lowers the on-chain traction part of the ranking score behind this page's verdict and /best, by up to half when one address holds all 30d volume. The Recommended and Highest volume sorts of the services list do not use it; they use the Concentrated volume rule instead.
- member since
- 2026-09-14
Recent checks
| Checked at (UTC) | Status | HTTP | Response | Endpoints |
|---|---|---|---|---|
| Online | 402 | 372ms | 12 | |
| Online | 402 | 281ms | 12 | |
| Online | 402 | 258ms | 12 | |
| Online | 402 | 259ms | 12 | |
| Online | 402 | 227ms | 12 | |
| Online | 402 | 236ms | 12 | |
| Online | 402 | 220ms | 12 | |
| Online | 402 | 226ms | 12 | |
| Online | 402 | 176ms | 12 | |
| Online | 402 | 241ms | 12 | |
| Online | 402 | 245ms | 12 | |
| Online | 402 | 217ms | 12 | |
| Online | 402 | 194ms | 12 | |
| Online | 402 | 183ms | 12 | |
| Online | 402 | 236ms | 12 | |
| Online | 402 | 222ms | 12 | |
| Online | 402 | 257ms | 12 | |
| Online | 402 | 220ms | 12 |
Changes2 in 30d
| Observed at (UTC) | Change | Evidence |
|---|---|---|
| schema changed | endpoint added endpoint added endpoint added endpoint added endpoint added endpoint added endpoint added endpoint added endpoint added endpoint added schema added schema added schema added schema added schema added schema added schema added schema added schema added schema added | |
| price changed |
|
Amounts are on-wire atomic units in the named asset.
Over time
On-chain volume daily snapshots, USD 30d: $0.00
volume no data in the payload
Distinct buyers per dayDistinct buyers per day
Uptime 2 of 29 completed days below 100%
uptime below 100%, to scale
- Volume 30d
- $0.00
- Uptime
- 2 of 29 completed days below 100%
More charts
Response time daily average, ms min 254ms, avg 774ms, max 1301ms
09-30 to 10-29* UTC
Scores over time
x402 compliance low 14/14, high 14/14
09-30 to 10-29* UTC
Price percentile in Data own low to high; exact values below
09-30 to 10-29* UTC
Site signals present (of 6) own low to high; exact values below
09-30 to 10-29* UTC
Scores: one day per column, 09-30 to 10-29*, on the columns of Response time. Uptime held below 100% on some days in this window, including any partial day. Daily readings remain in the Uptime strip and Values. The checklist grew from 11 to 14 checks on 2026-07-28, before this window. Pillar lines use their own low and high. Exact dated readings are available in each readout and in Values.
Each series spans only the dates it has data for. Every series is also served as JSON at /api, /scores, /volume and /buyers.
Values
* today so far, partial (UTC).
The uptime summary counts completed UTC days only. The strip, readouts and table retain today's partial reading.
Daily snapshot total, no volume data in the last 30d. The visible 30d total in Traction comes from the latest assessment. These sources can differ in their window, refresh time, cent rounding and shared-address attribution.
Daily address snapshots: 2026-09-30 to 2026-10-29 UTC; * today so far, partial (UTC). Daily snapshots store cents. A recorded $0.00 with settlements cannot distinguish exact zero from volume rounded away. Lost precision is unavailable here.
Settlement volume uses the stored USD valuation of tracked payments; it is distinct from token quantities. USD-pegged assets are valued at 1 USD per token in these rollups. The measured settlement floor does not cover all payments to this service.
Assessment history last recorded at . Each UTC day uses its last recorded run; missing readings stay unmeasured. Assessment history JSON · Measurement methodology.
| Day | Volume | Buyers | Settlements | Uptime | Response | Compliance | Price percentile | Site signals |
|---|---|---|---|---|---|---|---|---|
| 2026-09-30 | no data | no data | no data | 100% | 921.58ms | 14/14 | p41 | 6/6 |
| 2026-10-01 | no data | no data | no data | 100% | 945.88ms | 14/14 | p41 | 6/6 |
| 2026-10-02 | no data | no data | no data | 100% | 942.53ms | 14/14 | p41 | 6/6 |
| 2026-10-03 | no data | no data | no data | 100% | 847.62ms | 14/14 | p41 | 6/6 |
| 2026-10-04 | no data | no data | no data | 100% | 1301.30ms | 14/14 | p41 | 6/6 |
| 2026-10-05 | no data | no data | no data | 100% | 753.91ms | 14/14 | p43 | 6/6 |
| 2026-10-06 | no data | no data | no data | 100% | 749.96ms | 14/14 | p42 | 6/6 |
| 2026-10-07 | no data | no data | no data | 98.89% | 623.60ms | 14/14 | p42 | 6/6 |
| 2026-10-08 | no data | no data | no data | 100% | 1136.98ms | 14/14 | p43 | 6/6 |
| 2026-10-09 | no data | no data | no data | 92.22% | 741.73ms | 14/14 | p43 | 6/6 |
| 2026-10-10 | no data | no data | no data | 100% | 713.97ms | 14/14 | p42 | 6/6 |
| 2026-10-11 | no data | no data | no data | 100% | 666.14ms | 14/14 | p43 | 6/6 |
| 2026-10-12 | no data | no data | no data | 100% | 698.42ms | 14/14 | p43 | 6/6 |
| 2026-10-13 | no data | no data | no data | 100% | 682.88ms | 14/14 | p43 | 6/6 |
| 2026-10-14 | no data | no data | no data | 100% | 725.57ms | 14/14 | p42 | 6/6 |
| 2026-10-15 | no data | no data | no data | 100% | 782.98ms | 14/14 | p42 | 6/6 |
| 2026-10-16 | no data | no data | no data | 100% | 873.08ms | 14/14 | p42 | 6/6 |
| 2026-10-17 | no data | no data | no data | 100% | 1090.20ms | 14/14 | p33 | 6/6 |
| 2026-10-18 | no data | no data | no data | 100% | 761.57ms | 14/14 | p33 | 6/6 |
| 2026-10-19 | no data | no data | no data | 100% | 750.94ms | 14/14 | p33 | 6/6 |
| 2026-10-20 | no data | no data | no data | 100% | 754.97ms | 14/14 | p33 | 6/6 |
| 2026-10-21 | no data | no data | no data | 100% | 754.01ms | 14/14 | p33 | 6/6 |
| 2026-10-22 | no data | no data | no data | 100% | 856.46ms | 14/14 | p33 | 6/6 |
| 2026-10-23 | no data | no data | no data | 100% | 1011.38ms | 14/14 | p33 | 6/6 |
| 2026-10-24 | no data | no data | no data | 100% | 729.73ms | 14/14 | p33 | 6/6 |
| 2026-10-25 | no data | no data | no data | 100% | 691.42ms | 14/14 | p33 | 6/6 |
| 2026-10-26 | no data | no data | no data | 100% | 653.42ms | 14/14 | p33 | 6/6 |
| 2026-10-27 | no data | no data | no data | 100% | 514.13ms | 14/14 | p24 | 6/6 |
| 2026-10-28 | no data | no data | no data | 100% | 282.73ms | 14/14 | p24 | 6/6 |
| 2026-10-29* | no data | no data | no data | 100% | 253.87ms | 14/14 | p25 | 6/6 |
Alternatives in Data
5 of 445 other ranked services in Data, ordered by the same measured score.
Own this service?
Keep this listing accurate. Ownership is proven with a domain check and every change is reviewed by hand.
Update this listingEarn 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)Embed a badge
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
[](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>
Delisting
To request delisting, email info@x402-list.com with the service name, slug, or URL. Removal is free and does not require proof of ownership. See all free email requests.