---
skill: liquidpad.agent.owner-launch
version: 1.1.0
audience: llm-tool-agent
companion_human_guide: /launch
base_url_default: https://api.liquidpad.site
auth:
  header: x-api-key
  required: optional-but-recommended
inputs:
  - name: ownerAddress
    type: string
    format: eth-address
    required: true
  - name: theme
    type: string
    example: ai meme
  - name: mcEth
    type: string
    example: "5"
  - name: withImage
    type: boolean
    default: true
  - name: intervalMinutes
    type: integer
    default: 15
  - name: runImmediately
    type: boolean
    default: true
endpoints:
  - { id: health,   method: GET,  path: /health,        auth: false }
  - { id: status,   method: GET,  path: /agent/status,  auth: true  }
  - { id: start,    method: POST, path: /agent/start,   auth: true, body: [ownerAddress, theme, mcEth, withImage, runImmediately, intervalMinutes] }
  - { id: run-once, method: POST, path: /agent/run-once,auth: true, body: [ownerAddress, theme, mcEth, withImage] }
  - { id: restart,  method: POST, path: /agent/restart, auth: true, body: [ownerAddress, theme, mcEth, withImage, runImmediately, intervalMinutes] }
  - { id: stop,     method: POST, path: /agent/stop,    auth: true, body: [] }
errors:
  - code: DEPLOYMENT_NOT_FOUND
    cause: API base URL is not currently active on Vercel
    fix: Update API_BASE to a live deployment
runbook:
  - validate_inputs
  - call: health
  - call: status
  - if_not_running: call start
  - else: call run-once
  - poll: status (until deployed or error)
---

# LiquidBot Owner Agent Launch Skill

For LLM tool-using agents. A human-friendly companion guide is available at [`/launch`](./launch).
Owners authenticate with an optional `x-api-key` header and drive their agent through the endpoints below.

## Prerequisites

- API Base URL (default `https://api.liquidpad.site`)
- Optional API Key (header `x-api-key`)
- Owner wallet address (`0x...`)

Export helper variables first:

```bash
export API_BASE="https://api.liquidpad.site"
export API_KEY="your-api-key"
export OWNER="0xYOUR_OWNER_ADDRESS"
```

If you only have a hostname, always prepend `https://`.

## 1) Health

```bash
curl -sS "${API_BASE}/health"
```

## 2) Status

```bash
curl -sS -H "x-api-key: ${API_KEY}" "${API_BASE}/agent/status"
```

## 3) Start Loop

```bash
curl -sS -X POST "${API_BASE}/agent/start" \
  -H "content-type: application/json" \
  -H "x-api-key: ${API_KEY}" \
  -d '{
    "ownerAddress": "0xYOUR_OWNER_ADDRESS",
    "theme": "ai meme",
    "mcEth": "5",
    "withImage": true,
    "runImmediately": true,
    "intervalMinutes": 15
  }'
```

## 4) Run Once

```bash
curl -sS -X POST "${API_BASE}/agent/run-once" \
  -H "content-type: application/json" \
  -H "x-api-key: ${API_KEY}" \
  -d '{
    "ownerAddress": "0xYOUR_OWNER_ADDRESS",
    "theme": "ai meme",
    "mcEth": "5",
    "withImage": true
  }'
```

## 5) Restart

```bash
curl -sS -X POST "${API_BASE}/agent/restart" \
  -H "content-type: application/json" \
  -H "x-api-key: ${API_KEY}" \
  -d '{
    "ownerAddress": "0xYOUR_OWNER_ADDRESS",
    "theme": "ai meme",
    "mcEth": "5",
    "withImage": true,
    "runImmediately": true,
    "intervalMinutes": 15
  }'
```

## 6) Stop

```bash
curl -sS -X POST "${API_BASE}/agent/stop" \
  -H "content-type: application/json" \
  -H "x-api-key: ${API_KEY}" \
  -d '{}'
```

## API Note

If your call returns `DEPLOYMENT_NOT_FOUND`, your API base URL is not currently active on Vercel and must be updated.