# 比特流技能在Bitflow聚合流动性协议上提供DEX操作： * **市场数据** — 通过公共 API 获取所有交易对的股票价格、交易量和流动性。 * **代币发现** — 列出可用的交换代币，查找给定代币的交换目标，发现多跳路由。 * **掉期报价** — 通过价格影响分析（XYK 恒定乘积公式）获取预期产出金额。 * **代币互换** — 通过滑点保护和高影响力的安全门执行互换。 * **Keeper 自动化** — 通过 Keeper 合约创建、监控和取消自动掉期订单。所有 Bitflow 操作都是**仅限主网**。不需要 API 密钥 - Bitflow SDK 以每个 IP 每分钟 500 个请求的速度与公共端点配合使用。如需更高的速率限制，请联系 [help@bitflow.finance]()。写入操作（交换、创建订单）需要解锁的钱包（首先使用“bun run wallet/wallet.ts unlock”）。 ## 用法 Bun run bitflow/bitflow.ts <子命令> [选项] ## 子命令 ### 获取股票代码从 Bitflow DEX 获取市场行情数据。返回所有交易对的价格、交易量和流动性数据。可以选择按特定对进行过滤。 Bun run bitflow/bitflow.ts get-ticker [--base-currency ] [--target-currency ] 选项： * `--base-currency` (可选) — 按基础货币合约 ID 过滤 * `--target-currency` (可选) — 按目标货币合约 ID 过滤输出： { “网络”：“主网”， “对数”：42， “代码”：[ { "ticker_id": "token-stx_token-sbtc", "base_currency": "代币-stx", "target_currency": "代币-sbtc", "last_price": "0.000012", "base_volume": "5000000", “目标体积”：“60”， “出价”：“0.000011”， “问”：“0.000013”， “高”：“0.000014”， “低”：“0.000010”， “美元流动性”：“1500000” } ] } ### 获取令牌获取所有可用于在 Bitflow 上交换的代币。 Bun运行bitflow/bitflow.ts获取令牌输出： { “网络”：“主网”， “令牌计数”：15， “令牌”：[ { “id”：“令牌-stx”， “名称”：“堆栈”， “符号”：“STX”， "contractId": "token-stx", “小数”：6 } ] } ### 获取交换目标获取给定输入令牌的可能交换目标令牌。返回从指定代币交换时可以接收到的所有代币。 Bun run bitflow/bitflow.ts get-swap-targets --token-id 选项： * `--token-id` (必填) — 输入代币 ID (合约地址) 输出： { “网络”：“主网”， "inputToken": "token-stx", “目标计数”：8， “目标”：[“令牌-sbtc”，“令牌-aeusdc”，“令牌-alex”] } ### 获取报价从 Bitflow DEX 获取掉期报价。返回预期产量、最佳路线和价格影响分析。 Bun run bitflow/bitflow.ts get-quote --token-x --token-y --amount-in 选项： * `--token-x` (必填) — 输入令牌 ID (例如 `token-stx`、`token-sbtc`) * `--token-y` (必填) — 输出令牌 ID (例如 `token-sbtc`、`token-aeusdc`) * `--amount-in` （必需）——以人类可读的十进制表示的输入令牌数量（例如，`0.00015` 表示 15,000 sats sBTC，`21.0` 表示 21 STX）。 SDK 在内部按“10^decimals”自动缩放。输出： { “网络”：“主网”， “引用”：{ "tokenIn": "token-stx", "tokenOut": "token-sbtc", “金额”：“1.0”， "expectedAmountOut": "0.0000036", “路线”：[“令牌-stx”，“令牌-sbtc”] }, “价格影响”：{ “综合影响”：0.0023， "combinedImpactPct": "0.23%", “严重性”：“低”， “啤酒花”：[...]， “总费用Bps”：30 } } ### 获取路线获取两个令牌之间所有可能的交换路由，包括通过中间令牌的多跳路由。 Bun run bitflow/bitflow.ts get-routes --token-x --token-y 选项： * `--token-x` (必填) — 输入令牌 ID * `--token-y` (必填) — 输出令牌 ID 输出： { “网络”：“主网”， "tokenX": "令牌-stx", "tokenY": "代币-sbtc", “路线计数”：3， “路线”：[ { "tokenPath": ["token-stx", "token-sbtc"], “dexPath”：[“xyk-pool-v1”] } ] } ###交换在 Bitflow DEX 上执行代币交换。自动找到穿过所有池的最佳路线。包括一个高影响力的安全门——价格影响超过 5% 的掉期需要“--confirm-high-impact”。需要解锁的钱包。 Bun运行bitflow/bitflow.ts交换\ --token-x --token-y --amount-in <十进制> \ [--slippage-tolerance <小数>] [--fee <值>] [--confirm-high-impact] 选项： * `--token-x` (必填) — 输入代币 ID (合约地址) * `--token-y` (必填) — 输出代币 ID (合约地址) * `--amount-in` （必需）——以人类可读的十进制表示的输入令牌数量（例如，`0.00015` 表示 15,000 sats sBTC，`21.0` 表示 21 STX）。 SDK 在内部按“10^decimals”自动缩放。 * `--slippage-tolerance` （可选）——小数点的滑移容差（默认 0.01 = 1%） * `--fee` (可选) — 费用：`低` | `中` | “高”预设或微 STX 量。如果省略，则自动估计。 * `--confirm-high-impact`（可选）- 需要执行价格影响超过 5% 的掉期输出： { “成功”：真实， "txid": "abc123...", “交换”：{ "tokenIn": "token-stx", "tokenOut": "token-sbtc", “金额”：“1.0”， “滑移容差”：0.01， "priceImpact": { "combinedImpactPct": "0.23%", "severity": "低" } }, “网络”：“主网”， "explorerUrl": "https://explorer.hiro.so/txid/abc123...?chain=mainnet" } ### 获取守护者合同获取或创建用于自动交换的 Bitflow Keeper 合约。 Bun run bitflow/bitflow.ts get-keeper-contract [--address ] 选项： * `--address` （可选）- 堆栈地址（如果未指定则使用钱包）输出： { “网络”：“主网”， "地址": "SP2...", "contractIdentifier": "SP2...keeper-v1", “状态”：“活跃” } ### 创建订单通过 Bitflow Keeper 创建自动掉期订单。创建将由 Keeper 服务执行的挂单。 Bun run bitflow/bitflow.ts create-order \ --contract-identifier --action-type \ --funding-tokens '{"token-stx":"1000000"}' --action-amount <单位> \ [--最小收到金额 <单位>] [--自动调整] 选项： * `--contract-identifier` (必填) — Keeper 合约标识符 * `--action-type` （必需）- 操作类型（例如，`SWAP_XYK_SWAP_HELPER`） * `--funding-tokens` (必需) — 代币 ID 到融资金额的 JSON 映射 * `--action-amount` (必需) — 操作的金额 * `--min-received-amount` (可选) — 接收的最小金额（滑点保护） * `--auto-adjust` （可选）——根据市场自动调整收到的最低金额（默认 true）输出： { “成功”：真实， “网络”：“主网”， "orderId": "order-123", “状态”：“待处理”， “订单”：{ "contractIdentifier": "SP2...keeper-v1", "actionType": "SWAP_XYK_SWAP_HELPER", "fundingTokens": { "token-stx": "1000000" }, "actionAmount": "1000000" } } ### 获取订单获取 Bitflow Keeper 订单的详细信息。 Bun run bitflow/bitflow.ts get-order --order-id 选项： * `--order-id` (必填) — 要检索的订单 ID 输出： { “网络”：“主网”， “订单”：{ "orderId": "order-123", “状态”：“已完成”， "actionType": "SWAP_XYK_SWAP_HELPER", "actionAmount": "1000000" } } ### 取消订单在执行前取消 Bitflow Keeper 订单。 Bun run bitflow/bitflow.ts cancel-order --order-id 选项： * `--order-id` (必填) — 要取消的订单 ID 输出： { “网络”：“主网”， "orderId": "order-123", “取消”：正确 } ### 获取守护者用户获取 Bitflow Keeper 用户信息和订单。检索用户的保管人合同和订单历史记录。 Bun run bitflow/bitflow.ts get-keeper-user [--address ] 选项： * `--address` （可选）- 堆栈地址（如果未指定则使用钱包）输出： { “网络”：“主网”， “用户信息”：{ "stacksAddress": "SP2...", "contracts": [{ "identifier": "SP2...keeper-v1", "status": "active" }], "orders": [{ "orderId": "order-123", "status": "已完成" }] } } ## 注释 * 所有 Bitflow 操作都是**仅限主网**。测试网上的调用将返回错误。 * 无需 API 密钥 — Bitflow SDK 使用公共端点，速率限制为 500 个请求/分钟。 * 要获得更高的速率限制，请设置 `BITFLOW_API_KEY` 和 `BITFLOW_API_HOST` 环境变量。 * 价格影响 >5% 的掉期需要明确的“--confirm-high-impact”标志作为安全措施。 * 价格影响是使用 XYK 常量乘积公式计算路由中所有跃点的。 * Keeper 功能支持自动/预定交换。使用“get-keeper-contract”开始。 * 钱包操作需要解锁的钱包（首先使用`bun run wallet/wallet.ts unlock`）。

比特流

包含技能