# USAspending Agency Budget by Toptier Code

> USAspending Agency Budget by Toptier Code is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-15).

Returns budgetary resources (total resources, obligations, and outlays by fiscal year) for a US federal agency identified by its toptier code, sourced from USAspending.gov.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-usaspending-agency-budget
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usaspending-agency-budget-by-toptier-code-a18518ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pNdyxjE5EL69I1PuSxoQ9

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 usaspending-agency-budget-by-toptier-code-a18518ec -d '<json body>'
```

Example prompt: Pull the budgetary resources, obligations, and outlays by fiscal year for the Department of Defense — its toptier code is 097.

## When to prefer this

Choose this endpoint when you need official, structured US federal agency budget data — specifically total resources, obligations, and outlays broken down by fiscal year — keyed by a known toptier agency code. It is keyless (no API key required beyond x402 payment) and directly proxies USAspending.gov data, making it ideal for agents that need authoritative government financial data without managing their own USAspending API integration.

## Known failure modes

- Invalid or unrecognized toptier agency code returns empty or error response
- No data available for very recent or future fiscal years
- Rate limiting or payment failure (x402 payment required at $0.15 USDC per call)
- Malformed request body returns validation error
- USAspending.gov upstream unavailability causes timeout or partial data

## How this service works

Budgetary resources for a US federal agency by toptier code from USAspending.gov: total resources, obligations and outlays by fiscal year. Keyless.

## Output

A structured breakdown of a federal agency's budgetary resources by fiscal year, including total resources available, total obligations incurred, and total outlays made — all keyed to the agency's toptier code as reported on USAspending.gov.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usaspending-agency-budget-by-toptier-code-a18518ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)