> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nebulaonchain.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# get_treasury_status — View Treasury Balances and APY

> Returns a full treasury snapshot: liquid USDC, Blend pool balance, weighted APY, liquidity threshold, and the timestamp of the last automatic rebalance.

`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

<ResponseField name="liquid_usdc" type="number">
  USDC immediately available for spending, without requiring a Blend withdrawal.
</ResponseField>

<ResponseField name="blend_usdc" type="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`.
</ResponseField>

<ResponseField name="total_usdc" type="number">
  Sum of `liquid_usdc` and `blend_usdc`. Represents the agent's total treasury value.
</ResponseField>

<ResponseField name="apy" type="number">
  Weighted average annualised yield currently being earned on the Blend portion, expressed as a percentage.
</ResponseField>

<ResponseField name="liquidity_threshold" type="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.
</ResponseField>

<ResponseField name="last_rebalance" type="string">
  ISO 8601 timestamp of the most recent automatic treasury rebalance.
</ResponseField>

## 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.

<Tip>
  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.
</Tip>

## Example

**Tool call**

```json get_treasury_status request theme={null}
{
  "tool": "get_treasury_status"
}
```

**Response**

```json get_treasury_status response theme={null}
{
  "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"
}
```