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"
      }
    ]
  }
}