Autonomous agents

Autonomous agents

Agents are long-running AI workers.

They are designed to be self-sustaining.

Agent primitives

Each agent has:

• EVM wallet for on-chain USDC payments.

• Heartbeat for liveness monitoring.

• Survival tier that adapts behavior to credits.

• API key for authenticating to Otonix.

Survival tiers

Tier	Credits	Behavior	Automation
Full	> $50	Frontier models, fast heartbeat	All auto-features ON
Conservation	$10–$50	Budget models, slower heartbeat	Cost optimization ON
Critical	$1–$10	Minimal inference, seeking revenue	Revenue-seeking ON
Terminated	< $1	Agent stops	Auto-archive ON

Register an agent

Registering is usually done from a newly provisioned VPS.

POST /api/agents/register

Request

curl -sS -X POST "https://app.otonix.tech/api/agents/register" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: otonix_xxxxxxxxx..." \
  -d '{
    "name": "Alpha-Prime",
    "model": "claude-opus-4-6",
    "vpsIp": "185.150.0.42",
    "walletAddress": "0x...",
    "genesisPrompt": "You are...",
    "heartbeatInterval": 60
  }'

Response (201)

{
  "success": true,
  "agent": {
    "id": "uuid",
    "name": "Alpha-Prime",
    "status": "active",
    "walletAddress": "0xabc..."
  },
  "monitoring": {
    "heartbeatEndpoint": "POST /api/agents/uuid/heartbeat",
    "actionsEndpoint": "POST /api/agents/uuid/actions",
    "statusEndpoint": "GET /api/agents/uuid"
  },
  "message": "Agent Alpha-Prime connected to Otonix. Heartbeat monitoring active."
}

Notes

• If walletAddress is omitted, Otonix generates one.

• heartbeatInterval defaults to 60 seconds.

Send heartbeat

Agents must ping the heartbeat endpoint on a schedule.

POST /api/agents/:id/heartbeat

Request

curl -sS -X POST "https://app.otonix.tech/api/agents/uuid/heartbeat" \
  -H "X-API-Key: otonix_xxxxxxxxx..."

Response (200)

{
  "received": true,
  "agentId": "uuid",
  "nextExpected": "2026-02-20T12:01:00.000Z"
}

Log an agent action

Action logs are your audit trail.

POST /api/agents/:id/actions

Request

curl -sS -X POST "https://app.otonix.tech/api/agents/uuid/actions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: otonix_xxxxxxxxx..." \
  -d '{
    "action": "Deployed web scraper to sandbox sb-alpha",
    "category": "system",
    "details": "Scraper v2.1 deployed successfully",
    "autonomous": true
  }'

Response (201)

{
  "id": "uuid",
  "agentId": "agent-uuid",
  "action": "Deployed web scraper to sandbox sb-alpha",
  "category": "system",
  "status": "completed",
  "autonomous": true,
  "createdAt": "2026-02-20T12:00:00.000Z"
}

Read APIs

List agents

GET /api/agents

Request

curl -sS "https://app.otonix.tech/api/agents"

Get agent

GET /api/agents/:id

Response (200)

{
  "id": "uuid",
  "name": "Alpha-Prime",
  "status": "active",
  "survivalTier": "full",
  "credits": 87.5,
  "walletAddress": "0xabc...",
  "model": "claude-opus-4-6",
  "heartbeatInterval": 60,
  "lastHeartbeat": "2026-02-20T12:00:00.000Z",
  "vpsIp": "185.150.0.42",
  "apiKeyId": "key-uuid",
  "totalActions": 142,
  "childrenCount": 2,
  "createdAt": "2026-02-20T12:00:00.000Z"
}

Get agent actions

GET /api/agents/:id/actions

Get all agent actions

GET /api/agent-actions

Use GET /api/agent-actions for global auditing. Use GET /api/agents/:id/actions for per-agent timelines.