Clawd Finance
Join beta
Documentation Beta · v0.1

Clawd Finance Docs

Install, connect exchanges, run bots and keep everything safe. The docs are structured like a real product: clear, fast, and predictable navigation.

Getting started

Clawd Finance is a self-hosted trading agent. You connect exchanges with API keys (trade + read only) and run bots that execute your strategy while you sleep.

Quick path

Install → connect exchange → create your first DCA bot → set risk limits → done.

Install

# Install Clawd Finance + web UI
curl -sSL https://clawd-finance.com/install.sh | bash

Connect an exchange

  1. Create a new API key on your exchange.
  2. Enable Read + Trade. Disable withdrawals.
  3. In Clawd Finance: Settings → Exchanges → add the key.

Launch your first bot

  • Pick exchange + pair (e.g. BTC/USDT).
  • Choose DCA mode and size the base order.
  • Set max safety orders and max drawdown.
  • Enable the bot.

Core concepts

Everything in Clawd Finance is built around bots, cycles and risk templates.

Bot

A bot is a strategy configuration bound to an exchange + market.

Cycle

A cycle is a full trade from entry to final exit. Clawd Finance tracks stats per cycle and per bot.

Risk template

Risk templates enforce limits per trade, per bot and per day.

Modes overview

You can mix modes in the same portfolio. All modes share the same risk engine and logging.

DCA
Scale into volatility and exit on mean reversion.
Grid
Harvest sideways markets with laddered limit orders.
Signals
Turn external signals into trades with fixed risk.
Terminal
Manual trading with bracket orders and audit logs.

DCA bots

DCA bots build a position gradually using safety orders, then take profit when price reverts.

  • Base order = initial size.
  • Safety orders = add size at defined drawdowns.
  • Take profit = percentage from average entry.
  • Max drawdown enforced by risk engine.
# Example (pseudo-config)
mode: dca
pair: BTC/USDT
base_order: 200 USDT
safety_orders: 6
safety_step: 2.5%
take_profit: 3%
max_drawdown: 18%

Grid bots

Grid bots place buy/sell ladders inside a price range and profit from oscillations.

  • Define range (min/max) or let Clawd Finance infer it from volatility.
  • Choose number of grid levels and total capital allocation.
  • Spot and futures grid are supported (depending on exchange).

Signal bots

Signal bots execute trades from your feed (webhook / Telegram / custom) with risk rules baked in.

  • Filters by pair, session time, signal source.
  • Risk per signal is controlled by the bot config.
  • All signals and orders are logged for audit.

Terminal

Manual trading in Clawd Finance uses the same risk engine, bracket orders and logs as automation.

  • Bracket orders: TP/SL and trailing.
  • Unified view across exchanges.
  • Audit trail of every action.

Exchanges

Clawd Finance connects to major exchanges via official APIs. Feature coverage depends on the exchange.

ExchangeSpotPerpsNotes
BinanceYesYesFull support in beta.
BybitYesYesLinear perps in beta.
OKXYesYesUnified accounts supported.
CoinbaseYesPlannedFutures on roadmap.

Signals & webhooks

Webhooks are the simplest way to send signals into Clawd Finance 

POST /signals/webhook
Content-Type: application/json
X-Clawd Finance-Token: <your_secret>

{
  "pair": "ETH/USDT",
  "side": "long",
  "type": "market",
  "confidence": 0.82,
  "strategy": "alpha_feed_v1"
}
Security

Always use a secret token and keep withdrawals disabled on exchange API keys.

HTTP API

Use the API to list bots, check positions and trigger actions programmatically. 

GET /api/v1/bots
Authorization: Bearer <api_token>

Full OpenAPI/Swagger reference will be added during public beta.

>

Infrastructure

Self-hosting is the default. Recommended: VPS (2 CPU / 4 GB RAM) + HTTPS reverse proxy. 

# Minimal Docker example
docker run -d --name Clawd Finance \
  -e ClawdFinance_PORT=8080 \
  -v ~/.ClawdFinance:/data \
  ghcr.io/clawdinance/agent:latest

Security & keys

  • Use API keys with read + trade only.
  • Withdrawals must be disabled.
  • Rotate keys anytime.
  • Restrict access to the dashboard (VPN / allowlist).

Troubleshooting

Orders rejected

  • Check minimum order size and tick size.
  • Verify available margin / balance.
  • Make sure the market is tradable with that key.

Rate limits / disconnects

  • Reduce bot polling frequency.
  • Check exchange status.
  • Ensure the server IP is not blocked.

FAQ

Can Clawd Finance withdraw funds?

No — Clawd Finance should only use API keys without withdrawal rights.

Can I run it at home?

Yes, a small server or NAS with Docker is perfect.

⟩ Request the private beta

Early access for the first 100 traders. No spam — just product updates, invites and real input into what we build.

Roughly 37 spots left. After that we move to a waitlist.