用途:blockfill 是运行在本机的加密货币智能执行守护进程,面向 Binance Futures(USDT-M)与 OKX Swap 自动执行下单,API 密钥保存在本地、不传第三方服务器,单个守护进程可同时运行两个交易所。
主要能力:内置 maker 与 twap 两种策略。maker 为被动挂单,使用 PostOnly 限价单赚取 maker 返佣,在时间窗末段回退为 IOC 清理未成交部分,为默认策略;twap 为纯 taker,按 TWAP 计划全程使用 IOC 单。支持订单切片与择时,守护进程在 panic 后自动重启执行器,并监管各交易所的 WebSocket 连接。提供 CLI(blockfill 二进制)与 Python SDK(from blockfill import Blockfill)。
使用方式:pip install blockfill 安装,wheel 内已捆绑执行器二进制;仅发布特定平台 wheel(Linux x86_64/aarch64、Apple Silicon、Intel macOS)。基本流程为创建 Blockfill()、调用 set_credentials() 写入 ~/.blockfill/config.toml(权限 0600)并自动执行签名 REST 校验、调用 start() 启动(约 50 秒预热)、再用 place() 下执行单。票据参数含 exchange、symbol、target_position(正为多、负为空)、strategy、time_constraint_ms(默认 300000,范围 10000–86400000)。同一 exchange+symbol 的新票据会自动取代旧的 NEW/OPEN 票据。可调用 check_credentials()、positions()、open_orders()、instruments() 获取诊断信息。位于受限地区时可用 set_proxy() 设置 HTTP CONNECT 代理,设置后守护进程会自动重启;当前 WebSocket 代理尚未支持。
适用场景:需要在本地安全环境以程序化方式执行加密合约下单的脚本与 AI 代理。
限制:符号需按各交易所原生格式书写,不做跨格式转换;仅支持 Binance Futures 与 OKX Swap;CLI 与 Python SDK 之外的接口、费用与价格信息,资料暂未提供。