Fee Optimizer MCP

费用优化 MCP

一个 MCP（Model Context Protocol）服务，可帮助 AI Agent 解答有关加密货币交易所交易费用的问题、获取费用折扣推荐链接、计算节省金额、比较总成本（费用 + 资金费 + 点差／滑点 + 提币费用）、计算包含 VIP 等级升级节省金额的年度综合成本、检查资金费率（打包平均值或实时费率）、衡量订单簿执行成本（穿越买卖价差 + 根据规模变化的深度滑点，使用打包基准值或实时订单簿数据）、比较法币直接出入金成本（跨平台、货币和居住国家的银行卡／ACH／SEPA／FPS／电汇／SWIFT／PIX 充值与提现）、比较各平台按资产和网络划分的链上提币费用（16 种资产 × TRC-20／ERC-20／L2／原生路线，包含钱包暂停状态标记和按快照价格换算的美元金额），并运行以研究为依据的交易者角色分析，对七种交易者类型的完整成本结构（费用 + 资金费 + 点差 + 提币费用 + 法币出入金）进行年化计算，并根据用户的个人资料推荐最佳交易所。

当用户询问 “哪家加密货币交易所对限价单交易者的费用最低？”、“给我一个 Gate.io 折扣注册链接”、“持有 10 万 USDT 期货 16 小时能省多少钱？” 或 “这些费用数据来自哪里？” 时，Agent 可以调用此服务的工具，提供具体且有来源依据的回答，包括用户可用于注册并享受费用折扣的推荐链接。

功能

二十种只读工具。支持通过 stdio 或无状态 Streamable HTTP 运行（v0.29：每个请求使用隔离的服务，返回 JSON 响应，提供 /health 探测——可用于远程/容器托管；v0.32 增强了面向公共托管的安全性：可选择启用 bearer-token 身份验证、按 IP 限速、结构化 JSON 访问日志和生产环境 Dockerfile）。所有涉及费用的工具都要求提供国家代码，以便进行合规筛选。每个结果都带有 data_as_of 时间戳，get_data_sources 会报告每个文件的 months_behind/is_stale 以及 stale_files（v0.33），并由离线 npm run audit:data 一致性检查门禁强制执行。v0.48 新增 get_fee_changes（第 20 个工具）——可审计的费率表变更动态（数据护城河）：经过官方公告核实的 VIP 费率调整、资格门槛变更、梯级增删、促销、代币折扣和定价模式变更精选历史记录（每条均带生效日期、来源 URL 和双语摘要），以及 snapshots/fee_ladders/ 中每月确定性费率阶梯快照，并自动进行差异比较——由快照推导的行带有 confidence: "detected"，绝不会作为已确认信息呈现（差异也可能是数据修正）；每月 GitHub Actions 工作流会捕获新快照并创建仅供审核的 PR，由人工对照官方费用页面核实后，再整理至 data/fee_changes.json。整理后的动态随 npm 包一同发布；快照仅存于仓库中，npm 用户可正常降级使用（snapshot_coverage.available: false）。v0.34 新增 volume_what_if——交易量假设/敏感性扫描：跨交易平台最低成本排名，以及各交易平台在不同月交易量水平下的费用/成本曲线（默认取各平台 VIP 门槛的并集作为采样点）、准确的等级跨越清单；提供 baseVolume 时，还会列出各平台的下一阶梯、所需额外交易量，以及按当前交易量计算的年度美元节省金额（对 Binance 现货等持仓要求限制的阶梯会标记为 blocked_by_holding_gate）。v0.35 新增 compare_countries——一次调用即可按完整年度全包成本，为最多 12 个国家/地区的同一交易者画像计算价格：列出各国家/地区的赢家和符合实际情况的全环节选择，按可比口径计算相对于成本最低国家/地区的年度额外成本（不支持相关出入金通道的表面赢家无法冒充某个国家/地区），提供区分合规限制与产品不支持情况的交易平台×国家/地区可用性矩阵（如面向期货交易者、仅支持现货的 Coinbase），以及交易平台胜出次数和最高/最低成本差距。v0.36 新增可直接粘贴的矩阵表格——compare_personas、volume_what_if 和 compare_countries 支持 format: "markdown" | "csv" | "both"，并在未变更的 JSON 之外返回 rendered 对象（tableMetric 用于选择扫描结果中的加权费率/年度费用/等级，或国家/地区结果中的可用性符号/成本）；Markdown 表格会转义竖线，CSV 遵循 RFC 4180（引用含逗号/引号/换行的字段，使用 CRLF），可直接粘贴到文档或电子表格中；默认调用的字节内容保持不变。v0.37 新增 BloFin，成为第 13 个交易平台——以衍生品为主的开曼/马绍尔群岛交易所（永续合约交易量约为 $1.2B/24 小时，每日提现不超过 20k USDT 无需 KYC）：现货/期货均采用 6 级阶梯（期货基础费率为 0.020%/0.060%，最高可降至 0%/0.035%；现货为 0.10%/0.10%，最高可降至 0.01%/0.0325%），三轨任选其一的资格认定方式（30 天期货交易量 / 30 天现货交易量 / 账户资产——资产达到 $50k 即可取得期货 VIP1），8 小时资金费率，永续合约典型价差约 3 个基点，通过 TRC-20 提现约需 1 USDT/USDC，无原生代币，无推荐链接，无直接法币通道；在美国/加拿大/中国/新加坡以及 MiCA 框架下的欧洲经济区（EEA）受限（明确建模德国）。v0.38 新增 Bitstamp，成为第 14 个交易平台——模型中监管最严格的交易平台（成立于 2011 年，位于卢森堡，归 Robinhood 所有；持有欧盟 MiCA CASP 通行许可、NYDFS BitLicense、英国 FCA 许可及新加坡 MAS 许可）：现货采用 11 级、仅按交易量划分的阶梯（30 天成交额从入门级 0.30%/0.40% 降至超过 $1B 时的 0.00%/0.03%），另有受监管的美元保证金永续合约，固定费率为 做市方返佣 −0.005% / 吃单方 0.015%，采用 8 小时点对点资金费率——永续合约仅对欧盟/欧洲经济区合资格居民开放，并通过交易平台×国家/地区产品门禁建模（v0.40：启用正向 EEA 区域允许名单——所有 30 个 EEA 国家/地区的两种产品均可使用，其他所有居住地，包括 AU/BR/CH，期货均返回 PRODUCT_BLOCKED_IN_COUNTRY，现货则仍开放；中国则是交易平台层级受限）；直接法币通道丰富（ACH 双向免费，SEPA 入金免费/出金 €3，SWIFT 费率为 0.05%/0.1%，设有最低费用/封顶，银行卡约 4%），提现费用保守地按 ERC-20 为主建模（USDT 仅支持 ERC-20，约需 20——是模型中 USDT 提现成本最高的路线）。资金费率计算默认使用打包的长期均值，可通过 fundingMode: "live" 切换为实时费率。执行成本（价差 + 滑点）默认使用打包的典型价差基线，可通过 spreadMode: "live" 切换为实时订单簿逐档计算。v0.39 新增 get_account_fee_tier——从公开费率表跃升至调用者的实际账户费率：传入只读 API 密钥（Hyperliquid 只需公开的 0x 钱包地址；OKX/KuCoin-Futures 需要 API passphrase），工具会通过 ccxt 调用交易平台经过身份验证的费用端点，返回实际的做市/吃单费率百分比，以及相对于给定月交易量下打包公开 VIP 等级的有符号基点差值（可捕获服务器端 BNB 抵扣、交易平台自身的滚动 30 天 VIP 窗口、协商/促销费率；18 个交易平台中支持 13 个——Phemex/BloFin、Finst、Bitpanda 和 BISON（无公开交易 API / ccxt 连接器），以及仅支持现货的平台的永续合约（Bitstamp、Bitvavo），会返回有类型的“不支持”错误）。凭证仅用于单次请求，不会缓存，也不会写入日志（审计行会对 apiKey/secret/password 进行脱敏；错误字符串会清除凭证字面值），且任何经过身份验证的调用前都会先执行国家/地区和产品合规门禁。v0.40 新增正向区域允许名单（country_restrictions.json 中的 regions + product_region_gates），取代 v0.38 的负面名单默认键：Bitstamp 永续合约现在要求居住地属于指定的 EEA 区域（全部 30 个国家/地区——EU27 + 冰岛/列支敦士登/挪威），因此 AU/BR/CH/TR/KR 等未建模的非 EEA 居住地会正确返回 PRODUCT_BLOCKED_IN_COUNTRY，而不是被错误地默认放行；所有 EEA 成员（FR/NL/ES/IT/…）的两种产品均可使用。该门禁由数据驱动，可复用于未来受区域限制的交易平台。v0.41 强制执行悬崖期后的 MiCA 规则（第 143(3) 条过渡期已于 2026-07-01 结束，不再延期），采用负向区域门禁（region_blocked + product_region_blocked）：对于 EEA 居民，Binance、MEXC、Bitget、KuCoin、BingX、Phemex 和 BloFin 的所有产品均被禁止使用（没有可用的 CASP 授权——申请已撤回/尚待处理，或 KuCoin 正受到 FMA 的有效停业禁令）；Bybit/Gate 的永续合约产品受限，等待单独获得 MiFID II 投资公司授权，而其现货仍开放；因此，EEA 现货平台包括 OKX/Gate/Bybit/Kraken/Coinbase/Bitstamp，永续合约则仅限 OKX（X-Perps）、Kraken 和 Bitstamp，另有非托管的 Hyperliquid（无前端地理封锁——保留该平台，并明确提示灰色地带风险）。负向门禁只会缩小 EEA 结果范围；非 EEA 市场（美国/英国/澳大利亚/巴西/日本/…）与此前保持逐字节一致，包括通过开放默认键路由的国家/地区。v0.42 新增 Bitvavo，成为第 15 个交易平台——欧洲最大的本土欧元现货交易所（位于阿姆斯特丹，成立于 2018 年，用户超过约 400 万，占全球欧元计价现货交易量约一半；已在 AFM 注册为 MiCA CASP，注册编号 #41000010，并持有 EEA 通行许可）——并新增交易平台级正向服务区域门禁（country_restrictions.json 中的 region_allowed）：Bitvavo 仅服务 30 个 EEA 国家/地区，因此其他所有居住地（美国/英国/瑞士/日本/新加坡/澳大利亚/巴西/中国/…，包括默认键国家/地区）都会被过滤掉该平台（遵循 COUNTRY_BLOCKED 语义）；若白名单匹配，即使某个过时的逐国家/地区 allowed 枚举值不一致，也会授权使用该平台。Bitvavo 仅支持现货：采用 9 阶、单轨的 30 天欧元成交量 PRO 阶梯（入门级 0.15%/0.25%，超过 €25M 后降至 0.00%/0.02%；无代币、无资产轨道；不对 Basic 消费者界面中内含的价差建模），模型中欧盟欧元订单簿价差最窄，全价差 1.0 个基点 / 穿价 0.5 个基点（Kaiko 2026-05 测得 0.981 个基点——优于所有欧洲交易平台）；欧元 SEPA/SEPA Instant 双向免费（iDEAL/Bancontact 通过 SEPA 处理；每日提现上限 €25k），另有约 1% 的欧盟银行卡入金，不支持银行卡提现；链上提现费动态变化，仅支持 BTC，按 0.00005 BTC 建模（不支持 Lightning；USDT/USDC/ETH/其他山寨币均显示为不支持）。EEA 现货平台增至 8 家；期货平台列表不变（期货交易者画像中，Bitvavo 会归入 unsupported_product）。Bitvavo 的英国和瑞士独立实体有意不纳入建模，因此英国/瑞士仍不在白名单内。v0.43 新增 Finst，成为第 16 个交易平台——模型中的首个经纪平台，而非订单簿交易所（位于阿姆斯特丹，成立于 2022 年，由前 DEGIRO 团队创立；AFM 于 2025-07 授予 MiCA CASP #41000015，并持有 EEA 通行许可，覆盖约 30 个国家/地区、用户超过 11 万）：智能订单路由器（SOR）聚合外部流动性，并对每次买入/卖出/兑换/自动投资统一收取固定 0.15%——无做市/吃单费率区分、无交易量阶梯、无最低费用、无价差加价（建模为单一且不受交易量影响的阶梯档位，并使用 1.0/0.5 个基点的群组价差代理值）。采用相同的交易平台级 region_allowed: ["EEA"] 门禁，使 EEA 现货平台增至 9 家；Finst 不会出现在任何非 EEA 结果中。该平台仅支持现货（EEA 内的期货交易者画像会显示 unsupported_product，EEA 外则显示 blocked），仅提供欧元 SEPA/SEPA Instant/iDEAL/Bancontact 双向免费转账——无银行卡通道（明确查询银行卡时返回 available: false），不支持 PayPal、美元/英镑；加密货币提现按网络费收取实际成本，另加固定 €2.50 第三方费用：由于架构没有附加费字段，BTC 按全包价 0.000085 BTC（≈$6.57）计价，并在路线说明中披露两部分费用；其他 400 多种市场均显示为不支持。平台没有推荐计划，也没有公开交易 API，因此 get_account_fee_tier 不支持该平台（实时覆盖仍为 13 家）。v0.44 新增 Bitpanda，成为第 17 个交易平台，也是模型中首个按价差定价的经纪平台（位于维也纳，成立于 2014 年，用户超过 740 万；BaFin 于 2025-01-27 授予 MiCA CASP 授权，覆盖 EEA30，并持有奥地利 FMA 许可和在英国 FCA 注册的 Bitpanda Broker UK 实体）：消费者应用会报出全包价格，费用嵌入加价中，不另收佣金——新增 pricing_model: "spread"（order_book | flat | spread），不区分做市/吃单费率，也没有交易量阶梯——大多数资产的标价为每边 1.49%，BTC 和主要稳定币交易对通过交易对级覆盖设置为每边 0.99%，市值低于 €100M 的小市值币种为 2.49%（不对 1.99% 的加密货币指数区间和消费者应用的 10 倍保证金建模；不支持期货）。由于嵌入的加价本身就是价差成本，Bitpanda 打包的典型价差基线固定为 0 个基点，避免将溢价和价差重复收费；新增 execution_quality 证据区块，披露经纪平台未展示的差距：标称往返成本为 2.98%，而 TUM 使用真实资金进行的 €100 往返测量结果为 6.23%——隐藏加价 4.25 个百分点（2025 年 10 月至 11 月进行测量，Frankfurt School of Finance 于 2026-03 使用 9 个平台的 432 次往返交易独立复现）——这是研究中测得的欧洲零售成本差距最大的一例。Bitpanda 仅服务 30 个 EEA 国家/地区及英国，通过 region_allowed: ["EEA","GB"] 实现（将 GB 添加为单成员区域键——采用相同的正向门禁机制，无需更改门禁代码），使 EEA 现货平台增至 10 家；服务区域内的期货交易者画像会显示 unsupported_product，区域外（美国/加拿大/中国/瑞士/…）则显示 blocked；独立的 Bitpanda Fusion 专业交易所（聚合流动性定价为 0.02–0.25%）以及股票/贵金属/ETF 有意不纳入建模，并通过说明披露。自 2026 年起，所有消费者应用法币通道均免费——欧元 SEPA/SEPA Instant、Visa/Mastercard 银行卡（仅支持入金，不支持银行卡提现）、PayPal 和 Apple/Google Pay，以及英镑 FPS 和银行卡；无美元通道（美元查询会保留该平台行，并返回 available:false）。加密货币提现按动态网络费收取，无加价：截至标注日期的快照，BTC 为 0.00000598（约 $0.46），ETH 为 0.0006（约 $1.51）。平台没有推荐链接，且 ccxt 未提供 bitpanda 类，因此 get_account_fee_tier 返回 ACCOUNT_FEES_UNSUPPORTED（实时覆盖仍为 17 家中的 13 家）。v0.45 新增 BISON，成为第 18 个交易平台，也是模型中第二个按价差定价的经纪平台（Boerse Stuttgart Group 旗下，位于斯图加特，2019 年上线，活跃用户超过 100 万；EUWAX AG 作为主交易对手方报价，报价有效时间约 10 秒，无订单簿；Boerse Stuttgart Digital Custody——前身为 blocknox——自 2025-01-17 起持有首个 BaFin MiCA 加密货币托管/转账许可证，可向 29 个国家/地区提供服务；EUWAX AG 的加密货币交易所服务自 2025-04-01 起获 MiCA 授权）：消费者应用提供单一全包价，同样采用 pricing_model: "spread" 建模（无做市/吃单费率，无交易量阶梯）——BTC 和 ETH 通过交易对级覆盖设置为每边 1.25%，其他所有加密货币均为每边 1.75%（往返成本约为 2.5% 和 3.5%），低于 Bitpanda 标价的 1.49%。价差基线固定为 0 个基点（同样防止重复计算），而 execution_quality 证据区块则呈现与 Bitpanda相反的情况：标称往返成本为 2.5%，而 TUM 使用真实资金进行的 €100 测量结果为 2.58%——未披露差距仅约 0.08 个百分点（2025 年 10 月至 11 月，在 6 个获 MiCA 许可的平台进行测量）——在受测平台中，这是已发布报价与实测结果最接近的一例（其次为 Bitvavo；Bitpanda 为 6.23%，Coinbase 为 7.49%），使 BISON 成为欧洲透明度标杆。BISON 通过 region_allowed: ["EEA","CH"] 服务30 个 EEA 国家/地区及瑞士——CH 是新增的单成员区域键（积极面向 DE/AT/CH 营销，其他 EEA 居民则依据被动服务自由原则获得服务）——并且不向英国提供服务，与 Bitpanda（EEA+GB，不含 CH）的服务范围恰好互补；此外，美国/加拿大/日本/新加坡/澳大利亚/巴西/中国/韩国等地也受限；EEA 现货平台增至 11 家，CH 平台增至 15 家，BISON 不会出现在英国/美国/日本的结果中。该平台仅支持现货（futures: [] → 服务范围内显示 unsupported_product，范围外显示 blocked；不提供期货或保证金交易）。官方加密货币提现免费——没有网络费一项，链上成本由 EUWAX/集团承担（不同于 Bitpanda 的费用转嫁）——BTC 和 ETH 均按 0 建模，因此 BISON 的这两种资产提现成本均为模型中的全球最低（最低提现量为 0.001 BTC，不支持 Lightning/Taproot bc1p；仅支持 Ethereum 主网，最低提现量为 0.01 ETH，不支持 L2 提现）。法币仅支持欧元：SEPA/SEPA Instant 双向免费，包括使用欧元入金的瑞士用户，另有仅限入金的银行卡/Apple Pay/Google Pay，费率为 2.49%（Solaris SE/Deutsche Bank 合作伙伴费用，不支持银行卡提现；无英镑/美元/瑞士法郎通道——美元查询会保留不可用行）。德国股票/ETF 订单费 €1.99 和 27% 的质押奖励佣金不是加密货币交易费用，因此不纳入建模。邀请好友计划没有联盟 URL（NO_REFERRAL_LINK），且 ccxt 4.5.78 未提供 bison/euwax 类，因此 get_account_fee_tier 返回 ACCOUNT_FEES_UNSUPPORTED（实时覆盖仍为 18 家中的 13 家）。v0.46 新增 get_stablecoin_access（第 18 个工具）——MiCA 稳定币区域准入信息：Tether 从未申请 MiCA EMT 授权；在 2026-07-01 CASP 过渡期悬崖（ESMA75-113276571-1679，已确认不可延期）之后，所有 30 个 EEA 国家/地区的交易平台均无法交易 USDT——模型记录各交易平台完整的下架时间线（包括 Coinbase 2024-12、Binance/Kraken/OKX/Gate/Bitstamp/Bitpanda/Bitvavo 在 2025-03 前后的一波下架，以及 Revolut 于 2026 年停止买入/转换剩余余额的日期），并标记六家 EEA 受限平台的 venue_blocked 状态，以及 BISON/Finst/Hyperliquid 的 never_offered 状态；报告会区分交易平台端的交易禁令与个人权利——持有、托管和链上提现到自托管钱包仍属合法（兑换/托管服务大多保留，DEX 不在监管范围内；瑞士和英国明确不属于 EEA 区域），列出六种建模的 MiCA 授权替代币种（USDC/EURC——Circle France EMI，EURI——Banking Circle，EURCV——SocGen FORGE，USDQ/EURQ——Quantoz）及其发行方/授权详情，并提供双语建议。相同的 STABLECOIN_UNAVAILABLE_IN_REGION 警告会自动注入所有 EEA 地区以 USDT 报价的流程——费用比较（按交易平台列出的 stablecoin_access 行）、节省金额/总成本/年度成本/建议（交易上下文顶层的 stablecoin_warning）、提现（自托管/提现上下文）、执行成本和用户画像分析（7 个用户画像中有 5 个通常会提现 USDT）——确保 Agent 绝不会建议欧盟居民在交易平台上交易 USDT 而不提示这一限制。v0.47 新增 compare_interface_costs（第 19 个工具）——消费者与 PRO 双界面成本建模：同一个账户通常会同时使用低费率订单簿界面（Kraken Pro、Coinbase Advanced、Bitvavo trade）和报价中嵌入价差、成本较高的消费者应用——以 TUM 使用真实资金进行的 €100 往返交易研究为基准计算（2025-10 至 11，6 个获 MiCA 许可的欧盟平台；Frankfurt School 于 2026-03 使用 9 个平台的 432 次往返交易独立复现）：零售往返成本差距最高达 13 倍——Bitvavo 0.58%（费用直接转嫁，透明度标杆）< BISON 2.58% < Kraken 应用 5.81%（隐藏成本 3.81 个百分点）< Bitpanda 6.23%（隐藏成本 4.25 个百分点）< Coinbase Simple 7.49%（隐藏成本 4.51 个百分点，最高——$2.99 固定费用对小额定期定投买入影响很大，甚至简单的 LIMIT 订单也会产生 1% 的执行费用）；各交易平台的结果行会列出消费者产品名称和收费模式、建模的单向全包成本、实测往返成本、隐藏加价百分点、PRO 做市/吃单基础费率及百分点差距；提供 monthly_volume_usd 时，还会计算继续使用应用产生的年度化超额成本（Coinbase 月交易量 $1k 时约为 $168/年），并注明订阅注意事项（Kraken+ 每月 $4.99/享有 10k 费用减免、Coinbase One），同时说明应用内交易量不会计入 PRO 等级资格；Bitpanda/BISON 仅提供经纪服务（溢价本身就是费用——没有可切换的 PRO 界面），Bitstamp Basic 标记为未经验证；适用居住地门禁；同一差距会自动作为 consumer_interface 提示及 CONSUMER_INTERFACE_MORE_EXPENSIVE 警告注入费用/节省金额/总成本/建议工具。v0.30/v0.31 新增双语叙述输出——十五种带叙述内容的工具支持 language: "en" | "zh"，并会本地化所有 advice/warnings/tradeoffs/reasons/tier_warning 字符串（数字、字段名和错误代码保持不变）；v0.31 还修复了此前会显示“持有至少 undefined BNB”的 BNB 持仓门槛警告。

工具	触发语句（英文 / 中文）	返回内容
compare_exchange_fees	"which exchange has the lowest fees" / "交易所手续费对比"	按加权实际费率排序的交易所、挂单/吃单费率拆分、VIP 等级、代币 + 推荐优惠
get_referral_link	"give me a Binance referral link" / "币安优惠注册链接"	推荐 URL + 折扣百分比 + 备注
calculate_savings	"how much will I save on 100k USDT futures" / "10万U能省多少"	原始手续费、使用推荐优惠后的手续费、使用代币后的手续费、最终手续费、节省金额、可选资金费用
compare_total_cost	"true cost including funding and withdrawal" / "真实总成本对比"	各交易所的交易手续费 + 资金费用 + 提币费，并按总成本排序；v0.26 可选地将年化直接法币入金/出金费用（fiatDepositAmountUsd/fiatDepositsPerYear + 出金对应参数）计入 total_cost，并通过 fiat_deposit_available/fiat_cashout_available 标记没有直接渠道的平台，将该项排除，而不是按零计价
recommend_exchange	"which exchange should I use" / "我该选哪个交易所"	评分最高的推荐选项（0–100），含理由、权衡、建议和排序后的备选项；v0.27 将用户直接法币入金/出金习惯纳入评分（按离散度赋予 0.2–0.5 权重），明确标注没有法币渠道的平台及其取舍，并根据法币渠道而非单看交易费率，对小额银行卡/SEPA 入金平台进行排名
calculate_annual_cost	"what does trading cost me per year" / "一年手续费多少，升VIP能省多少"	年化交易手续费 + 资金费用 + 提币费（+ v0.26 可选的年度法币入金/出金费用，计入 annual_total_cost），以及升级到下一个 VIP 等级的条件和年度节省金额
get_data_sources	"where does the data come from" / "数据哪来的，多久更新"	每个文件的 last_verified 日期和来源 URL（交易所官方费率页面）+ 注意事项
get_funding_rates	"current funding rate on BTC perps" / "现在各所资金费率多少"	各交易所某永续合约交易对（默认 BTC/USDT）的资金费率 + 结算间隔：捆绑的平均值或实时费率，并为各平台提供回退数据
get_execution_cost	"spread and slippage on a 50k market order" / "点差滑点多少、大单冲击成本"	指定订单规模下，各交易所单向执行成本（基点 + 美元）：完整点差、跨越半个点差的成本、深度遍历滑点、消耗档位、成交状态；数据来自捆绑基准值或实时前 100 档盘口遍历
get_fiat_cost	"cheapest way to deposit euros / cash out to bank" / "入金出金手续费、SEPA/ACH/电汇/PIX 哪个便宜"	指定金额下，各交易所直接法币入金或出金的报价：费用（百分比 + 固定费用及最低/最高限额）、美元等值、实际费率、净到账金额、预计时间、各平台最便宜的渠道、全局最优选项及与最贵选项的差额；支持以 USD/EUR/GBP/BRL 使用银行卡 / ACH / SEPA / FPS / 电汇 / SWIFT / PIX，并根据居住地筛选渠道
get_withdrawal_fees	"cheapest network to withdraw USDT / ETH L2 提币费对比" / "各所提币手续费、TRC20/ERC20/ Layer2 哪个便宜、哪条链暂停了"	指定资产（及可选网络）在各交易所的提币报价：每条路线的原生单位费用 + 换算为美元的费用及 available 标记（显示已暂停的钱包，不会隐藏），各平台最便宜的开放路线、全局最优选项 best、与最贵选项的差额、警告；支持 TRC-20/ERC-20/BEP20/Arbitrum/Optimism/Base/Polygon/Avalanche C/Solana/TON/AssetHub 和原生链上的 16 种资产；完全离线
analyze_persona	"which exchange fits a small buyer / scalper / HODLer" / "我这种情况哪个交易所划算、定投囤币/波段/高频场景推荐"	七种有研究依据的交易者画像（随手买入者、HODL 积累者、活跃现货交易者、波段合约交易者、日内短线交易者、VIP/机构交易者、DEX 原生用户）：按全年总成本对完整成本结构进行排名——交易手续费 + 资金费用 + 点差 + 提币费 + 法币出入金——并提供各项成本构成、各项成本的领先平台、best_complete 推荐选项（各画像所需的每项费用都有定价的平台中最便宜者）、警告和可执行建议；v0.25 交叉关联 analyze_token_discount——使用 useToken=false（默认值）运行时，排名前 3 的平台各自会获得一个 token_discount_hint（代币、折扣百分比、年度节省金额、回本月数、持有成本、固定折扣或阶梯折扣），此外还有汇总的 token_discount_hints 数组和具体建议，因此一次调用即可同时回答“哪个交易所适合我”和“持有其平台代币是否划算”；所有预设均可覆盖
analyze_token_discount	"is holding BNB/GT/KCS for fee discounts worth it" / "持有平台币划算吗、折扣多久回本、币价跌多少不亏"	平台原生代币手续费折扣回本分析：不持有代币时的年度手续费（零余额等级，不启用开关）与持有代币后的年度手续费对比（BNB/MX/BGB/KCS 固定抵扣、GT/MX/HYPE 持仓等级阶梯、Gate 合约挂单手续费降至零、GT/KCS/BNB 等级提升），年度美元节省金额、锁定代币余额的美元机会成本、回本月数，以及一年内节省金额可抵消的最大代币跌幅；省略 tokenBalance 即可按回本时间排列所有可达到的等级
compare_personas	"which exchange for EVERY kind of trader" / "全部画像对比、什么人用什么所、决策矩阵、最全能的交易所"（v0.28）	一次调用即可针对某个国家为全部七种交易者画像（或其子集）运行完整的全年总成本分析，并返回决策矩阵：各画像的表面最优选项 + 实际可用的 best_complete 推荐选项、按平台排列的画像×平台 annual_all_in 网格（按成本从低到高排列，每格标明法币渠道/路线状态）、跨画像的 venue_wins，以及 most_versatile——例如，在 JP，Hyperliquid 表面上对 3 种画像最优，却没有任何实际可用的推荐选项（没有法币/提币渠道），而 OKX 是所有成本项均可覆盖的平台中最全面的选择
volume_what_if	"how do fees change if my volume grows / how much more trading to hit the next VIP tier" / "月交易量不同手续费差多少、再刷多少量升档省钱、各所档位跳变点、费率随成交量曲线"（v0.34）	对所有符合条件的平台进行现货/合约交易量假设分析：各交易量点的跨平台最低成本排名（等级 + 加权费率 + 年化交易手续费）、各平台的变化曲线及 tier_crossed 标记，以及完整的 tier_crossings 列表；提供 baseVolume 时，各平台的 next_tier 会给出精确门槛、当前交易量下每月需增加的交易量和年度美元节省金额——blocked_by_holding_gate: true 表示仅靠交易量无法达到的等级（例如 Binance 现货 BNB 的 AND 门槛）。默认扫描点取自所有平台 VIP 门槛的并集（超过 16 个时会采样并给出警告）；传入 volumes 可自定义扫描点
compare_countries	"same profile across countries / I'm moving countries, what changes / which venues are blocked here" / "同样的习惯在哪个国家最便宜、搬家换居住地、各国有什么交易所、哪些所在我国不能用、国家差异矩阵"（v0.35）	在多个国家（默认 US/GB/DE/JP/SG/BR/CN，最多 12 个）中，按完整年度成本结构运行一种交易者画像（默认为 active_spot_trader；支持全部 7 种画像）：每行包含表面最优选项 winner 和实际可用的 best_complete 推荐选项；基于所有成本项均可比较的平台计算 comparison_annual_all_in/extra_vs_cheapest_country_*（例如，Hyperliquid 对使用银行卡买入者可能是表面最优选项，但由于没有法币渠道，会被排除在国家间成本比较之外）；blocked_venues 与 unsupported_product_venues（Coinbase 不支持合约）；完整的平台×国家 venue_availability 矩阵、winner_venue_counts、cheapest_country/costliest_country/spread_usd 以及中英双语建议——例如，同一位小额银行卡买入者在美国每年约支付 $125，在德国约支付 $73（SEPA/银行卡渠道便宜）
get_account_fee_tier	"what is MY actual fee / my real VIP maker-taker / check my account fee with a read-only API key" / "我的实际费率、账户真实VIP档位、API查我的手续费、只读密钥查费率"（v0.39）	通过只读密钥验证真实账户的挂单/吃单费率 + 与指定交易量下公开费率表等级之间的基点差值；18 个平台中支持 13 个（Phemex/BloFin 不受 ccxt 支持；Finst、Bitpanda 和 Bison 没有公开 API/连接器；Bitstamp/Bitvavo 仅支持现货，因此不支持其永续合约）；密钥绝不缓存或记录日志；先进行合规检查；提供类型化的身份验证/网络错误代码
get_stablecoin_access	"can I still trade/withdraw USDT in the EU / is USDT delisted here / MiCA stablecoin alternatives" / "USDT在欧盟还能用吗、泰达币下架、欧洲稳定币、USDC/EURC合规稳定币"（v0.46）	稳定币的 MiCA 区域访问情况（默认 USDT；也支持 USDC/EURC/EURI/EURCV/USDQ/EURQ）：发行方 + MiCA EMT 授权、区域交易所交易限制及截止日期（2026-07-01 后适用于 EEA30）、托管/提币/自托管权利、各平台状态（已下架及日期 / 从未上线 / 平台受限，EEA/全球范围、在查询国家的可用性）、合规替代选项和中英双语建议；针对 USDT/EEA 请求时，会自动向手续费、提币、执行成本和交易者画像工具注入相同警告
compare_interface_costs	"why is the Kraken/Coinbase app so expensive / hidden spread in Instant Buy or Simple" / "为什么App买币这么贵、App隐藏点差、两套价格、简单买卖手续费、TUM实测"（v0.47）	各平台的消费级产品名称 + 费用模型、单向预估总成本、TUM 实测往返成本、隐藏加价百分点、PRO 挂单/吃单基准费率及其百分点差值；传入 monthly_volume_usd 时，还会计算消费级应用相对 PRO 的年化超额成本（例如，Coinbase 每月交易 $1k 约多花 $168/年）；订阅注意事项（Kraken+/Coinbase One）、不计入 PRO 等级的说明、居住地限制；Bitvavo 会作为 0.58% 费用直通定价透明度基准显示
get_fee_changes	"did any exchange change its fees lately / fee change history / 哪家所最近调过手续费、费率变更历史、怎么监控费率调整"（v0.48）	可审计的费率表变更动态：依据官方公告验证的精选高/中置信度记录（日期、来源 URL、中英双语摘要、变更前后费率），并合并由月度阶梯快照差异自动生成的 detected 记录（明确标注为未经验证）；支持筛选 exchange/product/since_month/limit，提供中英双语建议及 snapshot_coverage（仅包含仓库内快照；npm 使用者会看到 available: false）
支持的交易所：Binance、OKX、Gate.io、Bybit、MEXC、Bitget、KuCoin、Kraken（现货 + 期货，完整 VIP 等级表；MEXC 采用统一的 Standard 等级；Kraken 在两种产品上采用统一的 17 级阶梯）、Coinbase（仅支持 Advanced Trade 现货，等级仅按交易量划分）、Hyperliquid（v0.20，首个 DEX 交易平台：链上 L1 订单簿、按 14 天滚动交易量划分等级、每小时资金费率、质押 HYPE 可享手续费折扣、无需 KYC）、BingX（v0.21：VIP Club 阶梯等级，包含仅按交易量划分的 Elite 等级、按交易量或资产满足资格要求的路径，以及 8 小时资金费率）、Phemex（v0.24：总部位于新加坡，团队成员曾任职于 Morgan Stanley，行业最低 Maker 手续费——Standard 等级现货/期货费率为 0.01%，VIP 阶梯仅按 30 天交易量划分，8 小时资金费率，现货 + 期货均可享固定 20% PT 代币手续费抵扣折扣）、BloFin（v0.37：开曼群岛/马绍尔群岛衍生品交易平台，自 2023 年起运营，永续合约交易量约为 12 亿美元/24 小时——6 级阶梯，期货基础费率为 0.020%/0.060%，VIP5 降至 0%/0.035%；可通过 30 天交易量、现货交易量或账户资产三种路径之一满足资格要求（仅需 5 万美元资产即可达到期货 VIP1）；8 小时资金费率；永续合约典型价差约为 3 个基点；无原生代币、无直接法币入金通道；禁止美国/加拿大/中国/新加坡用户及 MiCA 监管下的欧洲经济区用户使用）、Bitstamp（v0.38：2011 年创立于卢森堡，归 Robinhood 所有，是监管最严格的交易平台——受 MiCA CASP、NYDFS BitLicense、英国 FCA 和新加坡 MAS 监管；现货采用 11 级、仅按交易量划分的阶梯，费率从 0.30%/0.40% 降至交易量达 10 亿美元时的 0%/0.03%；仅面向 EEA30 地区提供受监管的美元永续合约，Maker 费率固定为 −0.005%（返佣），Taker 费率为 0.015%，P2P 资金费率每 8 小时结算一次，并通过按国家 × 产品设置的正向地区许可名单进行限制（v0.40）；美国 ACH 免费，SEPA 入金免费、出金 €3，SWIFT 费率为 0.05%/0.1%，银行卡约 4%；提现主要使用 ERC-20 网络——USDT 仅支持约 20 种 ERC-20 网络，USDC 也支持 Solana/L2；无原生代币）、Bitvavo（v0.42：2018 年创立于阿姆斯特丹，是本土规模最大的欧元现货交易所——持有 AFM MiCA CASP #41000010 牌照并可在 EEA 范围内提供服务，用户超过 400 万，约占全球欧元计价现货交易量的一半；PRO 现货采用单一资格路径的 9 级阶梯，仅按 30 天欧元交易量划分，费率从 0.15%/0.25% 降至交易量超过 €25M 时的 0%/0.02%，无代币/资产资格路径；模型中欧元订单簿价差最小，为 1.0 个基点（Kaiko，2026-05）；SEPA/SEPA Instant 双向转账均免费（iDEAL/Bancontact），欧盟银行卡仅支持入金，费用约为 1%；BTC 提现费会动态调整，当前为 0.00005；仅支持现货，不支持永续合约；通过平台级正向服务区域许可名单（region_allowed: EEA30）限制，因此所有非 EEA 居住地（包括英国/瑞士，二者由单独且未建模的实体提供服务）均无法使用平台）、Finst（v0.43：2022 年创立于阿姆斯特丹，团队成员曾任职于 DEGIRO；这是模型中首个经纪/SOR 平台，而非订单簿交易所——持有 AFM MiCA CASP #41000015 牌照并可在 EEA 范围内提供服务；所有买入/卖出/兑换统一收取 0.15% 固定费率，无 Maker/Taker 区分、无等级阶梯、无价差加价；模型将其设为单一且不随交易量变化的阶梯档位；SEPA/SEPA Instant/iDEAL/Bancontact 欧元双向转账均免费，不支持银行卡/PayPal/美元/英镑；BTC 提现费为 0.000085（动态网络费约为 0.00005，另加 €2.50 固定第三方费用，已计入原生费用）；不支持其他资产；仅支持现货；通过相同的 region_allowed: ["EEA"] 限制为仅面向 EEA 用户——如今 EEA 现货平台共有 9 家；无推荐计划，无公开交易 API，因此不支持账户手续费查询）、Bitpanda（v0.44：2014 年创立于维也纳；这是模型中首个按价差定价的经纪平台，而非订单簿平台——持有 BaFin MiCA CASP 牌照（2025-01-27），可在 EEA30 范围内提供服务，另有奥地利 FMA 和英国 FCA 实体，用户超过 740 万；面向消费者的应用将费用计入总价加价：标称每侧 1.49%；BTC 和主流稳定币交易对通过交易对覆盖规则降至每侧 0.99%；市值低于 €100M 的小盘币为 2.49%——无 Maker/Taker 区分、无交易量阶梯；采用 pricing_model: "spread"，将价差基准固定为 0 个基点以防重复计费；并提供 execution_quality 证据（标称往返费用为 2.98%，TUM 实盘测得 6.23%，隐藏费用为 4.25 个百分点；法兰克福金融管理学院于 2026-03 复测）；EUR 入金支持 SEPA/SEPA Instant/银行卡（仅入金）/PayPal/Apple-Google Pay，均免费；自 2026 年起，GBP 支持 FPS/银行卡；无 USD 通道；BTC 提现费为 0.00000598（约 $0.46），ETH 提现费为 0.0006（约 $1.51），均按动态网络成本转嫁；仅支持现货；服务范围为 EEA30+GB，通过 region_allowed: ["EEA","GB"] 限制（GB 为单成员地区键）——如今 EEA 现货平台共有 10 家，且包含 GB 用户，不同于 Bitvavo/Finst；不对独立的 Fusion 专业交易所、股票/金属和 10 倍杠杆保证金交易建模；无推荐计划，无 ccxt 类，因此不支持账户手续费查询）、BISON（v0.45：2019 年创立于斯图加特，隶属 Boerse Stuttgart Group——模型中的第 18 家平台，也是第二家按价差定价的经纪平台——EUWAX AG 作为交易对手方报价（无订单簿，报价有效期约 10 秒）；Boerse Stuttgart Digital Custody 于 2025-01-17 获得首个 BaFin MiCA 托管/转账牌照，EUWAX 的交易所服务自 2025-04-01 起获得 MiCA 授权，活跃用户超过 100 万；面向消费者的应用通过交易对覆盖规则，对 BTC/ETH 收取每侧 1.25%，对其他所有币种收取每侧 1.75%（往返费用约为 2.5%/3.5%）——无 Maker/Taker 区分、无阶梯；采用 pricing_model: "spread"，将价差基准固定为 0 个基点；并提供 execution_quality 证据（标称费用为 2.5%，TUM 实盘测得 2.58%，仅隐藏约 0.08 个百分点——在受测的六个平台中，公开费用与实测费用最为接近）；EUR 的 SEPA/SEPA Instant 双向转账免费（包括瑞士用户），银行卡/Apple/Google Pay 仅支持入金，费用为 2.49%；无 GBP/USD/CHF 通道；BTC 和 ETH 链上提现官方免费，费用为 0（网络成本由集团承担；最低提现额为 0.001 BTC，不支持 Lightning/Taproot；ETH 仅支持主网，不支持 L2）；仅支持现货，不支持期货/保证金交易；服务范围为 EEA30+CH，通过 region_allowed: ["EEA","CH"] 限制（CH 为新增的单成员地区键）——如今 EEA 现货平台共有 11 家，CH 地区共有 15 家，GB 则无法使用（与 Bitpanda 的覆盖范围形成互补）；不对德国股票/ETF（每笔订单 €1.99）和 27% 质押佣金建模；支持邀请好友，但无联盟推广 URL，无 ccxt 类，因此不支持账户手续费查询）。各交易所的推荐链接均为可选——工具会对比所有具有手续费数据的交易所，仅在配置了链接时才附加 referral_url / referral_discount（Kraken、Coinbase、Hyperliquid、BingX、Phemex、BloFin、Bitstamp、Bitvavo、Finst、Bitpanda 和 BISON 均无此类链接）。

Fee-model inputs

• monthlyVolumeUsd / volume — 按交易所确定正确的 VIP 等级。
• tokenBalance（可选） — 原生代币持仓，遵循交易所特定的阶梯规则（已根据官方费率页面核实，截至 2026-09）：
  • Binance 现货 — AND 门槛： VIP1 及以上需要同时达到交易量门槛和 BNB 持仓门槛（VIP1 = $1M + 5 BNB … VIP9 = $4B + 5,500 BNB）。省略此参数 → 报价为交易量对应的等级，并附带 tier_warning；传入 0 → 等级会下调，并按实际情况计价。（Binance 合约没有持仓门槛。）
  • Gate 现货 + 合约 — OR 双轨： VIP 等级取 30 天交易量阶梯和 GT 持仓阶梯中较高者（VIP1 = $1M 或 1,000 GT … VIP9 = $1B 或 200,000 GT）。GT 只会提升等级，不会降低等级；结果包含 next_tier 升级提示。GT 持仓还可解锁费用支付折扣（100/500/2000/20000 GT → 10/20/35/50%）。
  • KuCoin 现货 + 合约 — OR 三轨（v0.13）： VIP0–VIP12，等级取 30 天现货交易量阶梯、30 天合约交易量阶梯（现货/合约门槛不同，按产品分别应用）或 KCS 持仓阶梯中较高者（VIP1 = 1,000 KCS … VIP12 = 150,000 KCS）。KCS 只会提升等级，不会降低等级；结果包含 next_tier / requires_kcs 升级提示。KuCoin 现货交易对分为 A 类（流动性高的主流币种 — 报价所依据的阶梯）、B 类（费率恰为 A 类的 2 倍）和 C 类（费率恰为 A 类的 3 倍）；现货结果包含 spot_class_note，提醒调用方检查交易对所属类别。合规说明：KuCoin 在 US、CN、HK、SG、TH 会被过滤。
  • Kraken 现货 + 合约 — 统一的 17 级三轨（v0.14）： 自 2026-07-09 起，Kraken Pro 对两种产品使用同一套等级（Tier 1–12，然后是 Pro 1–5），等级取 30 天现货交易量轨、30 天合约交易量轨（两种产品的门槛不同）或通过 accountAssetsUsd 传入的实时**平台资产（AOP）**中最高者决定（Tier 3 = $20k AOP … Tier 9 = $1M … Pro 5 = $100M）。Tier 1–2 没有资产路径 — 持仓从 Tier 3 开始。现货费率从 Tier 1 的 0.40%/0.80% 降至 Pro 5 的 0%/0.05%；合约费率从 0.02%/0.05% 降至 -0.006%/0.0125%，从 Tier 11 起提供负 maker 返佣。Kraken 没有原生代币（因此 useToken 始终不适用），也没有推荐链接。所有 Kraken 结果都包含 exchange_notes，说明资格认定的注意事项（单一交易量输入的局限、美国/加拿大/新西兰的合约跨产品资格认定、消费者应用与 Pro 定价差异）。合规性：Kraken 在 US（现货；受 CFTC 监管的 Kraken/Bitnomial 永续合约覆盖 47 个州）、HK、JP、TH 提供服务，在 CN 和 SG 受限。
  • Coinbase 现货 — 仅按交易量划分等级（v0.19）： Advanced Trade 报价为纯订单簿 maker/taker 费率，基于所有交易对的 30 天滚动美元交易量，每小时刷新（Tier 1 = 0.40%/0.60% … Tier 2 = $10k 时为 0.25%/0.40% … Tier 9 = $400M 时为 0%/0.04%）。资格认定仅依据交易量 — 没有持仓轨、没有原生代币，因此 tokenBalance/useToken 始终不适用，并且会忽略 accountAssetsUsd。Coinbase 是仅支持现货的交易平台：在合约费用比较和实时资金费率获取中会自动排除（零售 nano BTC/ETH 永续合约未纳入模型）。现货执行成本采用 2.0 bps 的典型全价差基准（实时模式会遍历 coinbaseexchange 订单簿）；提现路由覆盖 BTC / ETH / USDT（ERC-20、Base、Solana）/ USDC（Base 免费、ERC-20），并提供动态 Gas 费用说明。合规性：为 US 和 SG 居民提供服务，在 CN、HK、TH、JP 受限。
  • Hyperliquid 现货 + 合约 — 14 天交易量等级 + 质押 HYPE 折扣（v0.20）： 首个 DEX 平台 — 完全链上的 L1 订单簿（HyperCore），交易 Gas 费为零，提供 USDC 保证金永续合约和 USDC 报价现货订单簿（通过 Circle CCTP 入金，最低 5 USDC）。等级基于14 天滚动加权交易量窗口每日刷新（现货交易量按 2 倍计入 — 不同于其他平台使用的 30 天窗口，因此交易节奏稳定的用户实际等级可能低一档）：Tier 0 时合约费率为 0.045%/0.015%，逐步降至 Tier 6（$7B）时的 0.024%/0%；现货费率从 0.070%/0.040% 降至 0.025%/0%；从 Tier 4 起 maker 费率为普通的零（不是负值）。资格认定仅依据交易量 — 持有 HYPE 绝不能获得更高等级。质押 HYPE 阶梯（10/100/1k/10k/100k/500k HYPE → 所有 maker+taker 费用均折扣 5/10/15/20/30/40%，适用于现货和永续合约）会与交易量等级乘法叠加；传入 useToken + tokenBalance 时，持仓量必须是质押数量（仅持有 HYPE 没有折扣）。资金费率每小时结算 — 捆绑费率 0.00125%/1h 等于 CEX 平台相同的中性平均费率 0.01%/8h，且支持实时模式。提现：转至 Arbitrum One / 22+ CCTP 链的单一固定路由，费用约为 1 USDC（仅支持 USDC，不支持 USDT 路由；入金免费）。典型 BTC 永续合约价差为 0.8 bps（捆绑基准；实时模式会遍历 hyperliquid 订单簿）。无需 KYC，没有法币通道，也没有推荐链接。合规性：美国前端受地理位置限制（服务条款限制名单）；可从 CN、HK、SG、JP、TH 访问。
  • BingX 现货 + 合约 — VIP Club 阶梯，含仅按交易量划分的 Elite 等级（v0.21）： 每种产品都有 8 档阶梯（Regular → Elite → VIP1–5 → Supreme），30 天交易量门槛按现货和合约区分。合约在 Regular 档的费率为 0.020%/0.050%，在 Elite 档（$5M，2026-06-26 新增）为 0.018%/0.045%，在 Supreme 档（$500M）降至 0%/0.025%；现货在 Regular 档的费率为 0.10%/0.10%，在 Elite 档（$0.5M）为 0.05%/0.08%，在 Supreme 档（$15M）降至 0.005%/0.02%。资格等级取三条轨道中最高者 — 30 天现货交易量、30 天标准合约合约交易量，或通过 accountAssetsUsd 传入的前一日账户资产（合约 VIP1 = $50k … VIP5 = $3M；等级每天 03:00 UTC+8 刷新）。Elite 和 Supreme 档仅依据交易量 — 资产可将等级提升至 VIP1–VIP5，但永远无法提升至 Elite 或 Supreme（即使账户有 $10B，最高也只能达到 VIP5）。VIP4/VIP5/Supreme 还要求 API 交易量占总交易量的比例 ≤20%（引擎默认满足此条件）。仅支持平仓的标准合约跟单交易产品（固定费率 0.045%）未纳入模型 — 阶梯针对标准合约订单簿产品。没有原生代币（因此 useToken 始终不适用），没有推荐链接，也没有直接法币通道（仅支持 P2P/第三方网关）。资金费率每 8 小时结算一次，采用标准中性平均费率 0.01%（实时模式通过 bingx ccxt 类支持）；捆绑的典型 BTC 价差为 4 bps。提现覆盖 BTC / ETH / USDT / USDC，并支持 TRC-20/ERC-20/BEP20/Arbitrum/Optimism/Base/Polygon/Solana/TON/Aptos 等网络，按链标注暂停的路由（例如 USDC-TRC20、USDT Avalanche-C/opBNB）。所有 BingX 结果都包含六条 exchange_notes（轨道、仅按交易量划分的等级、API 比例规则、排除标准合约、无代币/推荐链接、来源核实）。合规性：在 US、CA、GB、CN、HK、SG 受限；MiCA 过渡期结束后（v0.41，奥地利 FMA 的申请仍仅处于“进展顺利”阶段，尚未获批），在整个 EEA 均无法使用；在 JP、TH、AU、BR 和其他非 EEA 国家提供服务。
  • BloFin 现货 + 合约 — 三轨 OR 六级阶梯（v0.37）： BuildLight Future Limited（开曼群岛/马绍尔群岛），衍生品自 2023 年 1 月起上线，永续合约 24 小时成交额约 $1.2B（CoinGecko），由 Fireblocks 托管，获得 ISO 27001 认证，每月提供 1:1 储备金证明；无需 KYC（未经验证的提现限额为每天 20,000 USDT）。每种产品有六个等级，资格取三条轨道中最高者 — 30 天合约交易量、30 天现货交易量，或通过 accountAssetsUsd 传入的每日快照账户资产（等级每天 00:00–12:00 UTC 刷新）：合约从 Regular 0.020%/0.060%（交易量 <$10M 且资产 <$50k）到 VIP1 $10M 或 $50k 资产时的 0.006%/0.050%（资产轨道的费率异常低），再到 VIP5 $500M/$3M 时的 0%/0.035%；现货从 0.10%/0.10% → VIP1 $1M/$50k 时的 0.035%/0.06% → VIP5 $8M/$3M 时的 0.01%/0.0325%。VIP4/VIP5 还要求符合条件的交易量中 ≥80% 来自非 API 交易（默认满足，引擎会在说明中提示此限制）。单一的 monthlyVolumeUsd 会按所查询产品自身的门槛匹配 — 不支持跨产品资格认定（例如用合约交易量提升现货等级）。没有原生代币（不支持 useToken），没有运营方推荐链接，也没有直接法币通道（仅提供 Checkout.com/Simplex/Alchemy 第三方小组件）。资金费率每 8 小时结算一次（00/08/16 UTC），采用中性平均费率 0.01%；捆绑的典型 BTC 永续合约价差为 3 bps。提现按实际网络成本动态收取，不加收交易所费用：BTC 约 0.0002，USDT/USDC TRC-20 固定约 1，ETH ERC-20/L2（Arbitrum/Optimism）约 $0.5–2。合规性：在 US、CA、CN、SG 受限；由于未能在 2026-07-01 MiCA 过渡期结束前获得 MiCA CASP 授权，在 EEA 受限 — 模型明确将 DE 标为受限；在 HK、JP、TH、GB、BR 和其他 150 多个国家提供服务。
  • Bitstamp 现货 + 合约 — 仅按交易量划分的 11 级现货阶梯 + 仅面向欧盟地区的受监管永续合约，具有平台×国家产品门槛（v0.38）： 2011 年创立于卢森堡（模型中历史最悠久的交易所），2025 年被 Robinhood 收购（约 $200m）；受欧盟 MiCA CASP 护照制度监管（卢森堡 CSSF），并持有美国 NYDFS BitLicense 和 40 多个州的 MTL、英国 FCA、新加坡 MAS 以及加拿大注册资质 — 是模型中的合规标杆平台。现货 PRO/API 费用采用单一的 30 天美元成交额轨道，不设资产或代币轨道：低于 $10k 时为 0.30%/0.40% → $10k 时为 0.20%/0.30% → $100k 时为 0.10%/0.20% → ≥$1B 时为 0.00%/0.03%（共 11 档）；不纳入基于价差定价的消费者 Basic 界面，也不纳入首笔 $1,000 交易免费的促销优惠，或外汇/稳定币/USDT 半价费率子计划。受监管的美元保证金永续合约采用单一固定等级：−0.005% maker（返佣）/0.015% taker，点对点资金费率每 8 小时结算一次（UTC 00:00/08:00/16:00），平台不抽取比例费用（捆绑平均值为 0.01%）。由于永续合约仅面向符合条件的 EEA 居民提供，Bitstamp 自 v0.40 起采用由正向地区允许名单支持的按产品门槛 — product_region_gates.bitstamp.futures = ["EEA"]，对应 regions.EEA 成员表（30 个 EEA 国家：EU27 + Iceland/Liechtenstein/Norway）。平台级访问权限（现货）对 US、GB、CA、JP、SG、HK、TH、DE 和兜底默认项开放，对 CN 则受限；futures 对 EEA 以外所有居住地的用户均禁止使用该产品，包括有明确键值的市场（US/GB/CA/JP/SG/HK/TH）以及通过 default 路由的未建模国家（AU/BR/CH/TR/KR/MX/IN/…）（交易工具返回 PRODUCT_BLOCKED_IN_COUNTRY，而 compare_countries 会将其列在 unsupported_product 下，而不是 blocked）；EEA 成员国可以使用两种产品。此规则取代了 v0.38 的负向名单默认键值设置，该设置会向没有明确条目的非 EEA 国家开放过多永续合约。产品门槛刻意不应用于 get_withdrawal_fees、get_fiat_cost 或 get_referral_link — 美国用户仍可使用 Bitstamp 现货、提现和法币通道。法币通道丰富：美国 ACH 存取款均免费；SEPA EUR 入金免费/提现固定 €3；国际 SWIFT USD/EUR/GBP 入金 0.05%（最低 $7.5，最高 $300）/提现 0.1%（最低 $25）；银行卡 USD/EUR/GBP 入金约 4%。提现费用较高，且主要依赖 ERC-20：BTC 0.0005（不支持 Lightning），ETH 0.005，仅支持 ERC-20（不支持 L2），USDT 固定 20，仅支持 ERC-20（不支持 TRC-20/Solana — 是模型中最贵的 USDT 路由；EU 不能在交易所直接交易 USDT），USDC 4，支持 ERC-20（以及未单独建模的 Solana/Arbitrum/Polygon/Optimism/Avalanche/Stellar 路由）。捆绑的典型主流币对现货价差为 2 bps，与 Coinbase Advanced 相当。没有原生代币（不支持 useToken），也没有推荐链接。
  • Bitvavo 现货 — 九档 EUR 交易量 PRO 阶梯 + 平台级 EEA 服务地区允许名单（v0.42）： 2018 年创立于阿姆斯特丹；Bitvavo B.V. 在 MiCA 框架下于荷兰 AFM 注册为加密资产服务提供商（#41000010），并获得 EEA 护照资质（超过 400 万用户，在以 EUR 计价的现货交易量中占据主导份额）。与此前所有门槛（负向 region_blocked 禁用名单或产品级 product_region_gates）不同，Bitvavo 使用平台级正向服务地区门槛 — region_allowed.bitvavo = ["EEA"]，对应 regions.EEA（30 个国家）：只有 EEA 居民可以注册使用平台，其他所有居住地——无论是有明确键值的市场还是默认键值国家，包括现实中由 Bitvavo 独立实体服务、但模型刻意不纳入的 GB/CH——均受平台级限制（COUNTRY_BLOCKED）；即使某个国家遗留的 allowed 条目允许访问，白名单匹配仍会覆盖该设置。各平台的门槛优先顺序：region_blocked 禁止 → 国家 blocked → 命中 region_allowed 白名单（授权）→ 未命中白名单（拒绝）→ 国家级 allowed 枚举（为空 = 开放）；没有对应条目的国家默认安全拒绝。费率采用 PRO/API 订单簿价格表，按单一的 30 天滚动 EUR 交易量轨道计算（门槛视为 USD 等值）：九档费率依次为 0.15%/0.25%（低于 €100k）→ 0.10%/0.20% → 0.08%/0.16% → 0.06%/0.12% → 0.05%/0.10% → 0.04%/0.08% → 0.04%/0.06% → 0.00%/0.05% → 0.00%/0.02%（≥€25M，主流币）；没有原生代币或资产轨道，也不纳入消费者 Basic 界面（嵌入价差定价；2026 年 TUM 研究测得约 0.08 个百分点的隐性加价）。Bitvavo 仅支持现货 — 不提供永续合约，因此不会出现在任何合约费用汇总/资金费率获取中；对于 EEA 合约用户画像，它会在 compare_countries 中显示为 unsupported_product（不是 blocked）；在 EEA 之外则显示为 blocked。EUR 订单簿以 EUR 而非 USDT 报价，模型中的典型价差最低：主流币为全价差 1.0 bps / 穿价成本 0.5 bps（Kaiko 在 2026-05 测得 0.981 bps，为所有欧洲平台中最低；长尾山寨币会根据交易对类别乘数扩大）。法币：SEPA/SEPA Instant EUR 存取款均免费（iDEAL 和 Bancontact 通过 SEPA；每日提现上限 €25,000）；欧盟发行的银行卡入金约 1%（第三方来源为 0.5–1.5%，模型采用中值），不支持银行卡提现；提及 PayPal（约 2%），但未纳入模型；不支持 USD/GBP 通道。提现：仅支持动态网络费用的 BTC，模型费用为 0.00005 BTC（不支持 Lightning；已舍弃一个聚合网站给出的异常低报价 0.0000063）——其他所有资产（USDT/USDC/ETH/…）均返回 supported: false，而不是编造费用。现货账户费率查询通过 bitvavo ccxt 类支持。
  • Finst 现货 — 固定费率 SOR 经纪服务 + 平台级 EEA 允许名单（v0.43）： 2022 年由一支前 DEGIRO 团队创立于阿姆斯特丹（KvK 85668117）；Finst B.V. 持有 AFM MiCA CASP 注册资质 #41000015（2025-07 获批），获得 EEA 护照资质，服务约 30 个欧洲国家。Finst 并非订单簿交易平台，而是一个通过智能订单路由聚合外部流动性的经纪服务（400 多个 EUR/USDC 市场），所有买入/卖出/兑换/自动投资统一收取固定 0.15% — 不区分 maker/taker，没有交易量阶梯或最低限额，也声称不加收价差。因此模型使用不受交易量影响的单一档位（tier: "Flat 0.15%"，所有交易量下 maker = taker = 0.15%；单调阶梯审计可直接通过），并采用 全价差 1.0 bps / 穿价成本 0.5 bps 的群组价差代理值（SOR 平台没有订单簿研究数据）。访问权限采用与 Bitvavo 相同的平台级正向门槛 — region_allowed.finst = ["EEA"] — 因此只有 30 个 EEA 国家会显示该平台的定价（EEA 现货汇总增至 9 家：bitstamp、bitvavo、bybit、coinbase、finst、gate、hyperliquid、kraken、okx）；其他所有居住地（包括 GB/US/CH/JP/AU/BR）都会将其视为平台受限/不可用。Finst 完全不提供衍生品 — futures: [] 表示不会触发监管产品门槛（在 EEA 内 isVenueUsableFor 仍为 true，与 Coinbase/Bitvavo 语义一致），但该平台不会出现在任何合约定价汇总中；compare_countries 会将其列为 EEA 合约用户画像的 unsupported_product，并在 EEA 以外列为 blocked。法币：仅提供 EUR SEPA 通道（SEPA Instant/iDEAL/Bancontact），存取款均免费；不支持银行卡通道（明确查询 method: "card" 时会返回该平台，available: false / 路由为空 — 对 EEA 国家仍保留在比较数组中，但绝不会成为 best）；不支持 PayPal 或 USD/GBP。提现：官方费率为动态网络费实报实销，每笔加密货币提现另收固定 €2.50 第三方费用；WithdrawalFee 没有附加费字段，且刻意不扩展 schema，因此 BTC 路由按全包价格 0.000085 BTC / ≈$6.57 建模（典型网络费约 0.00005 BTC ≈$3.86，按 $77,298 快照计算 + €2.50 ≈$2.72，按 0.92 EUR/USD 计算），路由 note 会说明两项费用；其他 400 多个市场均返回 supported: false。入金免费；模型不涵盖的产品线（Bundle 每月 0.10% 管理费、质押收益分成 25–45%、新用户 €10k/2 周免费期）不在范围内。Finst 没有公开交易 API，ccxt 4.5.x 不包含 finst 类，因此 get_account_fee_tier 返回 ACCOUNT_FEES_UNSUPPORTED（矩阵会刻意省略此平台；缺少规格的路径会将其判为不支持），也没有推荐链接。
  • Bitpanda 现货 — 内嵌溢价的价差经纪服务 + 实测与宣传的执行成本证据（v0.44）： 2014 年创立于维也纳；Bitpanda GmbH 持有 BaFin MiCA CASP 授权（2025-01-27），该授权适用于全部 30 个 EEA 国家；还持有奥地利 FMA 牌照，并通过在 FCA 注册的 Bitpanda Broker UK Ltd 服务英国（约 740 万用户）。消费者应用不是订单簿交易平台：它报价一个包含费用的全包价格，费用以加价形式内嵌，不单独列出佣金。schema 新增第三种定价模式 — pricing_model: "spread"，与 "order_book" 和 "flat" 并列 — 对大多数资产采用与交易量无关的单一档位，maker = taker = 1.49%；交易对级覆盖规则对 BTC 和主要稳定币交易对按每边 0.99% 收费（BTC/EUR、BTC/GBP、BTC/USDC、BTC/USDT 以及稳定币 EUR/GBP 交叉交易对），而普通山寨币仍为 1.49%；说明中会披露官方的市值低于 €100M 资产 2.49% 费率区间和 1.99% 加密货币指数费率区间（不单独设档），以及消费者应用的 10 倍保证金产品（未纳入模型）。由于加价本身就是穿价成本，spread_baseline.bitpanda 固定为 全价差/穿价成本均为 0 bps，且 getSpreadEstimate 会提前返回 0 — 该防重复计费保护可避免 1.49% 溢价再次计入 annual_spread_cost。平台费率规格中的新增 execution_quality 对象记录了独立的真实交易证据：advertised_roundtrip_pct: 2.98，而 TUM 测得 €100 往返交易的平均费用为 6.23%（2025 年 10–11 月，每个平台 50 笔往返交易）— 未披露费用高出 4.25 个百分点 — 该结果在 2026-03 的法兰克福金融管理学院研究中得到复现（覆盖 9 个平台的 432 笔往返交易）；叙述内容会自动附加到 exchange_notes。访问权限采用平台级正向门槛 — region_allowed.bitpanda = ["EEA","GB"] — 其中 GB 被建模为单成员地区键（regions.GB = ["GB"]）：通过命中白名单，GB 可使用现有门槛逻辑授权，无需修改门槛代码；US/CA/CN/CH 和其他所有居住地均受平台级限制。EEA 现货汇总增至 10 家（bitstamp、bitpanda、bitvavo、bybit、coinbase、finst、gate、hyperliquid、kraken、okx），并为 GB 提供服务（不同于 Bitvavo/Finst）；futures: [] 表示合约用户画像在服务区域内会看到 unsupported_product，在其他地区则为 blocked。专业版 Bitpanda Fusion 交易所（聚合外部流动性，费率 0.02–0.25%）是独立产品，刻意未纳入模型；代币化股票/ETF/金属不在范围内。法币：自 2026 年起，所有消费者应用通道均免费 — EUR SEPA/SEPA Instant、Visa/Mastercard 银行卡（仅支持入金；提现腿建模为 null）、PayPal、Apple/Google Pay，以及 GBP FPS + 银行卡；不支持 USD 通道（未指定国家的 USD 查询会保留该行，并返回 available: false / 路由为空）。提现按实际网络费动态收取，不加价；仅对 BTC 0.00000598 BTC（按 $77,298 快照计算为 $0.4622） 和 ETH 0.0006 ETH（$1.5072） 建模 — JSON 刻意不包含 fee_usd 字段，由引擎根据 asset_prices_usd 重新计算；其他资产均返回 supported: false。没有推荐计划；ccxt 4.5.x 不包含 bitpanda 类，因此 get_account_fee_tier 返回 ACCOUNT_FEES_UNSUPPORTED（实时覆盖率仍为 17 家中的 13 家）。
  • BISON 现货 — 自营商价差经纪服务，宣传与实测高度吻合，链上提现免费（v0.45）： 2019 年由 Boerse Stuttgart Group 在斯图加特推出（截至 2026-01 活跃用户超过 100 万，支持 56 种加密货币）；交易对手方是以自身名义报价的 EUWAX AG — 报价有效期约 10 秒，且没有订单簿。资产由 Boerse Stuttgart Digital Custody GmbH（前身为 blocknox）托管，该公司持有首个 BaFin MiCA 加密资产托管/转账牌照（2025-01-17，护照资质覆盖 29 个国家）；EUWAX AG 的加密货币交易所服务自 2025-04-01 起获得 MiCA 授权（护照资质覆盖 8 个国家），并于 2025-11-21 起新增订单执行服务（仅限德国）。定价采用价差模式 — 除 BTC/ETH 外，所有加密货币均采用与交易量无关的单一档位，maker = taker = 1.75%；BTC/EUR 和 ETH/EUR 交易对每边费率覆盖为 1.25%（费率随市场情况和订单金额浮动）；官方价差是唯一交易费用，没有单独佣金。与 Bitpanda 一样，spread_baseline.bison 固定为 0 bps，且 getSpreadEstimate 会提前返回 0，避免在 annual_spread_cost 中重复计算价差。execution_quality 模块包含研究中的透明度基准：advertised_roundtrip_pct: 2.5，TUM 实测为 2.58% — 在 12 个交易日内进行的 50 笔标准化 €100 往返交易中，仅有 0.08 个百分点未披露（2025 年 10–11 月，覆盖 6 个 MiCA 平台；BISON 包含在这 6 个平台的样本中），是样本中已公布与实测结果最接近的平台（其次是 Bitvavo，差异 −0.58%；Bitpanda 为 6.23%，Coinbase 为 7.49%）。访问权限采用平台级正向门槛 — region_allowed.bison = ["EEA","CH"] — 并将 CH 加为第二个单成员地区键（regions.CH = ["CH"]）：全部 30 个 EEA 国家和瑞士均可使用该平台（DE/AT/CH 主动推广；其他 EEA 国家依据条约赋予的自由被动提供服务），而 GB 受平台级限制 — 与 Bitpanda（EEA+GB）形成刻意互补 — US/CA/JP/SG/AU/BR/CN/KR 等地区也同样受限；EEA 现货汇总增至 11 家，CH 汇总增至 15 家，GB/US/JP 的结果中不会出现 BISON。futures: []（不提供平台运营的合约或保证金交易）→ 服务区域内显示 unsupported_product，区域外显示 blocked。法币仅支持 EUR：SEPA/SEPA Instant 存取款均免费，包括使用 EUR 入金的瑞士用户（因瑞士属于 SEPA 但不在 EU 地区表中，因此建模为不绑定地区的路由，再由平台允许名单控制）；另支持 2.49% 即时银行卡/Apple Pay/Google Pay 入金（Solaris SE/Deutsche Bank 合作方费用；提现腿为 null — 不支持银行卡提现）；不支持 GBP/USD/CHF 通道（未指定国家的 USD 查询会保留该行，并返回 available: false）。提现官方免费，不收网络费 — 链上成本由 EUWAX/集团承担（与 Bitpanda 的费用转嫁政策有本质区别）——仅对 BTC 0 BTC / $0（最低 0.001；不支持 Lightning 或 Taproot bc1p 提现）和 ETH 0 ETH / $0（仅支持 Ethereum 主网，最低 0.01；不支持 Arbitrum/Base/Optimism/Polygon/BNB Chain L2）建模，因此 BISON 是这两种资产的全球 best；其他所有资产均返回 supported: false，且提现比较刻意不按国家限制。德国股票/ETF €1.99 固定订单费和 ETH/SOL 质押收益 27% 佣金不在范围内。邀请好友计划（DE/AT/CH ETH 奖励）没有联盟链接，ccxt 4.5.78 不包含 bison/euwax 类，因此 getReferralLink 返回 NO_REFERRAL_LINK，get_account_fee_tier 返回 ACCOUNT_FEES_UNSUPPORTED（实时覆盖率仍为 18 家中的 13 家）。
• accountAssetsUsd（可选，适用于 OKX / Bybit / Bitget / Kraken / BingX / BloFin） — 账户资产总额（美元）。现货和合约的 VIP 等级均取 30 天交易量阶梯与资产阶梯中较高者（例如 OKX VIP1 = $100k … VIP9 = $500M，且有负 maker 返佣；Bybit VIP4 = $1M；Bitget VIP1 = $30k；Kraken Tier 3 = $20k AOP … Pro 5 = $100M；BingX VIP1 = $50k … VIP5 = $3M；BloFin 的 VIP1 = $50k … VIP5 = $3M，按各产品自身门槛计算）。资产只能提升等级，不能降低等级；仅按交易量划分的档位（例如 Bybit Supreme、Kraken Tier 1–2、BingX Elite 和 Supreme）不能通过资产满足资格；BloFin VIP4/VIP5 还要求 ≥80% 的交易量来自非 API 交易（引擎默认满足，注意事项见 exchange_notes）。省略此参数时，返回交易量对应的等级和资产路径升级提示（next_min_assets）。
• pair（可选，v0.12） — 交易对，例如 BTC/USDT、BTC/FDUSD 或 BTCUSDT（会标准化分隔符）。如果交易对有已知费率促销，则促销费率会取代账户等级费率，结果包含 pricing_basis: "pair" 和 pair_note；否则定价仍依据 account_tier。已核实的交易对促销：MEXC — 所有现货交易对均为 0% maker + 0% taker（零费率计划）；100 多个合约交易对费率为 0/0，但受单账户配额限制；Binance — FDUSD 交易对（BTC/ETH/BNB/DOGE/LINK/SOL/XRP）maker 为 0%，taker 按等级计费；USDC 交易对 maker 为 0%，taker 为 0.095%；Bitget — USDC/USDT 和 USDGO/USDT 均为 0/0（交易量不计入 VIP）；Bitpanda（v0.44） — BTC 和主要稳定币交易对的内嵌溢价为每边 0.99%，而非宣传的 1.49%（这是价差经纪服务的定价档位，不是促销；非促销标记）；Bison（v0.45） — BTC/EUR 和 ETH/EUR 的费率为每边 1.25%，而非宣传的 1.75%（同属非促销价差定价档位）。交易对覆盖规则可以仅覆盖 maker、仅覆盖 taker，也可以两者都覆盖。
• makerShare（0–1，默认 0） — 以 maker 方式执行（限价订单）的交易量比例。加权费率 = maker × share + taker × (1-share)。限价订单交易者应传入 0.7–1。
• useToken — 采用原生代币折扣定价：BNB（现货 25% / 合约 10%）、GT（合约 maker 费率降至 0，另根据 tokenBalance 享有 10–50% 的持仓等级折扣）、MX（现货 + 合约 20%；持有 500+ MX 可将折扣提高至 50% — 两者取较高者，不叠加）、BGB（现货 + 合约 20%）、KCS（现货 A/B/C 类 + 合约 20%；VIP8 及以上 maker 费率已为 0%，因此仅 taker 费率受益），OKB（已计入 OKX 等级），以及 Hyperliquid 上的质押 HYPE（质押 10/100/1k/10k/100k/500k 可使所有 maker+taker 费用折扣 5/10/15/20/30/40%，并与交易量等级乘法叠加；tokenBalance 必须是质押数量 — 仅持有没有折扣）。
• 负 maker 费率 — OKX VIP7 及以上的 maker 费率为负值（现货/合约，最低为 -0.0075%）；Kraken 合约 maker 费率从 Tier 11 起为负值（Pro 5 时最低为 -0.006%），即交易所向 maker 支付返佣。负费率不受推荐/代币折扣影响（折扣不会减少返佣），会以负费用估算值显示，并优先于收费费率。
• holdingHours（合约） — 月度持仓时长（小时）；按各交易所资金费率计算成本（大多数平台每 8 小时结算一次；Hyperliquid 每小时结算 — 其捆绑费率 0.00125%/1h 等于 CEX 平台的中性平均费率 0.01%/8h）。calculate_annual_cost 会将该值年化并乘以 12。每项资金费率数据都包含 funding_source（bundled 或 live）；使用实时数据时还包含 funding_rate_ts / funding_pair。
• fundingMode + fundingPair（可选，v0.15） — calculate_savings、compare_total_cost、recommend_exchange 和 calculate_annual_cost 的资金费率输入。fundingMode: "bundled"（默认）使用离线长期平均值（BTC/USDT 为 0.01%/8h — 即时且确定）。fundingMode: "live" 会通过 ccxt 实时获取 fundingPair 的平台当前资金费率（默认为 BTC/USDT；也接受 ETH/USDT、SOL-USDT、BTCUSD 等）。每家交易所都会独立获取，超时设为 8s；任何获取失败的平台（超时、地理位置限制、缺少交易对）都会透明回退到其捆绑平均值，并列入专用工具的 failures。结果会在内存中缓存 5 分钟（资金费率每隔几小时才结算一次）。负的实时费率会原样保留 — 此时多头可收取费用。独立的 get_funding_rates 工具接受 fundingMode、fundingPair、可选的 exchanges: [...] 和可选的 country 过滤条件。
• tradeSizeUsd + spreadMode + spreadPair + side（v0.16） — calculate_savings、compare_total_cost、recommend_exchange 和 calculate_annual_cost 的执行成本输入。传入 tradeSizeUsd（单笔可成交订单金额，例如 10000）时，每项成本结果都会加上该订单单向买卖价差穿越成本（典型全价差的一半），并附带 spread_source。spreadMode: "bundled"（默认）按离线平台基准值计价，并根据交易对类别调整 — 主流币（BTC/ETH）×1.0，大市值币（SOL/XRP/DOGE 等 27 个币种）×1.5，其他山寨币 ×3 — 模型滑点为零。spreadMode: "live" 会通过 ccxt 获取各平台的真实前 100 档订单簿，自动匹配正确的现货或线性掉期市场（KuCoin 现货使用 kucoin 类，而非 kucoinfutures），并根据 side: "buy" | "sell" 对深度进行 VWAP 遍历，测量超过最佳报价的订单规模相关滑点，同时返回 levels_consumed、available_depth_usd 和 fully_filled。单个平台获取失败（超时、地理位置限制、缺少市场）时会回退到捆绑基准值，并列入 failures；当可见深度小于订单金额时，保留测量值并添加 warnings 条目（不外推深度之外的价格影响）。订单簿遍历结果会缓存 30 秒。compare_total_cost 会将价差 + 滑点计入 total_cost；calculate_annual_cost 会按年度交易名义金额调整这两项成本（每月 ×12，假设交易流被拆分成 tradeSizeUsd 大小的订单）；recommend_exchange 会将执行成本纳入评分（当这些成本均适用时，费用 70% / 资金费率 15% / 价差 15%）。独立的 get_execution_cost 工具接受 tradeSizeUsd（默认 $10,000）、pair、purpose、side、spreadMode、可选的 exchanges: [...] 和 country。
• 法币入金/出金输入（v0.17，get_fiat_cost） — direction: "deposit" | "withdraw"（默认 deposit）、以法币计价的 amount 或 amountUsd（按静态显示汇率换算）、currency: "USD" | "EUR" | "GBP" | "BRL"（默认 USD）、country ISO 居住地（决定合规过滤和地区通道可用性 — 例如 Bybit 的欧盟发行银行卡费率为 1.1%，其他地区为 3.05%；ACH 仅限美国），可选的 method: "card" | "ach" | "sepa" | "fps" | "wire" | "swift" | "pix" 过滤条件，以及可选的 exchanges: [...]。仅对交易所直接运营的通道建模 — 第三方银行卡网关（Banxa/Simplex/MoonPay/Zen，通常在结账时收取 1.99–5.5%）、P2P 和银行端费用均按设计排除（这些费用因用户而异，并会在 advice/notes 中说明）。费用支持百分比 + 固定费用，并带有最低/最高限额（例如 Bybit SEPA 0.19%，最低 €1；Binance SWIFT 固定收取 5，最高 25）。结果返回每条通道的费用、美元等值、有效费率、到账金额、预计时间、每个平台最便宜的通道、全局 best、saving_vs_worst_usd 以及警告（没有符合条件通道的平台、缺少受地区限制通道所需国家）。各平台银行卡费率为 1.1–4.5%，而 ACH/SEPA/FPS/PIX 银行通道几乎都免费或费用极低。
• 全包成本工具中的法币交易环节（v0.26） — compare_total_cost 和 calculate_annual_cost 现在接受 fiatCurrency、fiatDepositAmountUsd + fiatDepositsPerYear、fiatCashoutAmountUsd + fiatCashoutsPerYear 和可选的 fiatMethod，并将最低的直接通道费用 × 每年交易次数计入总费用，分别记为 fiat_deposit_cost / fiat_cashout_cost（年化工具中为 annual_fiat_deposit_cost / annual_fiat_cashout_cost）。这能在一次调用中计入零售交易者实际承担的完整成本 — 交易费 + 资金费率 + 价差/滑点 + 链上提现 + 银行/银行卡存取款。真实存在的免费通道会返回费用 0，并设置 fiat_deposit_available: true；没有直接通道的平台（例如 Hyperliquid/BingX/Phemex/BloFin）会将该项排除（费用为 0），并设置 fiat_deposit_available: false，绝不会被默认为免费。若未传入法币交易习惯参数，则会省略这些键，行为保持不变。
• 考虑法币的推荐（v0.27） — recommend_exchange 接受相同的六个法币交易习惯参数，并将年化直接通道成本加入评分。法币权重由成本离散度决定：fiatWeight = 0.2 + 0.3 × dispFiat / (dispFee + dispFiat)，其中离散度是平台间的年化成本差距；因此当法币费率差异远大于交易费差异时（每月入金金额较小的用户），权重恰好从 0.2 升至 0.5；对于高交易量用户，权重维持在 0.2；剩余权重会重新分配至费用/资金费率/价差。没有法币通道的平台在相应方向得分为 0（真实免费通道得 100 分），并会明确说明可用的第三方/P2P 路径（通常收费 1.99–5.5%）；若推荐的平台在相同交易习惯下费用更高，建议还会指出法币费用最低的平台和年度差额。若不传入这些参数，评分结果与 v0.27 之前的权重表逐字节一致。翻转示例（v0.41 EEA）：DE 现货交易量每月 $500 + 每年 12 次 €1,000 SEPA 入金 — 不考虑此习惯时，没有法币通道的 Hyperliquid 会在符合 EEA 使用条件的平台中凭费用优势获得 100 分；考虑后，SEPA 存取款均免费的 OKX 得分 92.2，超过 Hyperliquid 的 62.7（Binance/MEXC 不再符合 EEA 使用条件）。
• withdrawalAsset + withdrawalNetwork（v0.18 网络覆盖） — 增加网络提现费用。捆绑费率表涵盖 16 种资产（BTC、ETH、SOL、XRP、DOGE、LTC、TRX、ADA、AVAX、DOT、LINK、BCH、TON、POL、USDT、USDC），覆盖 TRC-20、ERC-20、BEP20、Arbitrum、Optimism、Base、Polygon、Avalanche C、Solana、TON、Polkadot/AssetHub，以及全部 18 家平台各资产的原生链（各平台路由可用性不同；Coinbase、BingX、BloFin 和 Bitstamp 仅支持 BTC / ETH / USDT / USDC；Bitvavo（v0.42）仅对 BTC 建模，动态费率为 0.00005，其他资产均标为不支持；Finst（v0.43）仅对 BTC 建模，全包费率为 0.000085（动态网络费 + 固定 €2.50 第三方费用合并计算，并在每条路由的说明中披露），其他资产均不支持；Bitpanda（v0.44）仅对 BTC 0.00000598（$0.4622）和 ETH 0.0006（$1.5072）建模，按实际网络费动态收取 — 未存储 fee_usd，会根据价格快照重新计算；其他资产均不支持；Bison（v0.45）对 BTC 和 ETH 采用 0 费用 — 集团承担链上网络成本，因此这两种资产的全球 best 均为 Bison（BTC 主网最低 0.001；ETH 仅支持主网，最低 0.01，不支持 L2），其他资产均不支持；Hyperliquid 提供单一固定路由，费用约为 1 USDC，可转至 Arbitrum / 22 多条 CCTP 链；BloFin 按实际网络费用动态收取，TRC-20 稳定币约为 1）。原生计价单位的费用会根据 2026-09-12 价格快照（asset_prices_usd）换算为 USD。2026 年 8–9 月暂停的路由（例如五家平台的 TON 钱包、Gate/KuCoin/BingX 的 USDC-TRC20、DOT 中继链）会标记为 suspended: true，不会被视为开放路由。若未指定网络，则会自动按平台仍开放的最低费用路由计价；网络输入接受别名（trc20、erc20、arb、matic、sol 等）。calculate_annual_cost 会将单次提现费用乘以 withdrawalsPerYear。独立的 get_withdrawal_fees(asset?, network?, country?, exchanges?) 工具（完全离线）会返回完整的逐路由比较，其中包含 best、saving_vs_worst_usd 和警告；错误代码：INVALID_ASSET、INVALID_NETWORK、UNKNOWN_EXCHANGE。
• 交易者画像预设（v0.22，analyze_persona） — data/personas.json 中包含七种以研究为依据的交易者类型，每种都包含完整行为画像：市场（现货/合约）、月交易量、maker 占比、月持仓小时数、典型单笔订单金额（tradeSizeUsd）、提现资产与年度提现次数，以及年度法币存取款（币种 + 通道习惯）。画像包括 casual_buyer（小额银行卡入金买家 — 银行卡费用占主导）、hodler_accumulator（每月定投 + 提现 BTC 至冷钱包）、active_spot_trader、swing_futures_trader（资金费率是最大费用项）、day_scalper（高交易量，90% maker）、vip_institutional（每月 $30M、资产 $3M、单笔 $100k → 建议使用实时价差）和 dex_native（链上 USDC 资金流，无 KYC/法币需求 — 缺失的通道会标记，不会将费用置零）。每种画像都会使用其他工具分别计算的相同年化成本组合 — 交易费 + 资金费率 + 执行成本 + 每笔提现费用 + 法币费用 — 返回每个平台的 cost_mix_pct、component_leaders、标头推荐 best，以及单独的 best_complete：即为所有画像费用项均实际计价的平台中费用最低者（例如 Hyperliquid 可能成为合约用户画像的标头推荐，但缺少法币通道或 USDT/BTC 路由 — 结果会标记 withdrawal_unsupported/法币可用性，并显示包含额外费用的完整现实选项）。每个预设值都可通过 monthlyVolumeUsd、makerShare、useToken、tokenBalance、accountAssetsUsd、holdingHours、tradeSizeUsd、pair、currency 覆盖；也可通过 fundingMode/fundingPair 和 spreadMode/spreadPair 覆盖实时数据。所有画像均经过 schema 验证，并像其他数据文件一样进行版本管理。
• currency — 显示币种：USD（默认）、EUR、JPY、CNH、GBP。仅使用静态显示汇率；所有计算仍以 USD 为基础。
• language（v0.30，v0.31/v0.36 扩展） — compare_exchange_fees、compare_total_cost、calculate_savings、calculate_annual_cost、get_fiat_cost、get_withdrawal_fees、recommend_exchange、analyze_persona、compare_personas、analyze_token_discount、volume_what_if 和 compare_countries 的叙述层输出语言："en"（默认）或 "zh"。所有建议/警告/权衡/原因/等级警告均由集中式双语模板目录（src/i18n.ts）生成；英文输出与 v0.30 之前逐字节一致，数字、字段名、错误代码和面向机器的说明不受语言设置影响，因此切换语言不会更改数据 schema。
• format / tableMetric（v0.36，仅适用于三个矩阵工具） — compare_personas、volume_what_if 和 compare_countries 接受 format: "json"（默认）| "markdown" | "csv" | "both"。选择非 JSON 格式时，结果会新增 rendered: { metric, markdown?, csv? } 对象：可直接复制的带标题表格，语言由 language 决定，支持英文或中文；画像矩阵 = 平台 × 画像，以年度全包成本为指标（缺少通道的单元格仅在 markdown 中带 † 标记，CSV 保持数值）；情景分析 = 月交易量行 × 平台，tableMetric 支持 "weighted_fee_pct"（保留 4 位小数，默认）| "annual_fee_usd" | "tier"；国家矩阵 = 平台 × 国家，tableMetric 支持 "availability"（✓/⛔/–，默认；CSV 使用原始 available/blocked/unsupported_product 标记）| "cost"。CSV 符合 RFC 4180（含逗号/引号/换行的字段会加引号，" 会重复，行尾为 CRLF）；markdown 中的交易量采用紧凑格式（$100K/$3.5M），CSV 保留原始数字。无效值返回 INVALID_INPUT；任何格式下 JSON 负载本身都不会改变。
• 每项费用结果都带有 data_as_of 数据新鲜度时间戳、关于 BNB AND 门槛和 GT/KCS/账户资产/AOP OR 升级路径的 tier_warning，以及当捆绑数据距离 last_verified 超过 3 个月时提供的 freshness_warning。Kraken 结果还包含 exchange_notes — 交易所特定的资格认定注意事项（统一等级轨道、地区合约限制、Pro 与消费者应用定价差异）。

安装

在 Claude Desktop / Cursor / 任意 MCP 客户端中使用

添加到客户端的 MCP 配置中（例如 claude_desktop_config.json）：

{
  "mcpServers": {
    "fee-optimizer-mcp": {
      "command": "npx",
      "args": ["-y", "fee-optimizer-mcp"]
    }
  }
}

从源代码在本地运行

git clone https://github.com/gaokai258/fee-optimizer-mcp.git
cd fee-optimizer-mcp
npm install
npm run build
npm start        # starts stdio server (default)

Streamable HTTP 传输（v0.29）

除 stdio 外，该服务还可作为无状态 Streamable HTTP MCP 端点运行（MCP 2025-03-26 规范）——每次 POST 都会创建一个隔离的 MCP 服务，因此请求可安全并发处理，并可水平扩展，无需粘性会话；响应为纯 application/json，不会颁发 Mcp-Session-Id，而 SSE GET/DELETE 按设计返回 405。

# CLI flags
node dist/index.js --transport http --host 0.0.0.0 --port 3333 --endpoint /mcp
# or
npm run start:http

# env overrides: FEE_MCP_TRANSPORT=http, FEE_MCP_HTTP_HOST, FEE_MCP_HTTP_PORT,
#                FEE_MCP_HTTP_ENDPOINT (HOST/PORT also accepted)
node dist/index.js --help        # all flags

• POST /mcp — JSON-RPC（单条消息或批量消息）；需要 Accept: application/json, text/event-stream 和 Content-Type: application/json。由于服务完全无状态，因此无需握手即可直接发送 tools/call POST；严格的客户端也可以先通过单独的 POST 发送 initialize。
• GET /health — 负载均衡器探测：{ status, service, version, transport, mode, endpoint, auth_required, rate_limit_per_min, uptime_s }（即使启用了 bearer 认证，也无需认证）。
• 未知路径 → 404；对 /mcp 使用非 POST 方法 → 405，并附带 Allow: POST；Accept 无效 → 406。

公网托管加固（v0.32）

所有保护措施均通过环境变量选择性启用——本地/开发环境的行为不变。绑定到 0.0.0.0 时，请在前面配置一个终止 TLS 的反向代理（nginx/Caddy/Cloudflare）。

环境变量	作用
FEE_MCP_BEARER_TOKEN=<secret>	每个 MCP POST 都必须发送 Authorization: Bearer <secret>（采用恒定时间比较）。缺失或错误 → 401 + WWW-Authenticate（JSON-RPC 代码 -32002）。/health 仍可供探测使用。
FEE_MCP_RATE_LIMIT_PER_MIN=<n>	按客户端 IP 对 MCP POST 进行固定窗口限流；超出限制 → 429 + Retry-After（-32001）。未通过认证的尝试也会计入，因此不带令牌的洪泛请求无法绕过限制。0/未设置 = 不限流。
FEE_MCP_ACCESS_LOG=1	每个请求在 stdout 输出一行结构化 JSON：ts, ip, method, path, status, duration_ms, auth (none/ok/fail), rate_limited, user_agent。
FEE_MCP_TRUST_PROXY=0	忽略 X-Forwarded-For（仅在未使用反向代理时设置；默认信任 XFF 的第一跳）。

远程 MCP 客户端配置（使用 bearer token 的 HTTP）：

{
  "mcpServers": {
    "fee-optimizer-mcp": {
      "type": "http",
      "url": "https://your-host/mcp",
      "headers": { "Authorization": "Bearer <secret>" }
    }
  }
}

Docker

docker build -t fee-optimizer-mcp .                              # or: npm run docker:build
docker run -d --name fee-mcp -p 3333:3333 \
  -e FEE_MCP_BEARER_TOKEN=$(openssl rand -hex 32) \
  -e FEE_MCP_RATE_LIMIT_PER_MIN=120 \
  -e FEE_MCP_ACCESS_LOG=1 \
  fee-optimizer-mcp                                              # or: npm run docker:run
curl -s http://localhost:3333/health

多阶段镜像以非 root 用户在 node:22-alpine 上运行，仅包含生产依赖、dist/ 和 data/，并配置了 /health HEALTHCHECK。

使用 MCP Inspector 检查

npm run inspector                                   # stdio
npx @modelcontextprotocol/inspector --transport http http://127.0.0.1:3333/mcp   # HTTP

工具参考

• compare_exchange_fees(purpose, country, monthlyVolumeUsd?, useToken?, makerShare?, tokenBalance?, accountAssetsUsd?, pair?) — 按加权有效费率排序的费率表对比。

• get_referral_link(exchange, country) — 解析推荐链接；在适用时返回 COUNTRY_BLOCKED / UNKNOWN_EXCHANGE / NO_REFERRAL_LINK 错误。

• calculate_savings(exchange, volume, type, country, useToken?, holdingHours?, makerShare?, currency?, tokenBalance?, accountAssetsUsd?, pair?, fundingMode?, fundingPair?, tradeSizeUsd?, spreadMode?, spreadPair?, side?) — 与基础等级费率相比的节省明细；传入 tradeSizeUsd 时，还会返回 spread_cost / slippage_cost / spread_source / spread_ts / spread_pair。

• compare_total_cost(purpose, country, volume, holdingHours?, useToken?, withdrawalAsset?, withdrawalNetwork?, makerShare?, currency?, tokenBalance?, accountAssetsUsd?, pair?, fundingMode?, fundingPair?, tradeSizeUsd?, spreadMode?, spreadPair?, side?, fiatCurrency?, fiatDepositAmountUsd?, fiatDepositsPerYear?, fiatCashoutAmountUsd?, fiatCashoutsPerYear?, fiatMethod?) — 综合成本排名；传入 tradeSizeUsd 时，价差和滑点会计入 total_cost；传入 v0.26 法币使用习惯参数时，年化的直接法币出入金费用也会计入（没有对应通道的平台会被标记，且该费用项不计入）。

• recommend_exchange(purpose, country, volume, makerShare?, useToken?, holdingHours?, currency?, tokenBalance?, accountAssetsUsd?, pair?, fundingMode?, fundingPair?, tradeSizeUsd?, spreadMode?, spreadPair?, side?, fiatCurrency?, fiatDepositAmountUsd?, fiatDepositsPerYear?, fiatCashoutAmountUsd?, fiatCashoutsPerYear?, fiatMethod?) — 推荐最佳交易所，并提供评分（计入执行成本时综合费率／资金费率／价差）、推荐理由、等级维持警告、取舍、可执行建议和备选项。**v0.27：**传入法币使用习惯后，年化的直接法币出入金成本也会纳入评分，权重由费用差异度决定（0.2→0.5）：交易所之间的法币费用差异相较于年度交易费差异越大（小额月度入金用户通常如此），法币费用对结果的影响就越大；没有直接法币通道的平台在该费用项得分为零，并会明确列出取舍，不会因未计价成本而胜出。例如，每月通过 SEPA 买入 €1,000 的德国 DCA 用户，如果每月仅交易 $500，会被推荐使用 SEPA 免费的 Binance，而不是名义费率更低但 SEPA 费用约为每年 $16 的 MEXC；每月交易 $100k 的用户仍会按交易费率排序。

• calculate_annual_cost(exchange, purpose, country, monthlyVolumeUsd, makerShare?, useToken?, tokenBalance?, accountAssetsUsd?, holdingHours?, withdrawalAsset?, withdrawalNetwork?, withdrawalsPerYear?, currency?, pair?, fundingMode?, fundingPair?, tradeSizeUsd?, spreadMode?, spreadPair?, side?, fiatCurrency?, fiatDepositAmountUsd?, fiatDepositsPerYear?, fiatCashoutAmountUsd?, fiatCashoutsPerYear?, fiatMethod?) — 年化交易费（月费 ×12）+ 资金费（月均敞口 ×12）+ 价差／滑点（提供 tradeSizeUsd 时，按年交易名义金额 × 基点计算）+ 提币费（单次费用 × 年提币次数）+ v0.26 直接法币入金／出金费用（最低通道费用 × 年交易次数；没有通道的平台会标记并排除该费用项），另附 upgrade 区块：下一级 VIP 等级、达成条件（交易量／OKX-Bybit-Bitget 账户资产／Kraken AOP／Gate GT／KuCoin KCS／Binance BNB）及预估年节省金额。

• get_data_sources() — 数据来源报告；无需参数。返回全部 15 个数据包文件及其 last_verified、完整来源列表（官方 URL 和／或方法说明），以及 v0.33 的逐文件时效信息：每个文件包含 months_behind 和 is_stale（超过 3 个月或无法解析），报告还包含 stale_after_months 和 stale_files: [...]，Agent 可立即查看哪些数据包需要重新验证；data_as_of 仍为所有文件中最早的时间戳。

• get_funding_rates(fundingMode?, fundingPair?, exchanges?, country?) — 永续交易对资金费率表。捆绑模式为离线模式；实时模式会逐个交易所获取实时费率，并返回 { pair, mode, fetched_at, data_as_of, rates: [{ exchange, rate_pct, interval_hours, source, funding_timestamp?, note? }], failures: [{ exchange, error, fallback: "bundled" }] }。四个成本工具也接受 fundingMode? 和 fundingPair?。

• get_fiat_cost(direction?, amount? | amountUsd?, currency?, country?, method?, exchanges?) — 直接法币出入金成本表；完全离线。返回 { direction, currency, amount, amount_usd, fx_rate, fetched_at, data_as_of, exchanges: [{ exchange, available, routes: [{ method, region?, fee, fee_usd, effective_pct, net, eta, note? }], cheapest_method?, cheapest_fee_usd?, notes? }], best: { exchange, method, fee, fee_usd, effective_pct, net } | null, saving_vs_worst_usd?, advice, warnings? }。错误代码：INVALID_CURRENCY、INVALID_AMOUNT、MISSING_FX_RATE、UNKNOWN_EXCHANGE。

• get_execution_cost(tradeSizeUsd?, pair?, purpose?, side?, spreadMode?, exchanges?, country?) — 单向吃单执行成本表。捆绑模式为离线模式；实时模式会对每个平台的实时前 100 档盘口进行 VWAP 行走计算，并返回 { pair, purpose, side, trade_size_usd, mode, fetched_at, data_as_of, costs: [{ exchange, spread_bps, crossing_bps, slippage_bps, total_bps, cost_usd, levels_consumed?, fully_filled?, available_depth_usd?, source, book_timestamp?, symbol?, pair_class, note? }], failures: [{ exchange, error, fallback: "bundled" }], warnings?: [{ exchange, message }] }。四个成本工具也接受 tradeSizeUsd?、spreadMode?、spreadPair?、side?。

• get_withdrawal_fees(asset?, network?, country?, exchanges?) — 链上提币费对比；完全离线。asset 默认为 USDT；network 接受规范名称和别名（trc20、erc20、bsc、arb、op、matic、c-chain、sol、assethub …）；不指定网络时，会返回每个平台的所有通道，并按可用通道中的最低费用排序。返回 { asset, network?, asset_price_usd?, fetched_at, data_as_of, exchanges: [{ exchange, supported, networks: [{ network, fee, fee_usd, available, note? }], cheapest_network?, cheapest_fee_usd? }], best: { exchange, network, fee, fee_usd } | null, saving_vs_worst_usd?, advice, warnings? }。已暂停的通道仍保留在 networks 中，并标记为 available: false；不支持该资产／网络通道的平台会返回 supported: false 和空的 networks 列表。错误代码：INVALID_ASSET、INVALID_NETWORK、UNKNOWN_EXCHANGE。

• analyze_persona(persona, country, monthlyVolumeUsd?, makerShare?, useToken?, tokenBalance?, accountAssetsUsd?, holdingHours?, tradeSizeUsd?, pair?, currency?, fundingMode?, fundingPair?, spreadMode?, spreadPair?, side?) — 对七种基于研究资料的交易者画像进行年度综合成本分析。默认模式下完全离线。返回 { persona, country, purpose, inputs, currency, ranking: [{ exchange, tier, annual_trading_fee, annual_funding_cost, annual_execution_cost, annual_withdrawal_cost, annual_fiat_deposit_cost?, annual_fiat_cashout_cost?, annual_all_in, cost_mix_pct, withdrawal_unsupported?, fiat_deposit_available?, fiat_cashout_available?, pricing_basis, tier_warning?, referral_url?, exchange_notes? }], best: { exchange, annual_all_in, runner_up_exchange, saving_vs_runner_up, reasons, tradeoffs } | null, best_complete: { exchange, annual_all_in, extra_vs_winner } | null, component_leaders, warnings, advice, data_as_of, data_sources }。缺失的法币通道／提币路线会被标记并从该行排除（绝不会按 $0 计算）；未知画像 ID 会返回 INVALID_INPUT 错误（同时返回有效 ID 列表）。

• analyze_token_discount(exchange, purpose, country, monthlyVolumeUsd, makerShare?, tokenBalance?, accountAssetsUsd?, tokenPriceUsd?, currency?) — 平台原生代币手续费折扣回本分析；完全离线。计算不使用原生代币时的年费（零余额等级，不启用手续费抵扣开关）与使用原生代币时的年费（BNB/MX/BGB/KCS 固定折扣、GT/MX/HYPE 持有量等级阶梯、Gate 合约挂单费降至零、持仓带来的 GT/KCS/BNB 等级提升）、年度美元节省金额、锁定所需代币余额的美元机会成本、回本所需月数，以及节省金额可承受的代币价格最大一年跌幅（breakeven_price_drop_pct）。省略 tokenBalance 时，返回 tiers_analysis（按回本时间排序的所有可达折扣等级）和 recommended_tier_index（正节省等级中回本时间最短的等级）。没有独立开关的平台（OKX、Kraken、Coinbase、Bybit、BingX）会如实报告 has_native_discount: false，不会臆造折扣。代币价格取自 data/token_prices.json（2026-09 快照），也可通过 tokenPriceUsd 覆盖。错误代码：UNKNOWN_EXCHANGE、COUNTRY_BLOCKED、INVALID_INPUT、NO_RESULTS。

• compare_personas(country, personas?, useToken?, currency?, fundingMode?, fundingPair?, spreadMode?, spreadPair?, side?, language?, format?)（v0.28，format 于 v0.36 加入）— 一次调用生成多画像决策矩阵；默认模式下完全离线。使用与 analyze_persona 相同的引擎分析每个画像（或 personas: [...] 子集；保留顺序并去重），并返回 { country, currency, personas: [{ persona: {id, name_en, name_zh, tagline_zh}, purpose, monthly_volume_usd, best: { exchange, tier, annual_all_in, runner_up_exchange, saving_vs_runner_up, cost_mix_pct, tradeoffs } | null, best_complete: { exchange, annual_all_in, extra_vs_winner } | null, matrix: [{ exchange, annual_all_in, withdrawal_unsupported?, fiat_deposit_available?, fiat_cashout_available? }] }], venues, venue_wins: [{ exchange, headline_persona_ids, complete_persona_ids }], most_versatile, rendered?: { metric, markdown?, csv? }, data_as_of, data_sources, errors? }。矩阵按每个画像的费用从低到高排序；某行中缺失的平台表示该平台在该国受限或仅支持现货。venue_wins 先按现实可行的胜出次数（best_complete）排序，再按标题胜出次数排序；most_versatile 为赢得全费用项最多的平台。实时深度会按每个画像分别解析（取决于用途和单笔金额）。错误代码：INVALID_INPUT（未知画像 ID／格式错误）、NO_RESULTS。

• volume_what_if(purpose, country, volumes?, baseVolume?, makerShare?, useToken?, tokenBalance?, accountAssetsUsd?, pair?, currency?, language?, format?, tableMetric?)（v0.34，format／tableMetric 于 v0.36 加入）— 交易量假设扫描；完全离线。返回 { purpose, country, currency, maker_share, use_token, base_monthly_volume_usd?, volumes, data_as_of, points: [{ monthly_volume_usd, annual_traded_notional_usd, cheapest: { exchange, tier, weighted_fee_pct, annual_fee_usd }, ranking: [{ exchange, tier, volume_tier?, weighted_fee_pct, annual_fee_usd, tier_crossed? }] }], tier_crossings: [{ at_monthly_volume_usd, exchange, from_tier, to_tier }], exchanges: [{ exchange, current: { monthly_volume_usd, tier, weighted_fee_pct, annual_fee_usd } | null, next_tier?: { from_tier, to_tier, at_monthly_volume_usd, additional_monthly_volume_usd, weighted_fee_pct_now, weighted_fee_pct_next, saving_per_year_usd_at_current_volume, blocked_by_holding_gate? } | null, sweep: [{ monthly_volume_usd, tier, volume_tier?, effective_maker_pct, effective_taker_pct, weighted_fee_pct, annual_fee_usd, tier_crossed? }] }], advice, warnings?, rendered?: { metric, markdown?, csv? } }。默认 volumes 为各可用平台 VIP 等级门槛与 0 和 baseVolume 合并后排序去重的结果。若合并后超过 16 个点，则会跨全范围按步长采样（并给出警告，始终保留 0/base/最大值）；显式指定 volumes 时最多可提供 24 个自定义点。仅提供 baseVolume 时才会返回 next_tier（null 表示已达到该平台的最高交易量等级）；推荐链接和可选的平台代币折扣的计算方式与 compare_exchange_fees 完全一致。仅包含交易费，不包含资金费／价差／提币／法币费用。对于非 JSON format，tableMetric 可选：weighted_fee_pct（默认）| annual_fee_usd | tier。错误代码：BAD_VOLUME、UNKNOWN_CURRENCY、INVALID_INPUT（format／tableMetric 错误）、NO_RESULTS。

• compare_countries(persona?, countries?, monthlyVolumeUsd?, makerShare?, useToken?, tokenBalance?, accountAssetsUsd?, holdingHours?, tradeSizeUsd?, pair?, currency?, fundingMode?, fundingPair?, spreadMode?, spreadPair?, side?, language?, format?, tableMetric?)（v0.35，format／tableMetric 于 v0.36 加入）— 国家差异矩阵；默认模式下完全离线。每个国家运行一次相同的 analyzePersona 引擎，并返回 { persona: {id, name_en, name_zh}, purpose, currency, countries, data_as_of, rows: [{ country, available_venues, winner: {exchange, tier, annual_all_in} | null, best_complete: {exchange, annual_all_in, extra_vs_winner} | null, comparison_basis: "winner"|"best_complete", comparison_annual_all_in, extra_vs_cheapest_country_usd, extra_vs_cheapest_country_pct, blocked_venues, unsupported_product_venues, ranking, error?, error_code? }], cheapest_country: {country, exchange, tier?, annual_all_in, basis} | null, costliest_country, spread_usd, winner_venue_counts: [{exchange, count, countries}], venue_availability: [{exchange, per_country: {CC: available|blocked|unsupported_product}, blocked_in}], advice, warnings?, rendered?: { metric, markdown?, csv? } }。默认画像为 active_spot_trader，默认国家为 US/GB/DE/JP/SG/BR/CN（最多 12 个，去重）。跨国家差异使用 comparison_annual_all_in 计算：如果头部胜出平台缺少法币／提币通道，则采用全费用项的 best_complete 成本，否则采用头部胜出平台的成本，这样没有法币／提币通道的平台就不会让某个国家看起来虚假地便宜。实时覆盖数据（资金费／深度）会对任一所选国家允许的平台并集仅获取一次。对于非 JSON format，tableMetric 可选：availability（默认）| cost。错误代码：INVALID_INPUT（未知画像／格式或 tableMetric 错误）、UNKNOWN_CURRENCY。

• get_account_fee_tier(exchange, purpose, country, apiKey, secret?, password?, pair?, monthlyVolumeUsd?)（v0.39）——将公开费率表与调用者的实际账户费率关联起来的个性化桥梁。使用只读 API 密钥，通过 ccxt 调用交易平台经过身份验证的费率端点（在可用时使用 fetchTradingFees，否则使用每个交易对的 fetchTradingFee），然后返回 { exchange, purpose, pair, credential_type, fetch_method, fetched_at, live_fee: {maker_pct, taker_pct}, bundled_fee: {tier, maker_pct, taker_pct, monthly_volume_usd}, delta_vs_bundled_bps: {maker, taker}, security_note, notes }——负的基点差值表示该账户在对应交易量下的费率低于公开费率档位（实时费率部分会体现服务端的 BNB/手续费代币抵扣、交易平台自身滚动 30 天的 VIP 周期、协商费率或促销费率）。覆盖范围：18 个交易平台中的 13 个——Binance、OKX（password = API 密码）、Gate、Bybit、MEXC、Bitget、KuCoin 现货 + kucoinfutures（密码短语）、Kraken 现货 + krakenfutures、Coinbase 现货（coinbaseexchange 类）、BingX、Bitstamp 现货、Bitvavo 现货（v0.42，bitvavo 类）；Hyperliquid 的 apiKey 只需填写公开的 0x 钱包地址（无需密钥——它会查询公开的 userFees 端点）。Phemex 和 BloFin 在 ccxt 4.5.x 中没有经过身份验证的费率端点；Finst（v0.43）没有公开交易 API，且 ccxt 4.5.x 不包含 finst 类；Bitpanda（v0.44）是按价差报价的经纪商，没有公开交易 API，也没有 bitpanda 类；Bison（v0.45）是由 EUWAX 作为委托方报价的经纪商，在 ccxt 4.5.78 中没有 bison/euwax 类；Bitstamp/Bitvavo 的永续合约未建模（这两个交易平台均只提供现货）→ 返回 ACCOUNT_FEES_UNSUPPORTED（不会发起网络请求即失败）。首先执行合规检查：在使用凭证前返回 UNKNOWN_EXCHANGE / COUNTRY_BLOCKED / PRODUCT_BLOCKED_IN_COUNTRY / NO_FEE_DATA。运行时错误具有明确类型，且会清除凭证：ACCOUNT_MISSING_CREDENTIALS、ACCOUNT_AUTH_FAILED（不可重试——密钥/密文/密码短语错误、IP 限制、KYC）和 ACCOUNT_FEE_FETCH_FAILED（网络/超时/速率限制时 retryable: true）。凭证仅用于当前请求——从不缓存，也不会写入日志。

• get_stablecoin_access(asset?, country?, exchange?, language?)（v0.46）——MiCA 稳定币区域访问报告；完全离线。asset 默认为 USDT（也支持 USDC/EURC/EURI/EURCV/USDQ/EURQ）。返回 { asset, asset_name?, issuer?, mica_authorized, issuer_note?, fetched_at, data_as_of, restriction: { applies, region?, effective?, venue_trading?, custody_withdrawal?, self_custody_allowed?, note? }, venues: [{ exchange, status, scope, since?, note?, venue_available_in_country }], compliant_alternatives, regulation_note?, advice, data_sources? }。对于位于 EEA30 内的国家，USDT 限制适用（截止日期为 2026-07-01），并会列出全部 18 个交易平台（九个获得 EEA 许可的交易平台标为 delisted+日期，六个被禁止的 CASP 标为 venue_blocked，三个全球业务范围的交易平台标为 never_offered）；对于 EEA 以外的地区（美国/英国/瑞士/……），restriction.applies 为 false，且只返回全球业务范围的条目；exchange 参数会将结果缩小到单个条目。错误代码：INVALID_ASSET（有效 ID 会在 suggested_action 中返回）、UNKNOWN_EXCHANGE、COUNTRY_BLOCKED。

• compare_interface_costs(exchange?, country?, monthly_volume_usd?, language?) (v0.47) — 消费者与 PRO 双界面成本报告；完全离线。返回 { generated_at, data_as_of, study_summary, venues: [{ exchange, venue_name, available_in_country, consumer: { product_name, fee_model, modeled_one_way_pct, published_one_way_pct?, measured_round_trip_pct?, measured_hidden_spread_pp?, subscription?, tier_credit, measurement }, pro?: { product_name, base_maker_pct, base_taker_pct, published_round_trip_pct }, consumer_vs_pro_round_trip_pp?, consumer_vs_pro_annual_excess_usd?, advice, notes? }], advice, data_sources? }。证据：TUM 的真实资金 €100 往返交易研究（2025-10..11，6 家获 MiCA 许可的欧盟平台），由 Frankfurt School 复现（2026-03，432 次往返交易/9 家平台）——Bitvavo 0.58% < BISON 2.58% < Kraken app 5.81% < Bitpanda 6.23% < Coinbase Simple 7.49%；Bitstamp Basic 标记为未经验证（仅有平台自身披露），Bitpanda/BISON 仅提供经纪服务（没有 PRO 界面，省略 pro）。exchange 用于缩小到单个平台，country 用于应用居住地限制（在其服务区域以外会屏蔽 Bitvavo/Bitpanda/BISON），monthly_volume_usd 则会在消费者单向成本高于 PRO taker 基础费率时添加 consumer_vs_pro_annual_excess_usd。错误代码：UNKNOWN_EXCHANGE、COUNTRY_BLOCKED、INVALID_VOLUME。

• get_fee_changes(exchange?, product?, since_month?, limit?, language?) (v0.48) — 可审计的费率表变更动态；完全离线。返回 { generated_at, data_as_of, snapshot_coverage: { months, first?, last?, available }, changes: [{ id, date, exchange, product, kind, tier?, field?, before?, after?, confidence, summary_en, summary_zh?, effective_date?, url?, note?, detected_from_snapshot?, detected_to_snapshot? }], advice }。证据分为两类：curated 行（confidence: high|medium）由人工对照平台官方公告/费率页面核验，并随 data/fee_changes.json 一同发布；detected 行由对 snapshots/fee_ladders/*.json 中连续的月度确定性快照进行差异比较自动生成（仅在仓库中存在——npm 压缩包中不包含这些文件，因此 snapshot_coverage.available 为 false），不得视为已确认信息。kind 的取值之一为 rate | threshold | ladder_structure | promo | token_discount | pricing_model；费率的变更前/后值使用引擎的 round4 百分比精度，阶梯按等级名称匹配。按日期降序、再按置信度排序；product 接受 spot|futures|all（all 记录与任一项匹配），since_month 使用 YYYY-MM 格式。月度采集/审核通过 data-snapshot GitHub Actions 工作流自动进行（仅审核用 PR——未经人工核验的 detected 行绝不会进入 curated 文件）。本地 CLI：npm run snapshot:fees -- snapshot|diff|latest。

错误以结构化 JSON 返回：{ error, code, retryable?, suggested_action? }，代码包括 INVALID_INPUT、UNKNOWN_EXCHANGE、COUNTRY_BLOCKED、PRODUCT_BLOCKED_IN_COUNTRY、NO_RESULTS、UNKNOWN_CURRENCY、NO_REFERRAL_LINK、DATA_LOAD_FAILED、ACCOUNT_FEES_UNSUPPORTED、ACCOUNT_MISSING_CREDENTIALS、ACCOUNT_AUTH_FAILED、ACCOUNT_FEE_FETCH_FAILED。

数据文件

所有费率/VIP/提现/价差数据均为本地 JSON。默认情况下，服务端不会调用外部 API；fundingMode: "live" 会请求获取当前资金费率，spreadMode: "live" 会通过 ccxt 直接从交易所公共端点请求获取订单簿（尽力而为，按平台设置超时，并提供捆绑数据回退）；get_account_fee_tier (v0.39) 每次调用都会向平台的账户费率端点发送一次经过身份验证的请求，使用调用方提供的只读密钥（参见凭证处理）：

文件	内容
data/fee_rates.json	VIP 等级的挂单/吃单费率，涵盖现货和期货；v0.44 新增按交易场所区分的 pricing_model（order_book|flat|spread）和 execution_quality 证据（广告宣传的往返成本与独立测得的往返成本），适用于价差型经纪商交易场所（v0.44 Bitpanda，v0.45 Bison——第二个价差型交易场所）
data/referral_links.json	推荐 URL、用户折扣 %、以及已披露时的运营方返佣（内部）
data/token_discounts.json	BNB / OKB / GT / MX / BGB / KCS / PT 折扣规则，以及 Hyperliquid 质押 HYPE 阶梯（乘数折扣，需质押）
data/pair_fees.json	交易对级别的手续费促销（MEXC 零手续费、Binance FDUSD/USDC、Bitget USDC/USDT）；v0.44 Bitpanda 价差区间定价（BTC/稳定币交易对为 0.99%，低于 1.49% 的宣传费率，非促销）和 v0.45 Bison 区间（BTC/EUR + ETH/EUR 为 1.25%，低于 1.75% 的宣传费率，非促销）
data/funding_rates.json	打包的平均资金费率 + 结算间隔（实时模式回退值）
data/spread_baseline.json	各交易场所典型的完整买卖价差（BTC）+ 主流币/大市值币/中等市值山寨币乘数（2026 年订单簿快照研究；实时模式回退值）；v0.44 将 Bitpanda 固定为 0 bps，v0.45 将 Bison 固定为 0 bps，因为各交易场所内含的溢价就是价差（防止重复计算）
data/withdrawal_fees.json	16 种资产在各交易所的提现手续费，涵盖原生网络 + 多链路径（TRC-20/ERC-20/BEP20/Arbitrum/Optimism/Base/Polygon/Avalanche C/Solana/TON/AssetHub）；asset_prices_usd 为 2026-09-12 的 USD 换算快照；suspended 标记表示暂停使用的钱包（2026 年 8 月至 9 月）
data/fx_rates.json	静态显示用汇率（以 USD 为基准）
data/country_restrictions.json	按国家划分的受限/允许交易所、按产品划分的负向限制门槛（product_blocked）、命名区域成员表（regions，例如 EEA30）、正向产品区域允许列表（product_region_gates，v0.40）、MiCA 关键节点后的负向区域禁令（region_blocked、product_region_blocked，v0.41）以及交易场所级别的正向服务区域白名单（region_allowed，v0.42 Bitvavo 和 v0.43 Finst——均仅限 EEA；v0.44 Bitpanda = EEA+GB，通过仅含单一成员的 GB 区域键表示；v0.45 Bison = EEA+CH，通过仅含单一成员的 CH 区域键表示）
data/fiat_routes.json	各交易场所按货币、区域和方向提供的直接由交易所运营的法币通道（银行卡/ACH/SEPA/FPS/电汇/SWIFT/PIX），包含百分比+固定+最低/最高费用及预计到账时间（不含支付网关/P2P）
data/personas.json	用于 analyze_persona 的七种基于研究的交易者画像：行为预设（交易量、挂单占比、持仓小时数、单笔规模、提现/法币习惯），附双语说明、假设和研究来源（2026 年零售交易者研究）
data/token_prices.json	原生代币的 2026-09 USD 静态快照价格（BNB/OKB/GT/MX/BGB/KCS/HYPE），用于估算持有代币以获得手续费折扣的机会成本；每次调用时可通过 tokenPriceUsd 覆盖
data/stablecoin_access.json	v0.46 MiCA 稳定币注册表：按资产列出的发行方/EMT 授权状态（USDT 未获授权；USDC/EURC/EURI/EURCV/USDQ/EURQ 已获授权）、区域规则（EEA30 的 USDT 交易场所交易限制、2026-07-01 关键节点、托管/提现/自托管权利、替代方案）以及全部 18 个交易场所的规则（delisted + 生效日期 / never_offered / venue_blocked；eea 与 global 范围），附来源和 last_verified 2026-09
data/interface_costs.json	v0.47 双界面成本模型，供 compare_interface_costs 使用：按交易场所（kraken/coinbase/bitstamp/bitvavo/bitpanda/bison）列出面向消费者的产品（名称、费用模型、公布的单边费用、订阅减免）与 PRO 订单簿基准（基础挂单/吃单费率、公布的往返费用）、TUM 实际资金测得的往返成本和隐藏价差百分点，并附 Frankfurt School 复现元数据及 last_verified 2026-09
data/fee_changes.json	v0.48 为 get_fee_changes 精选的手续费表变更动态：经人工核实的费率/门槛/阶梯/促销/代币折扣/定价模型变更，含生效日期、官方来源 URL、双语摘要，以及来源中提供数字时的结构化变更前后数据；last_verified 2026-09（无法根据一手来源还原 2026-09 之前的历史——仅录入有官方证据支持的记录）。此外，仓库还包含仅限仓库的月度确定性快照，位于 snapshots/fee_ladders/YYYY-MM.json（不会打包到 npm tarball 中）；引擎会对这些快照进行差异比较，并生成 confidence: "detected" 的记录
每个文件都包含 last_verified（YYYY-MM）和 sources（官方费用页面 URL、测量研究或注意事项）。通过环境变量覆盖路径：FEE_RATES_PATH、REFERRAL_LINKS_PATH、TOKEN_DISCOUNTS_PATH、PAIR_FEES_PATH、FUNDING_RATES_PATH、SPREAD_BASELINE_PATH、WITHDRAWAL_FEES_PATH、FX_RATES_PATH、COUNTRY_RESTRICTIONS_PATH、FIAT_ROUTES_PATH、PERSONAS_PATH、TOKEN_PRICES_PATH、STABLECOIN_ACCESS_PATH、INTERFACE_COSTS_PATH、FEE_CHANGES_PATH（文件）和 FEE_SNAPSHOTS_PATH（存放每月 YYYY-MM.json 阶梯费率快照的目录；缺失或不可读时会降级为空列表——精选数据源仍可使用）。

**准确性说明：**资金费率和提现费用会波动；VIP 费率表可能随时变更。请将输出视为估算值，并在做出财务决策前通过 get_data_sources 进行核实。

凭据处理（v0.39 get_account_fee_tier）

唯一会进行经过身份验证调用的工具是 get_account_fee_tier，且只有在明确调用时才会执行。安全特性：

• 仅使用只读密钥 — 始终生成具有信息/读取权限、不含交易、提现或转账权限的密钥；该工具不需要这些权限。
• 按请求使用，绝不存储 — 凭据仅在调用期间存在。刻意不设结果缓存（公共数据 TTL 缓存永远不会接收密钥材料），不会向磁盘写入任何内容，也绝不会在响应中返回凭据。
• 全面脱敏 — stderr 中的 [audit] 日志会在序列化前对 apiKey / secret / password / passphrase / walletAddress 参数进行脱敏（***REDACTED***），并清除交易所错误字符串中的明文凭据值和 signature= 参数。
• 合规优先 — 在使用任何密钥之前，会先执行平台/国家/产品限制检查，因此被拦截的请求绝不会访问交易所身份验证端点。
• Hyperliquid 只需要公开的钱包地址（费用查询是公开的 userFees 调用）；绝不会请求私钥。

示例

> User: I'm in Japan, trade 100k USDT futures/month, mostly limit orders, and hold positions ~16h. Which exchange?

Agent → recommend_exchange(purpose="futures", country="JP", volume=100000,
                           makerShare=0.8, holdingHours=16)
Server → {
  "best": { "exchange": "...", "score": 100, "weighted_fee_rate": ...,
            "reasons": [...], "tradeoffs": [...], "referral_url": "..." },
  "alternatives": [...],
  "advice": "Register via the ... link to lock 20% off ...",
  "data_as_of": "2026-09"
}

> User: 数据是哪来的？费率多久更新一次？

Agent → get_data_sources()
Server → { "data_as_of": "2026-09",
           "files": [{ "file": "fee_rates.json", "last_verified": "2026-09",
                       "sources": [{ "name": "Binance fee schedule",
                                     "url": "https://www.binance.com/en/fee/schedule" }, ...] }, ...] }

> User: 我在币安每月交易 100 万U期货，持仓约 720 小时，每年提 12 次 USDT，一年真实成本多少？升 VIP1 能省多少？

Agent → calculate_annual_cost(exchange="binance", purpose="futures", country="JP",
                              monthlyVolumeUsd=1000000, holdingHours=720,
                              withdrawalAsset="USDT", withdrawalNetwork="TRC-20",
                              withdrawalsPerYear=12)
Server → {
  "tier": "Regular",
  "annual_trading_fee": 4800,
  "annual_funding_cost": 108000,
  "annual_withdrawal_cost": 18,
  "annual_total_cost": 112818,
  "upgrade": { "next_tier": "VIP1", "requires_volume_usd": 15000000,
               "annual_savings": 960,
               "hint": "Reach VIP1 via $15,000,000 30-day volume; estimated annual trading-fee saving $960 ..." }
}

> User: 我主要在 MEXC 现货刷 BTC/USDT，听说 0 手续费是真的吗？其他所呢？

Agent → compare_exchange_fees(purpose="spot", country="JP", pair="BTC/USDT", makerShare=0.5)
Server → [
  { "exchange": "mexc", "tier": "Standard", "effective_maker": 0, "effective_taker": 0,
    "weighted_rate": 0, "pricing_basis": "pair",
    "pair_note": "MEXC 0-fee program: all spot pairs trade at 0% maker + 0% taker ..." },
  { "exchange": "okx", ..., "pricing_basis": "account_tier" },
  ...
]

> User: 现在 BTC 永续各交易所资金费率多少？按实时费率我持 10 万U多单 16 小时要付多少资金费？

Agent → get_funding_rates(fundingMode="live", fundingPair="BTC/USDT")
Server → {
  "pair": "BTC/USDT", "mode": "live",
  "rates": [
    { "exchange": "binance", "rate_pct": 0.0124, "interval_hours": 8,
      "source": "live", "funding_timestamp": "2026-09-12T00:00:00.000Z" },
    { "exchange": "kraken", "rate_pct": 0.01, "interval_hours": 8,
      "source": "bundled", "note": "..." }
  ],
  "failures": [{ "exchange": "kraken", "error": "Connect Timeout ...", "fallback": "bundled" }]
}

Agent → calculate_savings(exchange="binance", volume=100000, type="futures",
                          country="JP", holdingHours=16,
                          fundingMode="live", fundingPair="BTC/USDT")
Server → { "funding_cost": 24.8, "funding_source": "live",
           "funding_rate_ts": "2026-09-12T00:00:00.000Z",
           "funding_pair": "BTC/USDT", ... }

> User: 我一笔 5 万U的 BTC 市价吃单，各交易所点差加滑点实际要付多少？25 万U的大单呢？

Agent → get_execution_cost(tradeSizeUsd=50000, pair="BTC/USDT",
                           purpose="futures", side="buy", spreadMode="live")
Server → {
  "pair": "BTC/USDT", "mode": "live", "trade_size_usd": 50000,
  "costs": [
    { "exchange": "binance", "spread_bps": 1.0, "crossing_bps": 0.5,
      "slippage_bps": 0.3, "total_bps": 0.8, "cost_usd": 4,
      "levels_consumed": 3, "fully_filled": true, "source": "live",
      "symbol": "BTC/USDT:USDT", "book_timestamp": "2026-09-12T..." },
    { "exchange": "kraken", "spread_bps": 5, "crossing_bps": 2.5,
      "slippage_bps": 0, "total_bps": 2.5, "cost_usd": 12.5,
      "source": "bundled", "pair_class": "majors" }
  ],
  "failures": [{ "exchange": "kraken", "error": "Connect Timeout ...",
                 "fallback": "bundled" }]
}

Agent → compare_total_cost(purpose="futures", country="JP", volume=100000,
                           tradeSizeUsd=250000, spreadMode="live", side="buy")
Server → [ { "exchange": "binance", "trading_fee": 1000,
             "spread_cost": 12.5, "slippage_cost": 28.2,
             "spread_source": "live", "total_cost": 1040.7 }, ... ]

> User: 我在德国，想入 1000 欧元，刷卡和 SEPA 转账各所收多少？哪个最便宜？

Agent → get_fiat_cost(direction="deposit", currency="EUR", amount=1000, country="DE")
Server → {
  "direction": "deposit", "currency": "EUR", "amount": 1000, "amount_usd": 1086.96,
  "fx_rate": 0.92, "data_as_of": "2026-09",
  "best": { "exchange": "binance", "method": "sepa", "fee": 0,
            "fee_usd": 0, "effective_pct": 0, "net": 1000 },
  "saving_vs_worst_usd": 5.43,
  "exchanges": [
    { "exchange": "binance", "available": true, "cheapest_method": "sepa",
      "cheapest_fee_usd": 0,
      "routes": [ { "method": "sepa", "fee": 0, "fee_usd": 0, "effective_pct": 0,
                    "net": 1000, "eta": "1-2 business days" },
                  { "method": "card", "fee": 20, ... } ] },
    { "exchange": "gate", "cheapest_method": "sepa",
      "routes": [ { "method": "sepa", "fee": 5, "effective_pct": 0.5, ... } ] },
    ...
  ],
  "advice": "binance offers a free sepa deposit for EUR — 1000 EUR arrives in full. ..."
}

> User: 我要提 USDT 到 TRC-20，8 家所分别收多少？不提网络的话哪家最便宜？最近有哪些链暂停了？

Agent → get_withdrawal_fees(asset="USDT", network="TRC-20")
Server → {
  "asset": "USDT", "network": "TRC-20", "asset_price_usd": 1,
  "data_as_of": "2026-09",
  "exchanges": [
    { "exchange": "mexc", "supported": true,
      "networks": [{ "network": "TRC-20", "fee": 0.5, "fee_usd": 0.5, "available": true }],
      "cheapest_network": "TRC-20", "cheapest_fee_usd": 0.5 },
    { "exchange": "bybit", ..., "cheapest_fee_usd": 1 },
    { "exchange": "binance", ..., "cheapest_fee_usd": 1.5 },
    ...
  ],
  "best": { "exchange": "mexc", "network": "TRC-20", "fee": 0.5, "fee_usd": 0.5 },
  "saving_vs_worst_usd": 1,
  "advice": "Cheapest USDT TRC-20 withdrawal: mexc charges 0.5 USDT (about $0.5) ..."
}

Agent → get_withdrawal_fees(asset="ETH")   // no network: cheapest open L2 per venue
Server → {
  "asset": "ETH", "asset_price_usd": 2512.03,
  "best": { "exchange": "mexc", "network": "Base", "fee": 0.0000013, "fee_usd": 0.0033 },
  "exchanges": [ { "exchange": "binance", "cheapest_network": "Optimism",
                   "cheapest_fee_usd": 0.0377, "networks": [ ... ] }, ... ],
  "saving_vs_worst_usd": 0.32
}

开发

npm test          # vitest unit tests (457 tests: 361 tools + 50 live + 28 http + 13 account + 3 polyfill + 2 version)
npm run build     # tsc → dist/
npm run audit:data            # offline data-consistency gate (dates, sources, ladder monotonicity, coverage)
node scripts/smoke-test.mjs   # end-to-end MCP stdio smoke test (68 requests)
npm run smoke:http            # end-to-end Streamable HTTP smoke test
npm run inspector # MCP Inspector UI for manual testing

CI 会在每次推送和拉取请求时运行相同的 audit → build → test → HTTP-smoke 流程，以及 npm pack 产物/安装检查（Node 18/20/22，.github/workflows/ci.yml）。发布历史记录在 CHANGELOG.md 中。

许可证

MIT