Back to z4p

Documentation

Quickstart — z4p

z4p is a single binary. Start in observe mode before you ever give it keys.

1. Install

curl -fsSL https://raw.githubusercontent.com/zapmarkets/z4p/main/install.sh | sh
z4p doctor

2. Start the Gateway (Vault UI + API)

z4p gateway

Open http://localhost:8790/vault in your browser.

3. Create your first scoped bot

z4p bot setup \
  --agent trader1 \
  --name jup_sol_bot \
  --strategy "Watch SOL/USDC on Jupiter and only act on strong signals." \
  --loop price_watcher

This writes to the agent's vault bible and registers a bot-scoped loop.

4. Tick in dry-run

z4p agent-tick --agent trader1 --dry-run

Review the proposals it would have made.

5. Approve and execute (when ready)

  • Set up a wallet + policy for the bot
  • Run ticks that produce proposed trades
  • Use z4p trade:approve or the Vault UI to approve
  • Only then does real execution happen

See the z4p repo for full CLI reference and architecture.