---
title: "Get US treasuries"
method: GET
path: "/v1/assets/fixed_income/us_treasuries"
tags: ["Assets"]
---

# Get US treasuries

`GET /v1/assets/fixed_income/us_treasuries`

## Request

- Base URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets`
- URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets/v1/assets/fixed_income/us_treasuries`
- Auth: HTTP basic

Serves the list of US treasuries available at Alpaca. The response is sorted by ISIN.

## Query parameters

- `subtype` 'bond' | 'bill' | 'note' | 'strips' | 'tips' | 'floating': The subtype of the treasury.
- `bond_status` 'outstanding' | 'matured' | 'pre_issuance': Status of the bond.
- `cusips` string
- `isins` string

## Response `200`

OK

- UsTreasuriesResp
  - `us_treasuries` UsTreasury[], required
    - `bond_status` 'outstanding' | 'matured' | 'pre_issuance', required: Status of the bond.
    - `close_price` number, double: The price of the last transaction of a security before the market closes for normal trading, shown as a percentage of par value
    - `close_price_date` string, date: The date of the close price
    - `close_yield_to_maturity` number, double: Yield to maturity of the treasury after the last close
    - `close_yield_to_worst` number, double: Yield to worst of the treasury after the last close
    - `coupon` number, double, required: The annual interest rate paid on the bond as a percentage of par value
    - `coupon_frequency` 'annual' | 'semi_annual' | 'quarterly' | 'monthly' | 'zero', required: How often the coupon is paid
    - `coupon_type` 'fixed' | 'floating' | 'zero', required: The type of the coupon rate
    - `cusip` string, required: CUSIP is a nine-character alphanumeric code that uniquely identifies the security
    - `description` string, required: Description of the treasury
    - `description_short` string, required: Short description of the treasury
    - `first_coupon_date` string, date: The date of the first coupon payment
    - `fractionable` boolean, required: Whether the treasury can be traded in fractional amounts
    - `isin` string, required: International Securities Identification Number
    - `issue_date` string, date, required: The date on which the bond was issued
    - `last_coupon_date` string, date: The date of the last coupon payment
    - `maturity_date` string, date, required: The date on which the bond matures
    - `next_coupon_date` string, date: The date of the next coupon payment
    - `subtype` 'bond' | 'bill' | 'note' | 'strips' | 'tips' | 'floating', required: The subtype of the treasury.
    - `tradable` boolean, required: Whether the treasury is tradable

## Other responses

- `400`: One of the request parameters is invalid. See the returned message for details.
- `403`: The requested resource is forbidden.
- `429`: Too many requests. You hit the rate limit. Use the X-RateLimit-... response headers to make sure you're under the rate limit.
- `500`: Internal server error. We recommend retrying these later. If the issue persists, please contact us on Slack or on the Community Forum.

---

[API](https://skmtc.dev/alpacahq/apis/broker-api.md) - [All operations](https://skmtc.dev/alpacahq/apis/broker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alpacahq/apis/broker-api/revisions/381b1ecb3ccc?raw)