Get Budget

# x-agent-proof is an EIP-712 signature by the X-Agent-ID wallet —
# the SDKs produce it for you; see /sdk/overview#read-authentication
curl "https://win.oneshotagent.com/v1/agents/me/budgets" \
  -H "X-Agent-ID: 0xYourWalletAddress" \
  -H "x-agent-proof: <base64 signed proof, scope=read>"

const status = await agent.budgets();
console.log(`${status.spent_today_usdc} of ${status.daily_usdc} spent, resets ${status.resets_at}`);

status = client.get_budgets()
print(f"{status['spent_today_usdc']} of {status['daily_usdc']} spent")

{
  "success": true,
  "data": {
    "daily_usdc": 50,
    "per_transaction_usdc": 5,
    "alert_at": 0.8,
    "pause_at": 1,
    "spent_today_usdc": "41.200000",
    "remaining_usdc": "8.800000",
    "pct_used": 0.824,
    "resets_at": "2026-08-24T00:00:00.000Z"
  }
}

GET

agents

budgets

# x-agent-proof is an EIP-712 signature by the X-Agent-ID wallet —
# the SDKs produce it for you; see /sdk/overview#read-authentication
curl "https://win.oneshotagent.com/v1/agents/me/budgets" \
  -H "X-Agent-ID: 0xYourWalletAddress" \
  -H "x-agent-proof: <base64 signed proof, scope=read>"

const status = await agent.budgets();
console.log(`${status.spent_today_usdc} of ${status.daily_usdc} spent, resets ${status.resets_at}`);

status = client.get_budgets()
print(f"{status['spent_today_usdc']} of {status['daily_usdc']} spent")

{
  "success": true,
  "data": {
    "daily_usdc": 50,
    "per_transaction_usdc": 5,
    "alert_at": 0.8,
    "pause_at": 1,
    "spent_today_usdc": "41.200000",
    "remaining_usdc": "8.800000",
    "pct_used": 0.824,
    "resets_at": "2026-08-24T00:00:00.000Z"
  }
}

Returns the configured caps plus what has been spent so far today. Spend is wallet outflow: gross receipt totals net of any credits applied, with failed settlements excluded. spent_today_usdc is reported even for agents with no budget, so a dashboard can show utilization either way.

Authentication

X-Agent-ID plus a signed x-agent-proof with scope: "read" — required, not log-only. See Spend Budgets.

# x-agent-proof is an EIP-712 signature by the X-Agent-ID wallet —
# the SDKs produce it for you; see /sdk/overview#read-authentication
curl "https://win.oneshotagent.com/v1/agents/me/budgets" \
  -H "X-Agent-ID: 0xYourWalletAddress" \
  -H "x-agent-proof: <base64 signed proof, scope=read>"

const status = await agent.budgets();
console.log(`${status.spent_today_usdc} of ${status.daily_usdc} spent, resets ${status.resets_at}`);

status = client.get_budgets()
print(f"{status['spent_today_usdc']} of {status['daily_usdc']} spent")

{
  "success": true,
  "data": {
    "daily_usdc": 50,
    "per_transaction_usdc": 5,
    "alert_at": 0.8,
    "pause_at": 1,
    "spent_today_usdc": "41.200000",
    "remaining_usdc": "8.800000",
    "pct_used": 0.824,
    "resets_at": "2026-08-24T00:00:00.000Z"
  }
}

Response

number | null

Daily cap in USDC. null = unlimited.

number | null

Per-call cap in USDC. null = unlimited.

number | null

Fraction of daily_usdc that triggers a budget_warning.

number | null

Fraction of daily_usdc at which paid calls are rejected.

string

Wallet outflow so far this UTC day.

string | null

daily_usdc × pause_at − spent. null when there is no daily cap.

number | null

spent / daily_usdc. null when there is no daily cap.

string

ISO timestamp of the next UTC midnight, when the daily window resets.

Overview

Email

Email Inbox

Voice

SMS

Commerce

Enrichment

Verification

Research

Build

Notifications

Budgets

Receipts & Analytics

Other

Compute

Browser

Authentication

Response

​Authentication

​Response

Authentication

Response