What is blockfill

blockfill is a local-first smart execution daemon for crypto trading. It runs entirely on your machine — your API keys are stored locally and never transmitted to any third-party server.

Why blockfill:

Secure — API keys stay local, no cloud dependency
Smart execution — built-in maker/TWAP strategies, handles order slicing and timing automatically
Multi-exchange — Binance Futures and OKX Swap from a single daemon
Self-healing — daemon auto-restarts executors on panic; supervises per-exchange WS connections
AI-native — CLI + Python SDK designed for programmatic use by scripts and AI agents

Key concepts:

Ticket: an execution order (exchange + symbol + strategy + target_position + time_constraint_ms)
Daemon: background process that manages exchange WS connections and executes tickets
CLI: blockfill binary — human and agent interface to the daemon
Python SDK: from blockfill import Blockfill — zero-overhead programmatic interface