# US Treasury Yield Curve & Interest Rates

> US Treasury Yield Curve & Interest Rates is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-15).

Returns the Daily Treasury Par Yield Curve fused with average outstanding debt interest rates, including the 2s10s spread and a yield-curve inversion flag, for a given calendar year.

## Facts

- Endpoint: GET https://api.agentstools.dev/treasury/rates
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-treasury-yield-curve-interest-rates-656bf320
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZF54C6UWTEJUyu_7l8gjY

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 us-treasury-yield-curve-interest-rates-656bf320
```

Example prompt: Pull today's US Treasury par yield curve data, including the 2s10s spread and whether the curve is currently inverted.

## When to prefer this

Use this endpoint when you need authoritative US Treasury yield curve data enriched with average outstanding debt rates and pre-computed spread/inversion signals in a single call, especially when building macroeconomic dashboards, recession monitors, or fixed-income analysis tools. Prefer over raw Treasury scraping when you need the 2s10s spread and inversion flag pre-computed and a resilient fallback to average rates.

## Known failure modes

- Requested year is outside the supported range (1990–2100) — 400 error
- Treasury upstream temporarily unreachable — partial response using average debt rates only (degraded mode)
- Year has no data yet (future year) — empty or partial dataset
- x402 payment not included or insufficient — 402 Payment Required

## How this service works

US Treasury interest rates: the Daily Treasury Par Yield Curve fused with the average interest rates on the outstanding debt by security type. Computes the 2s10s spread and an inversion flag. The yield curve is a resilient partial grain that degrades to the average rates if its upstream is unreachable.

## Output

A JSON object containing the Daily Treasury Par Yield Curve rates fused with average interest rates on outstanding US debt by security type, the computed 2s10s spread, and a boolean inversion flag. Falls back gracefully to average debt rates if the par yield curve upstream is unavailable.

## 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",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "year": {
       "type": "integer",
       "maximum": 2100,
       "minimum": 1990,
       "description": "Calendar year of the par yield curve (default current)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-treasury-yield-curve-interest-rates-656bf320/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)