> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# US Treasury Rates API

> US Treasury rates and debt data by date, from par and real yield curves to bill rates, long-term rates and debt to the penny. Pick the series and date range.

`POST /v1/data/treasury/rates/run`

**Pricing:** $0.0015 per rate ($1.50 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**series** `string` *required*

Series to use.

Allowed values: `parYield` (parYield ,  Daily par yield curve 1M…30Y (+ spreads, inversion)), `realYield` (realYield ,  Daily real (TIPS) yield curve 5Y…30Y), `billRates` (billRates ,  Daily T-bill rates 4-52 weeks (bank discount + coupon equivalent, CUSIP, maturity)), `longTermRates` (longTermRates ,  Daily long-term rates (20Y CMT, average over 10Y, real rate)), `realLongTerm` (realLongTerm ,  Daily real long-term rate average), `avgInterestRates` (avgInterestRates ,  Monthly average interest rate on outstanding Treasury debt by security type (Fiscal Data)), `debtToPenny` (debtToPenny ,  Daily total public debt outstanding (Fiscal Data)).

**startDate** `date`

Start Date as a date (YYYY-MM-DD).

**endDate** `date` (default: today)

End Date as a date (YYYY-MM-DD).

**maxResults** `integer` (default: 100)

How many rates to return in total. Defaults to 100; use 0 for all.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/treasury/rates/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "series": "parYield",
    "startDate": "2026-12-17",
    "endDate": "2026-12-21",
    "maxResults": 5
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/treasury/rates/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "series": "parYield",
    "startDate": "2026-12-17",
    "endDate": "2026-12-21",
    "maxResults": 5
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/treasury/rates/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "series": "parYield",
  "startDate": "2026-12-17",
  "endDate": "2026-12-21",
  "maxResults": 5
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one rate, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `id` | ID | text |
| `series` | Series | text |
| `date` | Date | date |
| `par1Month` | Par 1 Month | number |
| `par6Week` | Par 6 Week | number |
| `par2Month` | Par 2 Month | number |
| `par3Month` | Par 3 Month | number |
| `par4Month` | Par 4 Month | number |
| `par6Month` | Par 6 Month | number |
| `par1Year` | Par 1 Year | number |
| `par2Year` | Par 2 Year | number |
| `par3Year` | Par 3 Year | number |
| `par5Year` | Par 5 Year | number |
| `par7Year` | Par 7 Year | number |
| `par10Year` | Par 10 Year | number |
| `par20Year` | Par 20 Year | number |
| `par30Year` | Par 30 Year | number |
| `real5Year` | Real 5 Year | number |
| `real7Year` | Real 7 Year | number |
| `real10Year` | Real 10 Year | number |
| `real20Year` | Real 20 Year | number |
| `real30Year` | Real 30 Year | number |
| `bill4WeekBankDiscount` | Bill 4 Week Bank Discount | number |
| `bill4WeekCouponEquivalent` | Bill 4 Week Coupon Equivalent | number |
| `bill4WeekMaturity` | Bill 4 Week Maturity | date |
| `bill4WeekCusip` | Bill 4 Week Cusip | text |
| `bill6WeekBankDiscount` | Bill 6 Week Bank Discount | number |
| `bill6WeekCouponEquivalent` | Bill 6 Week Coupon Equivalent | number |
| `bill6WeekMaturity` | Bill 6 Week Maturity | date |
| `bill6WeekCusip` | Bill 6 Week Cusip | text |
| `bill8WeekBankDiscount` | Bill 8 Week Bank Discount | number |
| `bill8WeekCouponEquivalent` | Bill 8 Week Coupon Equivalent | number |
| `bill8WeekMaturity` | Bill 8 Week Maturity | date |
| `bill8WeekCusip` | Bill 8 Week Cusip | text |
| `bill13WeekBankDiscount` | Bill 13 Week Bank Discount | number |
| `bill13WeekCouponEquivalent` | Bill 13 Week Coupon Equivalent | number |
| `bill13WeekMaturity` | Bill 13 Week Maturity | date |
| `bill13WeekCusip` | Bill 13 Week Cusip | text |
| `bill17WeekBankDiscount` | Bill 17 Week Bank Discount | number |
| `bill17WeekCouponEquivalent` | Bill 17 Week Coupon Equivalent | number |
| `bill17WeekMaturity` | Bill 17 Week Maturity | date |
| `bill17WeekCusip` | Bill 17 Week Cusip | text |
| `bill26WeekBankDiscount` | Bill 26 Week Bank Discount | number |
| `bill26WeekCouponEquivalent` | Bill 26 Week Coupon Equivalent | number |
| `bill26WeekMaturity` | Bill 26 Week Maturity | date |
| `bill26WeekCusip` | Bill 26 Week Cusip | text |
| `bill52WeekBankDiscount` | Bill 52 Week Bank Discount | number |
| `bill52WeekCouponEquivalent` | Bill 52 Week Coupon Equivalent | number |
| `bill52WeekMaturity` | Bill 52 Week Maturity | date |
| `bill52WeekCusip` | Bill 52 Week Cusip | text |
| `marketUnavailableReason` | Market Unavailable Reason | text |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "treasury/rates",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "marketUnavailableReason": null,
      "bill6WeekCusip": null,
      "par2Year": 4.56,
      "bill13WeekMaturity": null,
      "par10Year": 4.94,
      "bill13WeekCusip": null,
      "date": "2026-10-30",
      "par3Month": 4.16,
      "bill6WeekCouponEquivalent": null,
      "par4Month": 4.18,
      "bill26WeekCusip": null,
      "real5Year": null,
      "par6Month": 4.25,
      "bill26WeekCouponEquivalent": null,
      "par20Year": 5.34,
      "bill52WeekBankDiscount": null,
      "bill6WeekMaturity": null,
      "bill8WeekBankDiscount": null,
      "par7Year": 4.8,
      "bill17WeekCouponEquivalent": null,
      "par1Year": 4.36,
      "real30Year": null,
      "par2Month": 4.16,
      "id": "parYield:2026-10-30",
      "real10Year": null
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.