Skip to main content
get_policy_status returns a complete snapshot of the spending policy currently governing your agent’s wallet. This includes the micro-payment auto-approve threshold, per-transaction and daily USDC caps, how much has already been spent today, the full whitelist and denylist, and whether all spending is currently paused. Agents can read this policy at any time to understand what transactions will auto-approve, which destinations require human confirmation, and what limits apply. Agents cannot modify the policy — to change limits or lists, use the Policy section of the Nebula dashboard.

​
Parameters

This tool takes no parameters.

​
Response

​
paused
boolean
When true, all outgoing spend is blocked regardless of amount or destination. Transactions return policy_paused. Only a dashboard action can unpause.
​
micro_threshold
number
Transactions at or below this USDC amount are automatically approved without human confirmation (unless the destination is on the denylist). Useful for sub-cent micropayments such as x402 API calls.
​
per_tx_cap
number
Maximum USDC allowed in a single transaction. Transactions above this limit are rejected outright — even with human confirmation they cannot proceed.
​
daily_cap
number
Maximum USDC the agent may spend across all transactions in a rolling 24-hour window. Once reached, further spend is rejected until the window resets.
​
daily_spent_usdc
number
Amount already spent in the current 24-hour window. Compare to daily_cap to determine remaining daily budget.
​
whitelist
array
Array of Stellar addresses that are treated as trusted destinations. Transfers to whitelisted addresses auto-approve as long as the amount does not exceed per_tx_cap.
​
denylist
array
Array of Stellar addresses that are permanently blocked. Any transfer to a denylisted address is rejected immediately, regardless of amount or whitelist status.

​
Confirmation rules at a glance

The policy engine evaluates each outgoing transaction in this order:
  1. Paused → reject
  2. Destination on denylist → reject
  3. Daily total would exceed daily_cap → reject
  4. Amount > per_tx_cap → reject
  5. Amount ≤ micro_threshold → auto-approve
  6. Destination on whitelist → auto-approve
  7. New destination → confirmation_required (human must approve via dashboard)
Agents can read this policy but cannot mutate it. To update caps, pause spending, or edit the whitelist and denylist, open the Policy section in your Nebula dashboard.

​
Example

Tool call
get_policy_status request
{
  "tool": "get_policy_status"
}
Response
get_policy_status response
{
  "status": "ok",
  "paused": false,
  "micro_threshold": 0.10,
  "per_tx_cap": 50.00,
  "daily_cap": 200.00,
  "daily_spent_usdc": 25.51,
  "whitelist": [
    "GBXYZ1234567890ABCDEF1234567890ABCDEF1234567890ABCDE",
    "GABC9876543210FEDCBA9876543210FEDCBA9876543210FEDCB"
  ],
  "denylist": [
    "GDENY000000000000000000000000000000000000000000000A"
  ]
}