Get X402 Account Status
x402_get_accountRead current prepaid USD balance, key role (master vs delegate), emergency freeze status, active delegated subagent keys, pending escalation approvals, and recent spend orders. Use this for live operational status checks and to locate delegate_id (sbd_*) or pending approval_id (sba_*) records; do not use this for double-entry financial reconciliation or date-range exports (use x402_export_statement) or per-call policy preflight (use x402_quote_plan). Free and read-only; requires a valid master or delegated sbk_* spend key (returns HTTP 401 if missing, invalid, or revoked; 120 req/min/IP limit).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "x402_get_account"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| spend_key | No | Stripe-funded master or delegated subagent spend key (format: sbk_<43+ chars>). Optional when the caller supplies the x-atlas-spend-key HTTP header. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | True when the account snapshot succeeded. | |
| frozen | No | True when the emergency freeze kill switch is currently halting all spends. | |
| key_role | No | Authority tier of the supplied spend key. | |
| account_id | No | Account identifier (format: sbc_<24 hex chars>). | |
| balance_usd | No | Available prepaid USD balance (e.g. "24.95"). | |
| delegates_active | No | Count of non-revoked delegated subagent keys. | |
| pending_approvals | No | Count of pending single-use escalation tickets awaiting operator decision. |