# PreReason Market Context API - Treasuries Endpoint

> PreReason Market Context API - Treasuries Endpoint is a paid API for AI agents from api.prereason.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Returns Bitcoin treasury holdings data including corporate and miner BTC holdings, net changes, and a bullish/bearish market signal.

## Facts

- Endpoint: GET https://api.prereason.com/api/treasuries
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/prereason-market-context-api-treasuries-endpoint-981db798
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tlwAZN2YYkxOoiNBTa5kq

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-market-context-api-treasuries-endpoint-981db798
```

Example prompt: Give me the latest Bitcoin treasury holdings overview — how many companies are holding BTC, total corporate and miner holdings, recent net change, and whether the signal is bullish or bearish right now.

## When to prefer this

Choose this endpoint when you need a consolidated, pre-reasoned Bitcoin treasury snapshot combining corporate holdings, miner holdings, net change trends, and a directional market signal in a single call — ideal for financial agents that need macro Bitcoin context without aggregating multiple data sources themselves.

## Known failure modes

- Payment not provided or invalid x402 payment header — returns 402 Payment Required
- Upstream data source unavailable — may return 503 or stale data
- Malformed request — returns 400 Bad Request
- Rate limiting if too many calls in a short window — returns 429

## How this service works

PreReason delivers market context for financial agents. Bitcoin on-chain metrics, macro indicators, and reasoning context in one API call.

## Output

Returns a JSON object containing a market signal (e.g. 'bullish'), the number of companies holding BTC, total BTC held across treasuries (~997K BTC), a net change figure for a recent period, miner holdings (~280K BTC), and corporate holdings (~717K BTC).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "signal": "bullish",
  "companies": 30,
  "total_btc": "~997K BTC",
  "net_change": "+~93K BTC (May 2025 - Feb 2026)",
  "miner_holdings": "~280K BTC",
  "corporate_holdings": "~717K BTC"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/prereason-market-context-api-treasuries-endpoint-981db798/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)