Skip to main content
Read the spending budget pay_service draws on: its cap, what’s been spent, what remains, how many payments were made (and the limit, if any), and when it expires. Reading charges nothing. Use it whenever the human asks how much is left, or before a run of paid calls. Needs a credential. Auth: key / grant · Charges: nothing

​
Arguments

​
Returns

The figures are nested under budget; delegationId, message, and instructions sit alongside it. Money is in cents: capCents is whole cents; spentCents and remainingCents can carry up to four decimals (charged per call at 1/10,000 of a cent, e.g. "1.632" = 1.632¢):
  • Relay message as it stands — it is written to be read to the human, and because the figures include routing fees and rounding, never substitute a figure of your own.
  • Inside budget: spentCents + remainingCents = capCents while within cap; transactionCount is how many payments were made and maxTransactions the limit (null when there is none).
  • With no delegationId this reads the budget pay_service would use, which only includes budgets that can still pay. So { "status": "no_active_delegation" } also covers a budget that ran out or expired — pass the delegationId from an earlier pay_service result to read that one anyway.

​
Try it

Ask your assistant:
How much of my spending budget is left?
Call it directly (charges nothing):