# P0 Reference Rates API

> P0 Reference Rates API is a paid API for AI agents from x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-19).

Returns official benchmark interest rates (SOFR, ESTR, US Treasury yields, Bank of Canada rates) as published by their source institutions

## Facts

- Endpoint: GET https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/rates/reference?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/p0-reference-rates-api-869a0157
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UmzgFeQVxHbOZ6wGT9T9s

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability p0-reference-rates-api-869a0157
```

Example prompt: What's today's SOFR rate? Pull it from the P0 reference rates service and include the percentile breakdown and volume figures.

## When to prefer this

Choose this endpoint when you need official, source-attributed benchmark interest rates (SOFR, ESTR, US Treasury yields, Bank of Canada rates) with full provenance and legal attribution included in the response. Prefer it over scraped or aggregated rate feeds when compliance, auditability, or official sourcing matters. Particularly useful for financial agents that need machine-readable rate data with percentile statistics and volume for SOFR.

## Known failure modes

- Invalid series name returns an error — must be one of: sofr, estr, ust, boc
- Invalid tenor for UST series (must be one of the enumerated values like 1m, 10y, 30y)
- Invalid item for boc series (must be 'corra' or 'policy')
- Date parameter in wrong format (must be YYYY-MM-DD)
- Date before available historical data returns no result
- Payment failure ($0.002 USDC required per call via x402)
- Source data temporarily unavailable causes stale or missing response

## How this service works

An open index of the machine-to-machine (agent) economy. x402 routes: ranked discovery over a verified x402 seller set (sellers whose 402 P0 read itself plus registry-verified entries), scored by relevance and evidence of a live 402 challenge, with a receipt naming the snapshot hash and scoring revision; demand figures are P0's own on-chain counts of transfers to the sellers' wallets. /economy routes, for Tempo MPP, Virtuals ACP, Olas, Masumi, ERC-8004 agent registries, Solana agent registries, Base agent contracts and MCP servers (Official MCP Registry): each protocol's published figures (agent or server counts, transactions or payment events; payers and USD volume only where the source publishes them: payers for x402 and Tempo MPP, USD volume for x402 and Virtuals ACP), each with its unit, window and source; units differ, so totals are not summed. L402 listings are not covered.

## Output

A JSON object containing the rate value in percent per annum, observation date, series identifier, source name, source URL, legal attribution text, as-of timestamp (when data was read from source), cache status, and for SOFR: percentile breakdown (1st, 25th, 75th, 99th) and volume in billions USD; for UST: full yield curve by tenor; for BOC: subtype (corra or policy).

## Request schema (JSON Schema)

```json
{
 "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",
      "HEAD"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "series"
     ],
     "properties": {
      "date": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "tenor": {
       "enum": [
        "1m",
        "1.5m",
        "2m",
        "3m",
        "4m",
        "6m",
        "1y",
        "2y",
        "3y",
        "5y",
        "7y",
        "10y",
        "20y",
        "30y"
       ],
       "type": "string",
       "default": "10y"
      },
      "series": {
       "enum": [
        "sofr",
        "estr",
        "ust"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "description": "Shortened to fit the header; full example and schema: https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/openapi.json"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-10-22",
  "item": null,
  "name": "Secured Overnight Financing Rate (SOFR)",
  "note": "Official reference data as published by the source, in percent per annum, without any calculation. Not financial advice. With date= the latest observation on or before that date is returned (is_exact_date says if it matches). as_of is when it was read from the source (cached up to 30 min for recent dates).",
  "unit": "percent per annum",
  "as_of": "2026-10-25T09:30:00.000Z",
  "tenor": null,
  "value": 3.9,
  "cached": false,
  "detail": {
   "percentile_1": 3.83,
   "percentile_25": 3.88,
   "percentile_75": 3.95,
   "percentile_99": 3.98,
   "revision_indicator": null,
   "volume_billions_usd": 2945
  },
  "series": "sofr",
  "source": "Federal Reserve Bank of New York",
  "terms_url": "https://www.newyorkfed.org/privacy/termsofuse",
  "source_url": "https://www.newyorkfed.org/markets/reference-rates/sofr",
  "attribution": "Source: Federal Reserve Bank of New York, Secured Overnight Financing Rate (SOFR), https://www.newyorkfed.org/markets/reference-rates/sofr (available without charge at newyorkfed.org). The SOFR is subject to the Terms of Use posted at newyorkfed.org (https://www.newyorkfed.org/privacy/termsofuse). The New York Fed is not responsible for publication of the SOFR by P0 and does not sanction or endorse any particular republication, and has no liability for your use. P0 is not affiliated with the New York Fed; the New York Fed does not sanction, endorse, or recommend any products or services offered by P0. SOFR data are calculated using data provided under a license granted to the New York Fed by DTCC Solutions LLC; DTCC Solutions LLC, its affiliates and data sources have no liability for the content of this material. Values are shown as published, not modified.",
  "is_exact_date": null,
  "requested_date": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/p0-reference-rates-api-869a0157/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev](https://www.zero.xyz/host/x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/llms.txt)
