blockfill-agent-execution

What is BlockFill Agent Execution

BlockFill Agent Execution is an AI-agent-ready Python SDK and local execution engine for crypto perpetual futures order execution. It enables AI agents, trading systems, and developers to execute large crypto perpetual futures orders through TWAP and maker-style strategies on Binance Futures and OKX Swap, while keeping exchange API keys on the user's own machine.

You declare a target position; BlockFill works the order over a time window using maker (PostOnly resting + IOC fallback) or twap (taker-sliced) strategies, cutting execution slippage vs. naïve market orders. One Python API, one local daemon, two exchanges supported today — one bf.place(...) call per target position.

Why BlockFill Agent Execution:

• Self-custodial by design — exchange API keys stay on your machine (~/.blockfill/config.toml, chmod 0600). The local daemon signs orders locally and sends them directly to the exchange — no key custody, no order routing, no order-flow visibility by a third party.
• Designed for AI agents — built to be called by AI agents, trading copilots, MCP servers, and strategy systems. The agent decides the trading intent; BlockFill is the execution layer that turns it into placed orders.
• Smart execution — built-in maker/twap strategies handle order slicing and timing automatically, cutting execution slippage vs. naïve market orders.
• Multi-exchange — Binance Futures and OKX Swap from a single daemon.
• One simple API — from blockfill import Blockfill, then one bf.place(...) call per target position to place, query, and cancel execution tickets.

Key concepts:

• Ticket: an execution order (exchange + symbol + strategy + target_position + time_constraint_ms)
• Daemon: local background process that signs and places orders through your own exchange API keys, and supervises per-exchange connections
• Python SDK: from blockfill import Blockfill — programmatic interface for AI agents and scripts