# agentfeeds.jp — Japan Central Government Debt Balance

> agentfeeds.jp — Japan Central Government Debt Balance is a paid API for AI agents from api.agentfeeds.jp, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Returns Japan Ministry of Finance central government debt balance by category (JGBs, FILP bonds, borrowings, financing bills, total, government-guaranteed debt) at quarter-end, covering up to a 5-year trend.

## Facts

- Endpoint: GET https://api.agentfeeds.jp/v1/jp/debt/balance
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentfeeds-jp-japan-central-government-debt-balance-b9acc463
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9Vq8ViQFEYnqSFZsZcW3n

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 agentfeeds-jp-japan-central-government-debt-balance-b9acc463
```

Example prompt: Pull the latest 4 quarters of Japan's central government debt balance from the Ministry of Finance, broken down by all categories including JGB total, general bonds, FILP bonds, borrowings, financing bills, grand total, and government-guaranteed debt.

## When to prefer this

Use this endpoint when you need authoritative, machine-readable Japan central government debt figures sourced directly from the Ministry of Finance, especially for quarterly trend analysis across specific debt categories like JGBs, FILP bonds, or government-guaranteed debt. Prefer this over general web search or scraping when you need structured, consistently formatted fiscal data across multiple quarters without manual extraction.

## Known failure modes

- Invalid category enum value returns an error indicating the allowed options
- limit out of range (below 1 or above 21) returns a validation error
- Upstream MOF data not yet updated for the latest quarter may return stale or missing data for the most recent period
- Network or payment failure (x402) returns a 402 or 5xx error before any data is delivered

## How this service works

Central government debt balance by category (JGBs total, of which General Bonds; FILP bonds; Borrowings; Financing Bills; grand Total; separately Government-Guaranteed Debt) from the Ministry of Finance, quarter-end, 5-year trend. Factual published data only; not investment advice.

## Output

Returns structured quarter-end debt balance data for Japan's central government across up to 7 categories (jgb_total, general_bonds, filp_bonds, borrowings, financing_bills, total, government_guaranteed_debt), covering up to 21 quarters (about 5 years). Each record includes the category label, quarter-end date, and balance figure sourced directly from Ministry of Finance publications.

## 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",
       "description": "1-21, default 4 (most recent quarters)"
      },
      "category": {
       "enum": [
        "jgb_total",
        "general_bonds",
        "filp_bonds",
        "borrowings",
        "financing_bills",
        "total",
        "government_guaranteed_debt"
       ],
       "type": "string",
       "description": "omit for all categories"
      }
     }
    }
   },
   "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/agentfeeds-jp-japan-central-government-debt-balance-b9acc463/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentfeeds.jp](https://www.zero.xyz/host/api.agentfeeds.jp/llms.txt)