SuperAPI AI 工具集

blockfill-agent-execution

智能体与模型

查看项目

更新于 10-16 01:13

技能介绍

用途:BlockFill Agent Execution 是加密货币订单执行的 AI 智能体技能,完全运行在用户本机,API 密钥本地保存,不传第三方服务器。它由 AI 智能体通过 SDK/MCP 调用,而非人工交易界面。定位为执行优化,不生成买卖信号、不提供投资建议、不决定仓位方向、不承诺盈利;方向与数量须由用户给定,它负责高效执行。

主要能力:六个核心方法——place_order(bf.place,按交易所+币种+目标仓位+时间窗下单,maker 或 TWAP)、query_ticket(bf.query 查状态与成交量)、cancel_ticket(bf.cancel 取消活动工单并自动撤挂单)、compare_tca(bf.tca 返回执行成本、机会成本及 L1/mid/TWAP/VWAP 基准对比)、set_credentials(写入 ~/.blockfill/config.toml,权限 0600,并做签名校验连通性)、set_proxy(为 REST 与 WebSocket 配置 HTTP CONNECT 代理,应对地域屏蔽)。

使用方式:安装 pip install blockfill(wheel 内置执行器二进制)。核心概念含 Ticket(执行工单)、Daemon(维护交易所连接并执行工单的后台进程)、CLI(blockfill 二进制)、Python SDK(from blockfill import Blockfill)。默认策略 maker,默认时间窗 300000 毫秒(5 分钟)。同一交易所+币种的新工单会自动取消旧的 NEW/OPEN 工单。

支持场所:Binance、OKX、Bybit、Bitget、Gate.io、KuCoin、Kraken、Deribit(CEX),以及 Hyperliquid、Aster、Orderly(DEX);每个场所同时提供永续/期货与现货,交易所 id 形如 binance-futures、okx-swap。单 daemon 可并发运行全部交易所。CEX 按 x402 配额计费,DEX 收取 builder code 执行费、无配额。

限制与注意:不支持所列出之外或未配置的场所,不涉及股票、外汇;须先配置凭证(地域受限主机需代理);默认建议 testnet,切换主网前需确认。Binance TradFi 永续合约需要一次性账户协议,否则订单被拒(-4411);Hyperliquid 与 Aster 需主钱包一次性链上授权 builder fee(≥0.015%),测试网不附带 builder code,测试通过也不代表主网可用。该技能不跨所翻译币种格式,须使用各交易所原生符号格式,可用 blockfill check instrument --symbol btc 查询。