# PreReason US Treasury Holders Full Briefing

> PreReason US Treasury Holders Full Briefing is a paid API for AI agents from api.prereason.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Returns a comprehensive briefing on who holds US Treasuries, including foreign investor net purchases (TIC), primary dealer position changes (NY Fed), speculator futures positions (CFTC), Fed holdings, and key bond market metrics.

## Facts

- Endpoint: GET https://api.prereason.com/api/bonds/full?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/prereason-us-treasury-holders-full-briefing-62a63920
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2XNiXjE8_i4gXuaQJc0q4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability prereason-us-treasury-holders-full-briefing-62a63920
```

Example prompt: Give me the full Treasury holders briefing — foreign investor TIC flows, primary dealer positioning, CFTC speculator futures data, the Fed's own holdings, and the 10-year yield — in markdown format for today.

## When to prefer this

Choose this endpoint when you need a comprehensive, multi-source view of US Treasury ownership — combining TIC, NY Fed primary dealer data, CFTC futures positioning, and Fed holdings in a single call. Prefer this over the short/summary sibling endpoint when you need the full detail including ETF metrics, historical context, next report dates, and all foreign holder breakdowns. Ideal for macro research agents, portfolio analysis workflows, or daily fixed income briefings where completeness matters more than brevity.

## Known failure modes

- Date not on record returns an error or empty dataset — only dates with available data are served
- Invalid date format (not YYYY-MM-DD) returns a validation error
- Invalid format parameter returns a bad request error
- Network or payment failure results in a 402 or connection error
- Data may lag behind real-time due to reporting cadences of source agencies (TIC, NY Fed, CFTC)

## How this service works

Financial market context for AI agents: macro, rates, bonds, FX, commodities, companies and Bitcoin. One API call returns a briefing with the reasoning already in it.

## Output

Returns a structured briefing with: foreign investor net purchases of long-term Treasuries (TIC), primary dealer 13-week change in positions (NY Fed), speculator 10-year note futures positions (CFTC), each benchmarked against historical context; the Fed's own Treasury holdings; debt held by the public; the largest foreign holders; what changed and what would change each metric; next report dates; the 10-year yield; and three bond ETF metrics (TLT, LQD, HYG). Available in token-optimized markdown or structured JSON.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "date": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "description": "Historical date in YYYY-MM-DD format. A paid call serves today or any ?date= on record."
      },
      "format": {
       "enum": [
        "json",
        "markdown"
       ],
       "type": "string",
       "description": "Response format. markdown is token-optimized for LLMs, json is structured. Default is markdown."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "metrics": {
   "etf-hyg": {
    "name": "etf-hyg"
   },
   "etf-lqd": {
    "name": "etf-lqd"
   },
   "etf-tlt": {
    "name": "etf-tlt"
   },
   "treasury-10y": {
    "name": "treasury-10y"
   }
  },
  "briefing_used": "bonds.full",
  "briefing_metadata": {
   "name": "US Treasury Holders",
   "description": "Who holds Treasuries: foreign investors' net purchases (Treasury's TIC), primary dealers' 13 week change in positions (the New York Fed) and speculators' 10 year note futures position (the CFTC), each against its own history; the Fed's own Treasury holdings, debt held by the public and the largest foreign holders; what changed, what would change each label and the next reports; then the 10 year yield and three bond funds.",
   "metrics_count": 4,
   "correlations_count": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/prereason-us-treasury-holders-full-briefing-62a63920/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.prereason.com](https://www.zero.xyz/host/api.prereason.com/llms.txt)