Treasury Data

Fetch current U.S. Treasury yield curve data

GET /api/treasury

Treasury Data

cURL

curl --request GET \
  --url https://api.example.com/api/treasury

200

{
  "yields": {
    "oneMonth": {},
    "threeMonth": {},
    "twoYear": {},
    "tenYear": {}
  },
  "source": "<string>",
  "record_date": "<string>",
  "fetched_at": "<string>",
  "isLive": true,
  "fallback_at": {},
  "fallback_reason": {}
}

Endpoint

GET /api/treasury

Returns the current U.S. Treasury yield curve with yields across multiple maturities. Data is cached for 24 hours and includes fallback mechanisms for when live data is unavailable.

Response

yields · object · required

Treasury yields across different maturities

Show yields properties

oneMonth · number | null

1-month Treasury yield (percentage)

threeMonth · number | null

3-month Treasury yield (percentage)

twoYear · number | null

2-year Treasury yield (percentage)

tenYear · number | null

10-year Treasury yield (percentage)

source · string · required

Data source identifier (typically “US_TREASURY”)

record_date · string · required

ISO 8601 date of the Treasury data observation

fetched_at · string · required

ISO 8601 timestamp when data was retrieved

isLive · boolean · required

Whether data is live (true) or from fallback snapshot (false)

fallback_at · string | null

ISO 8601 timestamp when fallback data was used (null if live)

fallback_reason · string | null

Explanation for why fallback data was used (null if live)

Example Request

curl https://your-domain.com/api/treasury

Example Response

{
  "yields": {
    "oneMonth": 4.25,
    "threeMonth": 4.35,
    "twoYear": 4.15,
    "tenYear": 4.05
  },
  "source": "US_TREASURY",
  "record_date": "2026-03-02",
  "fetched_at": "2026-03-03T10:30:00Z",
  "isLive": true,
  "fallback_at": null,
  "fallback_reason": null
}

Caching Behavior

• Cache Duration: 24 hours (86400 seconds)
• Runtime: Edge
• Revalidation: Dynamic (force-dynamic) to ensure fresh data within cache window

The endpoint uses a snapshot fallback mechanism when live Treasury data is unavailable. The isLive field indicates whether you’re receiving current data or cached fallback values.

Use Cases

• Real-time yield curve monitoring
• Interest rate spread calculations (e.g., 2Y-10Y slope)
• Base rate input for regime classification
• Historical yield tracking and analysis