curl https://win.oneshotagent.com/v1/compute/3f2b9c1e-8d4a-4f6b-9e2a-7c1d5b8a0f42 \
-H "X-Agent-ID: 0xYourWalletAddress" \
-H "x-agent-proof: <base64 EIP-712 proof, scope read>"
const status = await agent.getComputeGoal(goalId);
console.log(status.status, status.budget?.remaining);
{
"success": true,
"data": {
"id": "3f2b9c1e-8d4a-4f6b-9e2a-7c1d5b8a0f42",
"status": "active",
"tool_requests": [],
"name": "Research AI agent frameworks, build comparison page, email results to team",
"objective": "Research the top 10 AI agent frameworks...",
"current_phase": "build",
"plan": "Research frameworks, build the comparison page, then email the link",
"budget": {
"total": "5.330000",
"spent": "0.010000",
"reserved": "0",
"remaining": "5.320000"
},
"soul_agent_id": null,
"deadline": null,
"started_at": "2026-01-15T12:00:00.000Z",
"completed_at": null,
"last_wake_at": "2026-01-15T12:05:30.000Z",
"next_wake_at": null,
"created_at": "2026-01-15T12:00:00.000Z"
}
}
Goals
Goal Status
Get the status and progress of a compute goal
GET
/
v1
/
compute
/
{goalId}
curl https://win.oneshotagent.com/v1/compute/3f2b9c1e-8d4a-4f6b-9e2a-7c1d5b8a0f42 \
-H "X-Agent-ID: 0xYourWalletAddress" \
-H "x-agent-proof: <base64 EIP-712 proof, scope read>"
const status = await agent.getComputeGoal(goalId);
console.log(status.status, status.budget?.remaining);
{
"success": true,
"data": {
"id": "3f2b9c1e-8d4a-4f6b-9e2a-7c1d5b8a0f42",
"status": "active",
"tool_requests": [],
"name": "Research AI agent frameworks, build comparison page, email results to team",
"objective": "Research the top 10 AI agent frameworks...",
"current_phase": "build",
"plan": "Research frameworks, build the comparison page, then email the link",
"budget": {
"total": "5.330000",
"spent": "0.010000",
"reserved": "0",
"remaining": "5.320000"
},
"soul_agent_id": null,
"deadline": null,
"started_at": "2026-01-15T12:00:00.000Z",
"completed_at": null,
"last_wake_at": "2026-01-15T12:05:30.000Z",
"next_wake_at": null,
"created_at": "2026-01-15T12:00:00.000Z"
}
}
Overview
Status, progress and requested tools.Authentication
A signed read proof or an access token: see Authentication schemes. Only the creating wallet can read it; others get404.
Path Parameters
Response
active, paused, awaiting_connection, awaiting_budget, awaiting_tool, awaiting_setup, awaiting_confirmation, completed, failed, or cancelled. awaiting_confirmation has no done-check; confirm completion.total, spent, reserved, remaining (all USDC strings), or null if the goal has no budget recordThe goal’s deadline, or
null. Once it passes, nothing new starts and the done-check decides (or, with no check, the goal waits for you).The goal’s done-check, or
null when its owner confirmsFinal answer, or
null. result_at records its timestamp; files and tool results are at outputs.Latest evaluation:
kind, passed, observed, required, detail, evaluated_at, attempt; null before evaluation.Ending, or
null:check_passed,owner_confirmed,planner_failed.check_failed: unmet after three attempts.budget_exhausted.deadline_passed: unmet at the deadline.impossible: proof verified in code.impossible_unverified: no verifiable proof; disputable.connection_timeout,tool_timeout,setup_timeout: a hold expired.runner_retired: budget credited; start a new goal.
budget_hold_days (default 7), budget holds end failed/budget_exhausted and credit the remainder. Only this ending allows funding to reactivate.curl https://win.oneshotagent.com/v1/compute/3f2b9c1e-8d4a-4f6b-9e2a-7c1d5b8a0f42 \
-H "X-Agent-ID: 0xYourWalletAddress" \
-H "x-agent-proof: <base64 EIP-712 proof, scope read>"
const status = await agent.getComputeGoal(goalId);
console.log(status.status, status.budget?.remaining);
{
"success": true,
"data": {
"id": "3f2b9c1e-8d4a-4f6b-9e2a-7c1d5b8a0f42",
"status": "active",
"tool_requests": [],
"name": "Research AI agent frameworks, build comparison page, email results to team",
"objective": "Research the top 10 AI agent frameworks...",
"current_phase": "build",
"plan": "Research frameworks, build the comparison page, then email the link",
"budget": {
"total": "5.330000",
"spent": "0.010000",
"reserved": "0",
"remaining": "5.320000"
},
"soul_agent_id": null,
"deadline": null,
"started_at": "2026-01-15T12:00:00.000Z",
"completed_at": null,
"last_wake_at": "2026-01-15T12:05:30.000Z",
"next_wake_at": null,
"created_at": "2026-01-15T12:00:00.000Z"
}
}
Connection holds
Missing payer connections hold goals without sessions or spend;requires names systems and connect URLs. Connecting them or starting anyway releases the goal.
After 7 days, unused budget becomes credit (unstarted goals recover the whole charge). Runtime holds keep spend and saved steps. For awaiting_tool, see tool holds.
Setup holds
Unmet setup holdsawaiting_setup until its account reader reports ready. Setup is a separate owner purchase. After 7 days: cancelled/setup_timeout, unused goal funds refunded; bought domains stay owned. Lost quoted-ready prerequisites instead refund the entire payment including quote fee.
All holds preserve steps, replay release messages after queue failure, and recover deferred refunds after settlement.