用途:通过命令行管理 Bithumb 现货交易,包括下单、撤单、查询订单,以及批量下单、批量撤单和 TWAP 时间加权执行。仅支持现货,不含杠杆、保证金、合约或期权。
安装与凭证:npm install -g @bithumb-official/bithumb-cli;凭证通过 BITHUMB_ACCESS_KEY / BITHUMB_SECRET_KEY 环境变量或 ~/.bithumb/config.toml 提供。任何需认证命令前先执行 bithumb system diagnose,失败则停止并由用户检查凭证;再用 bithumb account order-chance --market <m> 确认交易权限、余额与限额。
主要命令:bithumb trade place(下单)、trade cancel(撤单)、trade get(查单笔)、trade list(查多笔/筛选)、batch-place、batch-cancel、twap place/list/cancel。多笔查询用 trade list --order-ids id1,id2 或 --client-order-ids,一次最多 100 个,不要逐条调用 trade get;默认 state=wait,可用 --states wait,done,cancel 扩展,watch 需单独查询。
写入前必须执行预检:先 config show --json 检查只读限制,再确认余额、费率、最小/最大下单量,核对行情价格,限价单需按价格最小变动单位对齐,向用户复述并确认市场、方向、类型、价格、数量、总额后再执行。写入后须用 trade get、trade list 或 twap list 验证状态。
订单参数:市价买(price 类型)--price 是花费的 KRW 总额,无 volume;市价卖(market)需 --volume,无 price;限价单需同时提供 --price 与 --volume。市场代码格式为 KRW-BTC(报价-基础)。方向 bid 为买,ask 为卖。客户订单号可选,1–36 字符,仅限字母、数字、连字符和下划线。TWAP 时长 300–43200 秒,频率为 15、20、30、60、120 秒之一。
限制:Bithumb 无演示/模拟模式,所有订单动用真实资金;撤单若返回 order_not_found,应直接用 trade get 单笔确认状态,不要依赖 trade list 查询。