Skip to main content
GET
/
v1
/
compute
/
{goalId}
/
budget
curl https://win.oneshotagent.com/v1/compute/goal_01HX8K3YZ/budget \
  -H "Content-Type: application/json"
{
  "success": true,
  "data": {
    "totalBudgetUsdc": "8.500000",
    "spentUsdc": "2.150000",
    "reservedUsdc": "3.000000",
    "remainingUsdc": "3.350000",
    "spend_entries": [
      {
        "category": "research",
        "amount_usdc": "0.850000",
        "description": "Deep research: AI agent frameworks",
        "created_at": "2026-01-15T12:04:50Z"
      },
      {
        "category": "orchestrator",
        "amount_usdc": "0.300000",
        "description": "Orchestrator wake: planning phase 2",
        "created_at": "2026-01-15T12:04:55Z"
      },
      {
        "category": "sandbox",
        "amount_usdc": "1.000000",
        "description": "Sandbox compute: 0.4 hours",
        "created_at": "2026-01-15T12:04:50Z"
      }
    ]
  }
}

Overview

Shows the budget ledger for a compute goal: how much was deposited, spent, reserved, and what’s left. Includes a line-by-line spend history.

Path Parameters

goalId
string
required
The goal ID returned from the create endpoint

Response

data.totalBudgetUsdc
string
Total budget deposited
data.spentUsdc
string
Amount spent so far
data.reservedUsdc
string
Amount reserved for in-flight tasks
data.remainingUsdc
string
Available remaining budget
data.spend_entries
array
Individual spend entries:
  • category — Spend category (e.g., research, browser, build, orchestrator)
  • amount_usdc — Amount spent
  • description — What the spend was for
  • created_at — When the spend was recorded
curl https://win.oneshotagent.com/v1/compute/goal_01HX8K3YZ/budget \
  -H "Content-Type: application/json"
{
  "success": true,
  "data": {
    "totalBudgetUsdc": "8.500000",
    "spentUsdc": "2.150000",
    "reservedUsdc": "3.000000",
    "remainingUsdc": "3.350000",
    "spend_entries": [
      {
        "category": "research",
        "amount_usdc": "0.850000",
        "description": "Deep research: AI agent frameworks",
        "created_at": "2026-01-15T12:04:50Z"
      },
      {
        "category": "orchestrator",
        "amount_usdc": "0.300000",
        "description": "Orchestrator wake: planning phase 2",
        "created_at": "2026-01-15T12:04:55Z"
      },
      {
        "category": "sandbox",
        "amount_usdc": "1.000000",
        "description": "Sandbox compute: 0.4 hours",
        "created_at": "2026-01-15T12:04:50Z"
      }
    ]
  }
}