# US Treasury — Zapi reference

> Kurva imbal hasil Treasury Amerika, harian, seluruh tenor dari 1 bulan sampai 30 tahun.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/us-treasury
- Endpoint catalog: https://zpi.web.id/category/finance
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## US Treasury

**Category:** finance · **Slug:** `us-treasury`
**Detail page:** https://zpi.web.id/api/finance/us-treasury

Kurva imbal hasil Treasury Amerika, harian, seluruh tenor dari 1 bulan sampai 30 tahun.

**Tags:** treasury, yield, bond, macro, finance

### Yield Curve

Imbal hasil per tenor per hari bursa, terbaru dulu. Kolom dibaca lewat nama header, bukan posisi.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:us-treasury/yield-curve`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `year` | number | query | no | Calendar year. Defaults to the current year. |
| `length` | number | query | no | Trading days to return, newest first (default 10) |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:us-treasury/yield-curve?year=2026&length=10" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:us-treasury/yield-curve?year=2026&length=10", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:us-treasury/yield-curve?year=2026&length=10",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "unit": "percent",
  "year": 2026,
  "count": 8,
  "items": [
    {
      "date": "2026-08-07",
      "rates": {
        "1 Mo": 3.79,
        "1 Yr": 4.01,
        "2 Mo": 3.83,
        "2 Yr": 4.19,
        "3 Mo": 3.87,
        "3 Yr": 4.25,
        "4 Mo": 3.89,
        "5 Yr": 4.35,
        "6 Mo": 3.96,
        "7 Yr": 4.49,
        "10 Yr": 4.65,
        "20 Yr": 5.2,
        "30 Yr": 5.19,
        "1.5 Month": 3.79
      }
    },
    {
      "date": "2026-08-06",
      "rates": {
        "1 Mo": 3.8,
        "1 Yr": 4.06,
        "2 Mo": 3.84,
        "2 Yr": 4.25,
        "3 Mo": 3.9,
        "3 Yr": 4.31,
        "4 Mo": 3.92,
        "5 Yr": 4.4,
        "6 Mo": 3.99,
        "7 Yr": 4.53,
        "10 Yr": 4.69,
        "20 Yr": 5.22,
        "30 Yr": 5.22,
        "1.5 Month": 3.8
      }
    },
    {
      "date": "2026-08-05",
      "rates": {
        "1 Mo": 3.77,
        "1 Yr": 4.03,
        "2 Mo": 3.84,
        "2 Yr": 4.18,
        "3 Mo": 3.89,
        "3 Yr": 4.24,
        "4 Mo": 3.91,
        "5 Yr": 4.33,
        "6 Mo": 3.98,
        "7 Yr": 4.47,
        "10 Yr": 4.63,
        "20 Yr": 5.18,
        "30 Yr": 5.17,
        "1.5 Month": 3.79
      }
    },
    {
      "date": "2026-08-04",
      "rates": {
        "1 Mo": 3.78,
        "1 Yr": 4.04,
        "2 Mo": 3.85,
        "2 Yr": 4.2,
        "3 Mo": 3.89,
        "3 Yr": 4.25,
        "4 Mo": 3.91,
        "5 Yr": 4.33,
        "6 Mo": 4,
        "7 Yr": 4.47,
        "10 Yr": 4.63,
        "20 Yr": 5.18,
        "30 Yr": 5.18,
        "1.5 Month": 3.8
      }
    },
    {
      "date": "2026-08-03",
      "rates": {
        "1 Mo": 3.79,
        "1 Yr": 4.07,
        "2 Mo": 3.87,
        "2 Yr": 4.25,
        "3 Mo": 3.91,
        "3 Yr": 4.32,
        "4 Mo": 3.94,
        "5 Yr": 4.4,
        "6 Mo": 4.02,
        "7 Yr": 4.54,
        "10 Yr": 4.7,
        "20 Yr": 5.23,
        "30 Yr": 5.23,
        "1.5 Month": 3.82
      }
    },
    {
      "date": "2026-07-31",
      "rates": {
        "1 Mo": 3.78,
        "1 Yr": 4.08,
        "2 Mo": 3.85,
        "2 Yr": 4.28,
        "3 Mo": 3.83,
        "3 Yr": 4.34,
        "4 Mo": 3.92,
        "5 Yr": 4.45,
        "6 Mo": 3.98,
        "7 Yr": 4.59,
        "10 Yr": 4.75,
        "20 Yr": 5.28,
        "30 Yr": 5.27,
        "1.5 Month": 3.8
      }
    },
    {
      "date": "2026-07-30",
      "rates": {
        "1 Mo": 3.79,
        "1 Yr": 4.04,
        "2 Mo": 3.84,
        "2 Yr": 4.23,
        "3 Mo": 3.82,
        "3 Yr": 4.3,
        "4 Mo": 3.92,
        "5 Yr": 4.38,
        "6 Mo": 3.98,
        "7 Yr": 4.52,
        "10 Yr": 4.68,
        "20 Yr": 5.22,
        "30 Yr": 5.21,
        "1.5 Month": 3.8
      }
    },
    {
      "date": "2026-07-29",
      "rates": {
        "1 Mo": 3.73,
        "1 Yr": 4.04,
        "2 Mo": 3.83,
        "2 Yr": 4.22,
        "3 Mo": 3.83,
        "3 Yr": 4.29,
        "4 Mo": 3.91,
        "5 Yr": 4.37,
        "6 Mo": 3.97,
        "7 Yr": 4.51,
        "10 Yr": 4.67,
        "20 Yr": 5.21,
        "30 Yr": 5.2,
        "1.5 Month": 3.8
      }
    }
  ],
  "total": 151,
  "source": "us-treasury",
  "tenors": [
    "1 Mo",
    "1.5 Month",
    "2 Mo",
    "3 Mo",
    "4 Mo",
    "6 Mo",
    "1 Yr",
    "2 Yr"
  ]
}
```

---


_Generated: 2026-08-08T12:07:37.719Z_