U.S. Treasury Daily Cash Balance (Deposits, Withdrawals and Closing Balance)

{
  "type": "object",
  "required": [
    "limit"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 10000,
      "minimum": 1,
      "description": "Which page of `limit` rows to return, starting at 1. A page past the last one is an error; meta.total-pages says how many there are."
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "How many rows to return, newest business day first, 1 to 1000. From 18 April 2022 each business day has 4 rows, so 4 returns the latest day's full table and 20 covers the last five business days. Earlier days have 2 or 3 rows, so a row count does not convert to a number of days across the whole history."
    },
    "filter": {
      "type": "string",
      "default": "",
      "maxLength": 500,
      "description": "Optional Fiscal Data filter: field:operator:value terms separated by commas, all of which must hold. Fields: record_date (the business day, YYYY-MM-DD), account_type, open_today_bal, open_month_bal and open_fiscal_year_bal. Operators: eq, lt, lte, gt, gte, in (a parenthesised list). Values may contain spaces and parentheses. Examples: account_type:eq:Treasury General Account (TGA) Closing Balance and record_date:gte:2026-10-01. The account_type names are only those four from 18 April 2022 onward (Treasury General Account (TGA) Opening Balance, Total TGA Deposits (Table II), Total TGA Withdrawals (Table II) (-), Treasury General Account (TGA) Closing Balance); earlier days use older names, so filtering on a current one quietly returns only the recent era rather than an error. Leave empty for no filter. A value that matches nothing returns an empty list; an unknown field or operator is a validation error."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "record_date",
          "account_type",
          "open_today_bal",
          "open_month_bal",
          "open_fiscal_year_bal",
          "src_line_nbr"
        ],
        "properties": {
          "table_nbr": {
            "type": "string",
            "description": "Which table of the Daily Treasury Statement the row came from."
          },
          "record_date": {
            "type": "string",
            "description": "The business day the figures are for, YYYY-MM-DD."
          },
          "account_type": {
            "type": "string",
            "description": "Which line this row is. From 18 April 2022 one of four: the Treasury General Account opening balance, total deposits, total withdrawals, or the closing balance; the closing balance is a ROW, not a column. On earlier days these names do not appear and the row is a single daily balance for a named account instead."
          },
          "src_line_nbr": {
            "type": "string",
            "description": "The row's position in the Treasury's own table for that day, as a string; from 18 April 2022, 1 is the opening balance and 4 is the closing balance. It does not mean the same thing on older days, so it is not a way to pull one series across the whole history."
          },
          "open_month_bal": {
            "type": "string",
            "description": "The same line for the calendar month so far, in millions of dollars. What that means depends on the row: on a deposits or withdrawals row it is the month-to-date total, on the opening-balance row it is the balance the month opened at, and on the closing-balance row it is simply that day's closing balance."
          },
          "open_today_bal": {
            "type": "string",
            "description": "The figure for this row on this day, IN MILLIONS OF DOLLARS, as a string: 885823 means about 885.8 billion dollars. On a deposits or withdrawals row it is that day's total, not a balance."
          },
          "open_fiscal_year_bal": {
            "type": "string",
            "description": "The same line for the federal fiscal year so far, which begins on 1 October, in millions of dollars, read the same way as open_month_bal. In October the two are equal because the fiscal year has just begun."
          }
        },
        "additionalProperties": true
      },
      "description": "From 18 April 2022, four rows per business day: opening balance, total deposits, total withdrawals, closing balance. Earlier days carry 2 or 3 rows under older account names. Empty when nothing matches."
    },
    "meta": {
      "type": "object",
      "required": [
        "count",
        "total-count",
        "total-pages"
      ],
      "properties": {
        "count": {
          "type": "integer",
          "description": "How many rows this page holds."
        },
        "labels": {
          "type": "object",
          "description": "Human-readable name of each column."
        },
        "dataTypes": {
          "type": "object",
          "description": "The Treasury's type name for each column."
        },
        "dataFormats": {
          "type": "object",
          "description": "The Treasury's display format for each column; the balance columns report $1,000,000, meaning the figures are in millions of dollars."
        },
        "total-count": {
          "type": "integer",
          "description": "How many rows match the filter in all, across every page."
        },
        "total-pages": {
          "type": "integer",
          "description": "How many pages of `limit` rows the whole match makes."
        }
      },
      "additionalProperties": true
    },
    "links": {
      "type": "object",
      "description": "Treasury's own self, first, prev, next and last page links."
    }
  },
  "description": "The Treasury's response: the cash balance rows, newest business day first, and a meta block with the match count.",
  "additionalProperties": true
}