Agents API

POST /v1/agents/deploy?owner=<wallet>

{
  "agentId": "my-agent",
  "dailyBudget": "25.00",
  "maxPerPayment": "2.00"
}

{
  "agent": {
    "agentId": "my-agent",
    "walletAddress": "8mK...pQ2",
    "createdAt": "2026-04-22T10:00:00Z"
  },
  "mcpConfig": {
    "command": "npx",
    "args": ["-y", "@usefloat/mcp@latest"]
  }
}

GET /v1/agents/:agentId/balance?owner=<wallet>

{
  "agentId": "my-agent",
  "walletAddress": "8mK...pQ2",
  "balance": "18.42",
  "currency": "USDC"
}

GET /v1/agents/:agentId/policy?owner=<wallet>

{
  "agentId": "my-agent",
  "policy": {
    "dailyBudget": "25.00",
    "maxPerPayment": "2.00",
    "cooldownSeconds": 0,
    "allowedServices": []
  }
}

POST /v1/agents/:agentId/policy?owner=<wallet>

{
  "dailyBudget": "50.00",
  "maxPerPayment": "5.00",
  "cooldownSeconds": 60,
  "allowedServices": ["float-image-gen"]
}

POST /v1/agents/:agentId/allocate?owner=<wallet>

{
  "amount": "10.00"
}

POST /v1/agents/:agentId/kill?owner=<wallet>

POST /v1/agents/:agentId/resume?owner=<wallet>

POST /v1/agents/:agentId/rename?owner=<wallet>

{
  "displayName": "Research Bot"
}

GET /v1/agents/:agentId/spend-history?owner=<wallet>&limit=20

{
  "payments": [
    {
      "id": "pay_abc123",
      "service": "Float Image Generation",
      "amount": "0.14",
      "currency": "USDC",
      "status": "confirmed",
      "timestamp": "2026-04-22T10:30:00Z"
    }
  ]
}

POST /v1/link-sessions

{
  "token": "lnk_...",
  "linkUrl": "https://app.usefloat.xyz/link?token=lnk_...",
  "expiresAt": "2026-04-22T10:15:00Z"
}

GET /v1/link-sessions/:token

POST /v1/link-sessions/:token/complete