# SYNTHORA US Federal Budget Deficit / Surplus (Monthly Treasury Statement)

> SYNTHORA US Federal Budget Deficit / Surplus (Monthly Treasury Statement) is a paid API for AI agents from us-treasury-mts-deficit.hergertsynthora.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Returns monthly US federal receipts, outlays, and deficit/surplus figures sourced from the Monthly Treasury Statement (MTS) via FiscalData.

## Facts

- Endpoint: POST https://us-treasury-mts-deficit.hergertsynthora.com/service
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synthora-us-federal-budget-deficit-surplus-monthly-treasury-statement-7d0e1fdf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PPKM8h79xUDLEVVm_ql6t

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 synthora-us-federal-budget-deficit-surplus-monthly-treasury-statement-7d0e1fdf -d '<json body>'
```

Example prompt: Pull the latest monthly US federal deficit and surplus figures from the Monthly Treasury Statement — give me receipts, outlays, and the net balance for the most recent month available, sorted by date descending.

## When to prefer this

Choose this endpoint when you need structured, paginated, filterable access to official US federal monthly budget data (receipts, outlays, deficit/surplus) without managing a FiscalData API key, especially in autonomous fiscal-analysis pipelines, macro bots, or budget-trajectory models operating in x402 micropayment environments.

## Known failure modes

- Upstream FiscalData API unavailable — result may be empty or stale
- Invalid filter syntax returns error or empty result set
- Page out of range returns empty result
- Missing or malformed parameters may return unfiltered full dataset
- Payment not confirmed — endpoint returns 402 and does not execute

## How this service works

Monthly US federal receipts, outlays and deficit/surplus figures from the Monthly Treasury Statement via FiscalData (keyless JSON). Feeds autonomous fiscal-analysis agents, budget-trajectory models, and agent-to-agent macro bots tracking the US government's monthly cash deficit. First 3 calls FREE per wallet — send header X-WALLET: 0x<addr>. No charge on upstream failure.

## Output

A JSON object with an 'ok' boolean and a 'result' payload containing monthly US federal financial data from the MTS, including receipts, outlays, and deficit/surplus figures for each period, filtered and sorted per query parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "string",
   "description": "page"
  },
  "sort": {
   "type": "string",
   "description": "sort"
  },
  "filter": {
   "type": "string",
   "description": "filter"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "us-treasury-mts-deficit",
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synthora-us-federal-budget-deficit-surplus-monthly-treasury-statement-7d0e1fdf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from us-treasury-mts-deficit.hergertsynthora.com](https://www.zero.xyz/host/us-treasury-mts-deficit.hergertsynthora.com/llms.txt)