Government reference data series

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "5000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "pathParams": {
          "country": "ca",
          "series": "policy-rate"
        },
        "queryParams": {},
        "type": "http"
      },
      "output": {
        "example": {
          "confidence": "primary",
          "country": "CA",
          "disclaimer": "Independent service, not affiliated with any government. Verify against the cited official source before legal or financial use.",
          "effective_from": "2025-10-29",
          "last_confirmed": "2026-09-03",
          "notes": "The 15 July 2026 release states verbatim: 'The Bank of Canada today held its target for the overnight rate at 2.25%, with the Bank Rate at 2.5% and the deposit rate at 2.20%.' eff…",
          "series": "policy-rate",
          "source": {
            "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…",
            "url": "https://www.bankofcanada.ca/2026/07/fad-press-release-2026-07-15/"
          },
          "stale": false,
          "unit": "percent",
          "value": 2.25
        },
        "type": "json"
      }
    },
    "routeTemplate": "/v1/:country/:series",
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "enum": [
                "GET"
              ],
              "type": "string"
            },
            "pathParams": {
              "properties": {
                "country": {
                  "description": "ISO country code",
                  "enum": [
                    "bs",
                    "ca",
                    "cr",
                    "do",
                    "gt",
                    "hn",
                    "mx",
                    "pa",
                    "sv",
                    "us"
                  ],
                  "type": "string"
                },
                "series": {
                  "description": "Reference series id",
                  "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"
                }
              },
              "required": [
                "country",
                "series"
              ],
              "type": "object"
            },
            "queryParams": {
              "additionalProperties": false,
              "properties": {},
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}

curl "https://usaref.dev/v1/:country/:series"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://usaref.dev/v1/:country/:series");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://usaref.dev/v1/:country/:series")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header