get_age_of_money

Generado

Generado desde el código con python -m docsgen; una prueba falla si deja de coincidir. Las descripciones vienen del código y se mantienen en inglés: es el idioma en que las leen los agentes.

Qué hace

YNAB’s Age of Money: how old the money spent is today, and its trend month by month.

Use it for “how old is my money?”, “am I living on last month’s income?” or “is my buffer growing?”. The figure is YNAB’s own, in days: how long, on average, money stayed in the budget accounts before being spent, the oldest money spent first. Over 30 days means living on last month’s income. The answer gives each month’s figure up to the current one, the latest, the change and its direction over the period; a month is null when YNAB had not enough history. Relay the notes with the figures. For how long the money would last without income use get_runway. One YNAB request, the list of months; changes nothing.

Comportamiento

Tipo	solo lectura
Confirmación	no
Deshacer	no
Idempotente	sí
Peticiones a YNAB	1 para el ejemplo de abajo, con la caché vacía

Parámetros

Nombre	Tipo	Obligatorio	Por defecto	Descripción
plan_id	string	sí	—	YNAB plan id or ‘last-used’.
months_count	integer	no	12	Months to show, the current one included, 1 to 24 (default 12).

Devuelve

Campo	Tipo	Descripción
message	string	The conclusion in one sentence or two, for the agent to relay.
days	integer | null	The latest Age of Money, in days; null when YNAB gives none.
as_of	string | null	The month of that figure, YYYY-MM: the current one unless YNAB has none for it.
months	array of object	The months up to the current one, oldest first.
months[].month	string	The month, YYYY-MM.
months[].days	integer | null	The age of the money spent, in days; null when YNAB had not enough history.
months[].change	integer | null	Days gained (positive) or lost since the month before; null when either is unknown.
change	integer | null	Days gained (positive) or lost from the first month with a figure to the latest; null with fewer than two figures.
trend	“up” | “down” | “steady” | null	The direction of that change; null with fewer than two figures.
notes	array of string	How YNAB counts, and what is missing, to tell the user.

Ejemplo

Argumentos:

{
  "plan_id": "demo-budget"
}

Respuesta sobre el presupuesto de demostración:

{
  "message": "Your money is 47 days old (2026-09, YNAB's Age of Money): what you spend came in 47 days before, on average. Over 30 days: you are living on last month's income, the buffer YNAB aims for. It went up by 30 days since 2026-07.",
  "days": 47,
  "as_of": "2026-09",
  "months": [
    {
      "month": "2026-06",
      "days": null,
      "change": null
    },
    {
      "month": "2026-07",
      "days": 17,
      "change": null
    },
    {
      "month": "2026-08",
      "days": 48,
      "change": 31
    },
    {
      "month": "2026-09",
      "days": 47,
      "change": -1
    }
  ],
  "change": 30,
  "trend": "up",
  "notes": [
    "Age of Money is YNAB's own figure: for the latest payments out of the budget accounts, how many days passed since that money came in, the oldest money spent first, averaged.",
    "The current month's figure moves with each payment; a past month's is the one YNAB keeps for it.",
    "No figure for 2026-06: YNAB did not have enough history of money in and out yet.",
    "YNAB holds only 4 months up to 2026-09: all are shown."
  ]
}

Errores

Esta herramienta no lanza errores propios; los errores de YNAB llegan como Error calling tool '<tool>': YNAB <status>: <detail>.

Ver también

• Revisar un mes