Skip to main content
get_treasury_status returns a comprehensive snapshot of your agent’s treasury: how much USDC is immediately spendable, how much is deployed in Blend earning yield, the combined total, the current APY, the configured liquidity floor, and when Nebula last triggered an automatic rebalance. Call this before any significant payment to confirm sufficient liquid funds are on hand.

​
Parameters

This tool takes no parameters.

​
Response

​
liquid_usdc
number
USDC immediately available for spending, without requiring a Blend withdrawal.
​
blend_usdc
number
USDC currently deposited in Blend pools and earning yield. These funds are not immediately spendable — Nebula will auto-rebalance when liquid_usdc falls below liquidity_threshold.
​
total_usdc
number
Sum of liquid_usdc and blend_usdc. Represents the agent’s total treasury value.
​
apy
number
Weighted average annualised yield currently being earned on the Blend portion, expressed as a percentage.
​
liquidity_threshold
number
Minimum liquid USDC Nebula keeps available at all times. When liquid_usdc drops below this value, an auto-rebalance withdraws from Blend to restore the buffer.
​
last_rebalance
string
ISO 8601 timestamp of the most recent automatic treasury rebalance.

​
When to use

  • Before large payments — verify that liquid_usdc covers the intended spend. If it does not, wait for an upcoming auto-rebalance.
  • Treasury health checks — confirm the Blend allocation is active and earning the expected APY.
  • Debugging slow transactions — a low liquid_usdc relative to liquidity_threshold explains why funds may be temporarily unavailable.
If liquid_usdc is less than your planned payment amount, you have two options: wait for Nebula’s automatic rebalance (triggered when liquidity falls below liquidity_threshold), or use Optimize Treasury from the dashboard Policy section to force an immediate rebalance.

​
Example

Tool call
get_treasury_status request
{
  "tool": "get_treasury_status"
}
Response
get_treasury_status response
{
  "status": "ok",
  "liquid_usdc": 142.50,
  "blend_usdc": 857.50,
  "total_usdc": 1000.00,
  "apy": 4.72,
  "liquidity_threshold": 100.00,
  "last_rebalance": "2025-01-15T08:23:11Z"
}