Sign in
Fixed Income

Treasury screener

Filter the outstanding marketable Treasury universe for one day by security_type, maturity window, coupon range, yield-to-maturity range, and callable flag; sort and paginate. Omit date for the latest day. The yield filter applies to notes/bonds (rows without a YTM are excluded when a ytm bound is set).

get/api/v2/fixed-income/treasury/screen

Query parameters

datestring nullable
Example:2026-06-26
security_typestring nullable
Example:MARKET BASED NOTE
maturity_minstring nullable

maturity_date >= (YYYY-MM-DD).

Example:2027-01-01

maturity_date >= (YYYY-MM-DD).

maturity_maxstring nullable

maturity_date <= (YYYY-MM-DD).

Example:2030-12-31

maturity_date <= (YYYY-MM-DD).

coupon_minnumber nullable
Example:2
coupon_maxnumber nullable
Example:6
ytm_minnumber nullable
Example:4
ytm_maxnumber nullable
Example:5
callableboolean nullable

true = only callable, false = only non-callable.

true = only callable, false = only non-callable.

sort_bystring

maturity_date | yield_to_maturity | coupon_rate_pct | modified_duration | price.

maturity_date | yield_to_maturity | coupon_rate_pct | modified_duration | price.

descendingboolean
limitinteger
offsetinteger

Response

Securities matching the screen, sorted and paged.

Example response

{
  "data": {
    "date": "2026-06-26",
    "count": 460,
    "securities": [
      {
        "cusip": "912810EX2",
        "price_date": "2026-06-26",
        "security_type": "MARKET BASED BOND",
        "coupon_rate_pct": 6.75,
        "maturity_date": "2040-08-15",
        "bid": 100.2,
        "offer": 100.3,
        "mid": 100.25,
        "eod_price": 100.25,
        "price": 100.25,
        "current_yield": 6.733,
        "yield_to_maturity": 6.71,
        "accrued_interest": 1.42,
        "macaulay_duration": 11.2,
        "modified_duration": 10.8,
        "dv01": 0.108,
        "convexity": 1.6,
        "bond_equivalent_yield": 4.95,
        "discount_yield": 4.8,
        "real_current_yield": 1.2,
        "real_yield_to_maturity": 1.15,
        "bid_offer_spread": 0.1,
        "i_spread_bps": 24.5
      }
    ]
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "data_age_days": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes

Changed in 2 of the 22 revisions of this API.15

  • 328d061c12ca3See the full diff
    • ○

      added the optional property meta/data_age_days to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/notes to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/period to the response with the 200 status

      response-optional-property-added

  • 4c4530760ba112See the full diff
    • ○

      added the optional property code to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property code to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property code to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property hint to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property hint to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property hint to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property plan to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property plan to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property plan to the response with the 503 status

      response-optional-property-added

    • ○

      added the optional property reason to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property reason to the response with the 429 status

      response-optional-property-added

    • ○

      added the optional property reason to the response with the 503 status

      response-optional-property-added