get_age_of_money

Généré

Généré depuis le code par python -m docsgen ; un test échoue s’il ne correspond plus. Les descriptions viennent du code et restent en anglais : c’est la langue dans laquelle les agents les lisent.

Rôle

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.

Comportement

Nature	lecture seule
Confirmation	non
Annulation	non
Idempotent	oui
Requêtes YNAB	1 pour l’exemple ci-dessous, cache vide

Paramètres

Nom	Type	Obligatoire	Défaut	Description
plan_id	string	oui	—	YNAB plan id or ‘last-used’.
months_count	integer	non	12	Months to show, the current one included, 1 to 24 (default 12).

Retour

Champ	Type	Description
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.

Exemple

Arguments :

{
  "plan_id": "demo-budget"
}

Réponse sur le budget de démonstration :

{
  "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."
  ]
}

Erreurs

Cet outil ne lève pas d’erreur propre ; les erreurs de YNAB reviennent sous la forme Error calling tool '<tool>': YNAB <status>: <detail>.

Voir aussi

• Faire le point sur un mois