# US Treasury Total Public Debt Changes Feed

> US Treasury Total Public Debt Changes Feed is a paid API for AI agents from oracles-production.up.railway.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns new US Treasury total public debt data points published since a given timestamp, with value, record date, significance score, and source URL.

## Facts

- Endpoint: GET https://oracles-production.up.railway.app/v1/treasury-debt/changes
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-treasury-total-public-debt-changes-feed-b72a309c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jbXVSLQoJHosyoqDRSPAB

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 us-treasury-total-public-debt-changes-feed-b72a309c
```

Example prompt: Show me all new US Treasury total public debt data points published since 2025-01-01T00:00:00Z, limiting to the 50 most recent and only ones with a significance score of at least 5.

## When to prefer this

Use this endpoint when you need to detect or monitor incremental changes in the US Treasury's reported total public debt, especially when polling for new data since a known timestamp. Prefer this over a snapshot endpoint when building alert systems, change-detection workflows, or time-series ingestion pipelines. The significance filter is useful for suppressing minor revisions and surfacing only material updates.

## Known failure modes

- Invalid 'since' format (not ISO-8601) returns a 400 error
- 'limit' outside 1-500 range returns a validation error
- 'min_significance' outside 1-10 range returns a validation error
- No new data since the given timestamp returns an empty changes array with count 0
- Upstream Treasury data source unavailable may return 503 or stale data
- Missing payment header or insufficient USDC balance returns 402 Payment Required

## How this service works

New US Treasury total US public debt data points published since a timestamp, with the value and record date.

## Output

A JSON object containing a count of matching changes, the data source name, and an array of change records — each with a type, title, summary, detail object, entity ID, source URL for verification, detected-at timestamp, significance score (1-10), and effective date.

## 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": {
      "limit": {
       "type": "integer",
       "maximum": 500,
       "minimum": 1
      },
      "since": {
       "type": "string",
       "format": "date-time",
       "description": "Only changes detected after this ISO-8601 instant"
      },
      "min_significance": {
       "type": "integer",
       "maximum": 10,
       "minimum": 1,
       "description": "Keep only changes scored at least this"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "integer"
      },
      "source": {
       "type": "string"
      },
      "changes": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "type": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "detail": {
          "type": "object"
         },
         "summary": {
          "type": "string"
         },
         "entityId": {
          "type": "string"
         },
         "sourceUrl": {
          "type": [
           "string",
           "null"
          ],
          "description": "Primary-source link for verification"
         },
         "detectedAt": {
          "type": "string",
          "format": "date-time"
         },
         "significance": {
          "type": "integer",
          "maximum": 10,
          "minimum": 1
         },
         "effectiveDate": {
          "type": [
           "string",
           "null"
          ]
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-treasury-total-public-debt-changes-feed-b72a309c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oracles-production.up.railway.app](https://www.zero.xyz/host/oracles-production.up.railway.app/llms.txt)