Autopilot

Delta-neutral autopilot controls. Require Privy JWT and Pro subscription.

Get autopilot status

get

Returns the user's autopilot configuration, USDC balances, open positions, and lifetime statistics.

The agent_approved field indicates whether the user has signed approveAgent on Hyperliquid. Autopilot cannot be enabled without agent approval.

Authorizations

BearerAuth

AuthorizationstringRequired

Privy-issued JWT. Obtain by connecting your wallet at https://app.zirodelta.com.

Responses

200

Autopilot status.

application/json

401

Missing or invalid JWT.

application/json

429

Rate limit exceeded.

application/json

500

Internal server error.

application/json

503

Database unavailable.

application/json

get

/api/autopilot

HTTPcURLJavaScriptPython

GET /api/autopilot HTTP/1.1
Host: api.dex.zirodelta.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "enabled": true,
  "hl_account": "0xAbCdEf1234567890abcdef1234567890AbCdEf12",
  "agent_approved": true,
  "max_usdc": 10000,
  "balance": {
    "perp_withdrawable": 5000,
    "spot_usdc": 2500,
    "total": 7500
  },
  "positions": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "coin": "BTC",
      "size_usd": 5000,
      "spot_px": 95400,
      "spot_sz": 0.05235,
      "perp_px": 95432.1,
      "perp_sz": 0.05235,
      "opened_at": "2025-01-11T08:00:00Z"
    }
  ],
  "stats": {
    "open_count": 2,
    "closed_count": 14
  }
}

Enable or disable autopilot

post

Enables or disables autopilot for the authenticated user. Requires an active Pro subscription and an approved agent wallet.

Authorizations

BearerAuth

AuthorizationstringRequired

Privy-issued JWT. Obtain by connecting your wallet at https://app.zirodelta.com.

Body

application/json

enabledbooleanRequired

Set to true to enable autopilot, false to disable.

Example: true

Responses

200

Autopilot state updated.

application/json

400

Invalid request parameters or body.

application/json

401

Missing or invalid JWT.

application/json

403

Pro subscription required or agent wallet not yet approved.

application/json

429

Rate limit exceeded.

application/json

500

Internal server error.

application/json

post

/api/autopilot/toggle

HTTPcURLJavaScriptPython

POST /api/autopilot/toggle HTTP/1.1
Host: api.dex.zirodelta.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "enabled": true
}

{
  "enabled": true
}

Update autopilot settings

patch

Updates autopilot configuration. Currently supports setting a maximum USDC deployment cap. Set max_usdc to null to remove the cap (no limit).

Authorizations

BearerAuth

AuthorizationstringRequired

Privy-issued JWT. Obtain by connecting your wallet at https://app.zirodelta.com.

Body

application/json

max_usdcnumber · double · nullableOptional

Maximum USDC autopilot is allowed to deploy. Set to null to remove the cap.

Example: 10000

Responses

200

Settings updated.

application/json

400

Invalid request parameters or body.

application/json

401

Missing or invalid JWT.

application/json

429

Rate limit exceeded.

application/json

500

Internal server error.

application/json

patch

/api/autopilot/settings

HTTPcURLJavaScriptPython

PATCH /api/autopilot/settings HTTP/1.1
Host: api.dex.zirodelta.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "max_usdc": 10000
}

{
  "max_usdc": 10000
}