Usaref - N America reference
usaref.dev · 24 paid endpoints · listed 2026-10-27
Working days / next working day in a date range: weekends + gazetted public holidays
downlast check 2 days ago
0%valid x402 answers, 72 h
sharedUSDC received on Base, 7 days
7distinct payers, 7 days
9.5score (0-100)
Paid endpoints
| Method | Endpoint | Price | Networks |
|---|---|---|---|
| POST | usaref.dev/v1/answers/working-days Working days / next working day in a date range: weekends + gazetted public holidays | $0.002 | Base |
| GET | usaref.dev/v1/holidays/:country Official public holidays for 10 North American countries, cited to the government gazette or official source: date, holiday name, source URL and last_confirmed. | $0.002 | Base |
| GET | usaref.dev/v1/:country/:series Central-bank policy rates, VAT/GST rates and thresholds, statutory interest and minimum wages for 10 North American countries including United States, Canada, M | $0.003 | Base |
| GET | usaref.dev/v1/:country/:series/history Past values of one government reference series for 10 North American countries: central-bank policy-rate decisions, VAT/GST and minimum-wage changes, statutory | $0.003 | Base |
| GET | usaref.dev/v1/taxid/validate VAT number and tax ID validation for North American countries: valid or invalid, normalised form, ID type and the reason a number failed. Checks the format plus | $0.003 | Base |
| POST | usaref.dev/v1/answers/vat 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 | $0.01 | Base |
| GET | usaref.dev/v1/brief/:country Country profile in one call for any of 10 North American countries: central-bank policy rate, VAT/GST and registration threshold, statutory interest, minimum wa | $0.01 | Base |
| GET | usaref.dev/v1/all Bulk snapshot of every North American government reference series in one JSON file for 10 North American countries: policy rates, VAT/GST, statutory interest, m | $0.02 | Base |
| POST | usaref.dev/v1/answers/income-tax Statutory income tax on a taxable-income figure: per-bracket workings, effective + marginal rate | $0.02 | Base |
| POST | usaref.dev/v1/answers/settlement-date 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 trai | $0.02 | Base |
| POST | usaref.dev/v1/answers/statutory-interest Statutory interest calculator for North American countries: simple interest on a principal between two dates at the cited statutory-interest rate (Actual/365), | $0.02 | Base |
| POST | usaref.dev/v1/answers/wage-check 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 s | $0.02 | Base |
| GET | usaref.dev/v1/compare Compare one government reference series (VAT, policy rate, minimum wage, CPI, corporate tax...) across up to 10 North American countries in one call, each row c | $0.02 | Base |
| POST | usaref.dev/v1/answers/employment-cost Cost to employ: every statutory contribution priced line by line, employee and employer sides separated, with the schemes we will not price named and reasoned | $0.05 | Base |
| POST | usaref.dev/v1/vat/determine Cross-border VAT treatment for a digital-services sale: place of supply, who accounts, rate basis, registration trigger — the applied rule cited to the statute | $0.05 | Base |
| GET | usaref.dev/v1/certified/:country/:series Certified extract of one North American reference value (policy rate, VAT, minimum wage, statutory interest, tax rates and more, 10 North American countries): t | $0.10 | Base |
| POST | usaref.dev/v1/jobs/evidence-pack Country evidence pack: the full cited country brief plus up to 3 Ed25519-signed certified extracts (vat, policy-rate, minimum-wage by default) for a compliance | $0.25 | Base |
| POST | usaref.dev/v1/jobs/next-filings Next filings: upcoming VAT, PAYE and corporate-tax due dates in a window, rolled for weekends and public holidays, each rule cited. Countries here: CA, DO, US. | $0.35 | Base |
| POST | usaref.dev/v1/jobs/invoice-payable Invoice due date and late interest: is this invoice overdue, by how many days, and the statutory late-payment (or statutory) interest owed, rate and workings ci | $0.40 | Base |
| POST | usaref.dev/v1/jobs/charge-sale Charge this sale: should this invoice carry VAT, which country's, and how much - place of supply (EU, UK, South Africa rules), net/VAT/gross, registration thres | $0.50 | Base |
| POST | usaref.dev/v1/jobs/cost-hire Cost this hire: one dossier for a salary in CA, MX, US - wage-floor verdict, employer and employee contributions (or PAYE net pay), employer cost, optional inco | $0.50 | Base |
| POST | usaref.dev/v1/jobs/charge-sale/certified Charge this sale, certified: the charge-this-sale dossier plus an Ed25519-signed certified extract of the governing VAT rate (source fingerprint, last confirmed | $0.75 | Base |
| POST | usaref.dev/v1/jobs/hire-compare Hire compare (2 countries): employer cost, employer and employee contributions, on-cost % and wage-floor verdict side by side, ranked, cited. Countries: AE, AU, | $0.75 | Base |
| POST | usaref.dev/v1/jobs/hire-compare/multi Hire compare (3-5 countries): employer cost, contributions, on-cost % and wage-floor verdict side by side, ranked, cited. Countries: AE, AU, CA, DE, ES, GB, IT, | $1.00 | Base |
Latest checks
| When | Endpoint | HTTP | ms | Result |
|---|---|---|---|---|
| 2 days ago | usaref.dev/v1/:country/:series | 403 | 881 | HTTP 403 instead of 402 |
Income on Base (7 days)
This provider's payout address is shared by several providers, so its income is not shown as its own.
Is this your API?
Add the live badge to your docs: 
Claim it for free with
<a href="https://logicnodes.io/observatory/p/usaref.dev"><img src="https://logicnodes.io/observatory/badge/usaref.dev.svg" alt="x402 status"></a>
Claim it for free with
x402_provider_claim (sign with your payout address), and get an alert within minutes when it stops answering with x402_monitor_create ($5 for 30 days). Both work over MCP (https://logicnodes.io/mcp/v2) or POST https://logicnodes.io/v1/tools/<tool>.Income is all USDC received by the provider's payout address on Base, whatever the source. Score: 0-100: 50 x share of checks in the last 72 h that returned valid x402 payment terms + 30 x min(1, log10(1 + USDC received in 7 days) / 4) + 20 x min(1, log10(1 + distinct payers in 7 days) / 3). A provider never checked scores on income only; income is all USDC received by its payout address on Base, whatever the source. JSON: /v1/observatory/providers/usaref.dev