Fee Optimizer MCP

Fee Optimizer MCP

暗号資産取引所の取引手数料に関する質問への回答、手数料割引を受けられる紹介リンクの取得、節約額の計算、総コスト（手数料＋ファンディング＋スプレッド／スリッページ＋出金）の比較、VIPランク昇格による節約額を含む年間総コストの算出、ファンディングレートの確認（平均値の一括取得またはリアルタイムのライブレート）、注文板での約定コストの測定（売買スプレッドの通過＋注文サイズに応じた板のスリッページ。基準値の一括取得またはライブの板をたどる方法）、法定通貨の直接入出金コストの比較（各取引所におけるカード／ACH／SEPA／FPS／電信送金／SWIFT／PIXでの入出金を、通貨および居住国ごとに比較）、取引所間の資産・ネットワーク別オンチェーン出金手数料の比較（一時停止中のウォレットのフラグと、スナップショット価格に基づく米ドル換算を含む、16種類の資産×TRC-20／ERC-20／L2／ネイティブルート）、さらに、調査データに基づいてトレーダーのペルソナを分析し、7種類のトレーダーの類型について総コスト（手数料＋ファンディング＋スプレッド＋出金＋法定通貨の入出金）の年間総額を算出して、ユーザーのプロフィールに最適な取引所を推奨する、AI エージェント向けのMCP（Model Context Protocol）サーバーです。

"指値注文で取引する場合、手数料が最も安い暗号資産取引所はどこですか？"、"Gate.ioの割引登録リンクを教えてください"、"10万USDTの先物を16時間保有すると、いくら節約できますか？"、"この手数料データの出典はどこですか？"*とユーザーが尋ねると、エージェントはこのサーバーのツールを呼び出し、紹介リンクも含む、出典が明記された具体的な回答を返せます。そのリンクから登録すると、ユーザーは手数料の割引を受けられます。

特長

読み取り専用ツールを20個提供します。stdio またはステートレスな Streamable HTTP で動作します（v0.29：リクエストごとに分離されたサーバー、JSON レスポンス、/health プローブを実装し、リモート／コンテナ環境でのホスティングに対応。v0.32では、公開ホスティング向けの強化として、オプトイン方式のベアラートークン認証、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を指定すると、各取引所の次の段階、必要な追加取引量、現在の取引量での年間USD節約額も表示します。Binance現物のBNB要件のように保有が条件となる段階は、blocked_by_holding_gateとして示します。v0.35ではcompare_countriesを追加します。1人のトレーダーペルソナについて、最大12か国の年間総コストを1回の呼び出しで比較します。国ごとの最安候補と、全要素を考慮した現実的な選択肢、比較可能な条件で最安国と比べた年間追加コスト（決済手段を利用できない見出し上だけの最安候補を、その国の実際の選択肢のように見せることはできません）、コンプライアンスによる利用禁止と商品非対応（先物トレーダーに対する現物専用のCoinbaseなど）を区別する取引所×国の利用可否マトリックス、取引所別の勝利数、最安と最も高額な場合の差を表示します。v0.36では、そのまま貼り付けられるマトリックス表を追加します。compare_personas、volume_what_if、compare_countriesでformat: "markdown" | "csv" | "both"を指定すると、変更のないJSONに加えてrenderedオブジェクトが返ります（tableMetricで表示項目を選択します。取引量スイープでは加重手数料／年間手数料／段階、国別比較では利用可否記号／コスト）。Markdown表ではパイプをエスケープし、CSVはRFC 4180に準拠します（カンマ／引用符／改行の引用、CRLF）。ドキュメントやスプレッドシートにそのまま貼り付けられます。デフォルトの呼び出し結果はバイト単位で変わりません。v0.37では13番目の取引所としてBloFinを追加します。デリバティブ中心のケイマン／マーシャル諸島の取引所です（無期限先物の取引量は24時間で約12億ドル、1日あたり2万USDTまでの出金ではKYC不要）。現物／先物の6段階ラダー（先物は基準料率0.020%／0.060%から0%／0.035%へ、現物は0.10%／0.10%から0.01%／0.0325%へ）、3種類の条件から選べるOR方式の資格要件（30日間の先物取引量／現物取引量／口座資産。資産がわずか5万ドルあれば先物VIP1に到達）、8時間ごとのファンディング、無期限先物の一般的なスプレッドは約3 bps、TRC-20出金は約1 USDT／USDC、ネイティブトークンなし、紹介リンクなし、直接利用できる法定通貨の決済手段なし、さらにMiCAに基づくEEAとUS／CA／CN／SGで利用不可（ドイツは明示的にモデル化）です。v0.38では14番目の取引所としてBitstampを追加します。モデル内で最も規制の厳しい取引所です（2011年創業、ルクセンブルク、Robinhood傘下。EU MiCAのCASPパスポート、NYDFS BitLicense、英国FCA、シンガポールMAS）。出来高のみで決まる現物の11段階ラダー（取引開始時は0.30%／0.40%、30日間の取引高が10億ドルを超えると0.00%／0.03%）に加え、規制対象のUSD建て無期限先物は、8時間ごとのピアツーピア・ファンディング付きで、固定のメーカー−0.005%リベート／テイカー0.015%です。この無期限先物はEU／EEAの対象居住者のみ利用可能で、取引所×国の商品ゲートでモデル化されています（v0.40：EEAの肯定的リージョン許可リストを導入。EEA全30か国では両商品を利用可能とし、それ以外のすべての居住地ではAU／BR／CHも含め、現物の利用は維持しつつ先物をPRODUCT_BLOCKED_IN_COUNTRYとします。CNでは取引所自体が利用不可）。法定通貨の直接入出金手段が充実しています（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パスフレーズも必要）、このツールはccxt経由で取引所の認証済み手数料エンドポイントを呼び出し、実際のメーカー／テイカー手数料をパーセントで返します。また、指定した月間取引量における同梱の公開VIP段階との差を符号付きbpsで返します。これにより、サーバー側の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への所属が必須になりました（EU27か国＋アイスランド／リヒテンシュタイン／ノルウェーの全30か国）。そのため、AU／BR／CH／TR／KRなど、モデルにないEEA以外の居住地では、利用可能範囲が誤って広くなるのではなく、正しくPRODUCT_BLOCKED_IN_COUNTRYになります。一方、EEA加盟国（FR／NL／ES／ITなど）では両商品を利用できます。このゲートはデータ駆動型で、今後ほかのリージョン制限付き取引所にも再利用できます。v0.41では、ミカ規則の移行期間終了後の体制を適用します（第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以外の市場（US／GB／AU／BR／JPなど）は変更前とバイト単位で同一です。v0.42では15番目の取引所としてBitvavoを追加します。欧州最大の地場ユーロ建て現物取引所です（アムステルダム、2018年創業、ユーザー数400万人以上、世界のユーロ建て現物取引量のおよそ半分。AFMのMiCA CASP登録番号#41000010を取得し、EEA域内パスポートに対応）。また、取引所単位の新しい肯定的なサービス提供地域ゲート（country_restrictions.jsonのregion_allowed）も追加します。Bitvavoのサービス対象はEEA30か国のみです。そのため、デフォルトキーの国も含め、その他のすべての居住地（US／GB／CH／JP／SG／AU／BR／CNなど）では取引所が除外されます（COUNTRY_BLOCKEDと同じ扱い）。ホワイトリストに該当する場合は、国ごとの古いallowed列挙値と食い違っていても取引所を利用可能とします。Bitvavoは現物専用です。30日間のEUR取引量に基づく、9段階・単一条件のPROラダー（取引開始時は0.15%／0.25%、€2,500万を超えると0.00%／0.02%。トークンなし、資産条件なし。Basicの一般消費者向けUIに埋め込まれたスプレッドはモデル化しません）、モデル内で最も狭いEU EUR板のスプレッド（フルで1.0 bps、クロス時は0.5 bps。Kaikoの2026-05の測定値は0.981 bpsで、欧州の全取引所中最良）、EUR建てのSEPA／SEPA Instantは入出金ともに無料（iDEAL／BancontactもSEPA経由。出金上限は1日€25,000）、EUカード入金は約1%でカード出金は不可、動的なBTC専用のオンチェーン出金は0.00005 BTCでモデル化します（Lightning非対応。USDT／USDC／ETH／アルトコインは非対応として表示）。EEAの現物取引所は8社に増えますが、先物取引所の構成は変わりません（先物ペルソナではBitvavoはunsupported_productとなります）。Bitvavoの英国法人とスイス法人は意図的にモデル化していないため、GB／CHはホワイトリスト対象外です。v0.43では16番目の取引所としてFinstを追加します。モデル初の、板取引所ではなくブローカーです（アムステルダム、2022年創業、DEGIRO出身のチームが設立。AFM MiCA CASP #41000015を2025-07に取得し、EEA域内パスポートに対応。約30か国、ユーザー数11万人以上）。外部流動性を集約するスマート・オーダー・ルーター（SOR）で、すべての売買／スワップ／自動積立に一律0.15%を課します。メーカー／テイカーの区分、取引量段階、最低手数料、スプレッド上乗せはありません（取引量に依存しない単一のラダー段階と、1.0／0.5 bpsの利用者群別スプレッド代理値としてモデル化）。取引所単位のregion_allowed: ["EEA"]ゲートが適用され、EEAの現物取引所は9社になります。EEA以外の結果ではFinstは表示されません。現物専用です（EEA内で先物ペルソナを指定するとunsupported_product、EEA外ではblocked）。EUR建てのSEPA／SEPA Instant／iDEAL／Bancontactは入出金ともに無料ですが、カード決済（カードを明示的に指定した問い合わせではavailable: falseを返します）、PayPal、USD、GBPには対応しません。暗号資産の出金は、動的なネットワーク手数料の実費に一律€2.50の第三者手数料を加えたものとしてモデル化します。スキーマには追加手数料の項目がないため、BTCは手数料込みで0.000085 BTC（約$6.57）とし、ルートの注記で2つの内訳を明記します。その他400以上の銘柄は非対応として表示します。紹介プログラムと公開取引APIがないため、get_account_fee_tierは非対応です（ライブ対応取引所数は13社のままです）。v0.44では17番目の取引所Bitpandaを追加します。モデル初の、スプレッド価格設定を採用するブローカーです（ウィーン、2014年創業、ユーザー数740万人以上。BaFinのMiCA CASP認可を2025-01-27に取得し、EEA30か国のパスポートに対応。オーストリアFMAのライセンスと、英国FCA登録済みのBitpanda Broker UK法人も保有）。一般消費者向けアプリでは、手数料を上乗せとして価格に埋め込んだ総額を提示し、別途の取引手数料はかかりません。これに対応する新しいpricing_model: "spread"（order_book | flat | spread）を導入します。メーカー／テイカーの区分や取引量ラダーはありません。多くの資産では片道1.49%が公表レートです。BTCと主要ステーブルコインのペアレベル上書きでは片道0.99%、時価総額1億ユーロ未満の小型銘柄では2.49%です（暗号資産インデックスの1.99%区分と、一般消費者向けアプリのレバレッジ10倍はモデル化しません。先物には非対応）。埋め込まれた上乗せがスプレッドコストそのものなので、Bitpandaの同梱スプレッド基準値は0 bpsに固定し、プレミアムとスプレッドの二重請求を防ぎます。また、ブローカーが明示していないコスト差を示す新しいexecution_qualityの根拠ブロックを設けます。公表値では往復2.98%ですが、TUMが実施した実際の€100取引の往復コスト測定値は6.23%で、隠れた上乗せは4.25パーセントポイントです（2025年10～11月。2026-03にはFrankfurt School of Financeが、9プラットフォームでの432回の往復取引を独立して再検証）。調査対象となった欧州の一般消費者向け取引の中で、測定されたコスト差は最大です。Bitpandaのサービス対象は、region_allowed: ["EEA","GB"]を通じたEEA30か国と英国のみです（GBを単一国のリージョンキーとして追加。肯定的ゲートの仕組みはそのまま利用し、ゲートコードの変更は不要）。これにより、EEAの現物取引所は10社になります。サービス対象地域内で先物ペルソナを指定するとunsupported_product、地域外（US／CA／CN／CHなど）ではblockedになります。別サービスのBitpanda Fusionプロ向け取引所（集約流動性価格は0.02～0.25%）と、株式／貴金属／ETFは意図的にモデル化せず、注記で明示します。2026年以降、すべての消費者向けアプリの法定通貨決済手段は無料です。EURではSEPA／SEPA Instant、Visa／Mastercardカード（入金のみ。カード出金は不可）、PayPal、Apple Pay／Google Payに対応し、GBPではFPSとカードに対応します。USDの経路はありません（USDの問い合わせでも取引所の行は残し、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では18番目の取引所BISONを追加します。モデルで2番目となる、スプレッド価格設定を採用するブローカーです（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認可を取得）。一般消費者向けアプリでは総額を1つの価格で提示します。Bitpandaと同様、pricing_model: "spread"でモデル化します（メーカー／テイカーの区分も、取引量ラダーもありません）。ペアレベルの上書きで、BTCとETHは片道1.25%、その他すべての暗号資産は片道1.75%です（往復では約2.5%／約3.5%）。公表された1.49%のBitpandaレートより低い料金です。スプレッド基準値は同じ二重計上防止のため0 bpsに固定します。execution_qualityの根拠ブロックでは、Bitpandaとは逆の結果を示します。公表値の往復コストは2.5%で、TUMの実際の€100取引の測定値は2.58%。未公表分は約0.08パーセントポイントにすぎません（2025年10～11月、MiCA認可済み6プラットフォーム）。これは調査対象中、公表値と測定値が最もよく一致しており、次点のBitvavoを大きく上回ります（Bitpandaは6.23%、Coinbaseは7.49%）。そのため、BISONは欧州の透明性基準となります。BISONはregion_allowed: ["EEA","CH"]を通じてEEA30か国とスイスでサービスを提供します。CHは新しい単一国リージョンキーです（DE／AT／CHでは積極的に展開し、その他のEEA居住者には受動的自由の範囲でサービスを提供）。英国では利用不可で、Bitpanda（EEA＋GB、CHは対象外）とはちょうど逆の対象範囲です。また、US／CA／JP／SG／AU／BR／CN／KRでも利用できません。EEAの現物取引所は11社、CHでは15社になり、GB／US／JPの結果にはBISONは表示されません。現物専用です（futures: []。サービス対象地域内ではunsupported_product、地域外ではblocked。先物やマージン取引はありません）。暗号資産の出金は公式に無料です。ネットワーク手数料の項目はなく、オンチェーンのコストはEUWAX／グループが負担します（Bitpandaの実費転嫁とは異なります）。モデルではBTCとETHをどちらも0とし、両資産でBISONの出金コストは世界中のモデル対象中で最安となります（BTCの最低出金額は0.001 BTC。Lightning／Taproot bc1p非対応。Ethereumメインネットのみで、L2への出金は不可。ETHの最低出金額は0.01 ETH）。法定通貨はEURのみです。SEPA／SEPA Instantは、EURで入金するスイス居住者を含め、入出金ともに無料です。また、カード／Apple Pay／Google Payによる入金には2.49%かかります（Solaris SE／Deutsche Bankの提携先手数料。カード出金不可。GBP／USD／CHFの経路なし。USDの問い合わせでは利用不可の行を残します）。ドイツ株／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認可を申請していません。また、CASPの移行期間が2026-07-01に終了した後（ESMA75-113276571-1679により延長不可と確認済み）、USDTの取引所での取引はEEA全30か国で利用できなくなります。モデルでは取引所ごとの上場廃止の全履歴（Coinbaseは2024-12、Binance／Kraken／OKX／Gate／Bitstamp／Bitpanda／Bitvavoは2025-03までの期間、Revolutの2026年の新規購入停止／残高変換日）に加え、6つのEEA利用不可取引所にはvenue_blocked、BISON／Finst／Hyperliquidにはnever_offeredのステータスを記録します。このレポートは、取引所側の取引禁止と個人の権利を区別します。保有、カストディ、自己管理ウォレットへのオンチェーン出金は引き続き合法です（ほとんどの取引所でConvert／カストディは維持され、DEXは規制対象外です。スイスと英国は意図的にEEAリージョンに含めていません）。発行体と認可の詳細を添えて、MiCA認可済みの代替銘柄としてモデル化した6銘柄（USDC／EURCはCircle France EMI、EURIはBanking Circle、EURCVはSocGen FORGE、USDQ／EURQはQuantoz）を挙げ、日英両方のアドバイスを出力します。同じSTABLECOIN_UNAVAILABLE_IN_REGION警告が、USDT建てのすべてのEEAフローに自動挿入されます。対象は手数料比較（取引所ごとのstablecoin_access行）、節約額／総コスト／年間コスト／推奨事項（取引コンテキストのトップレベルにあるstablecoin_warning）、出金（自己管理／出金コンテキスト）、約定コスト、ペルソナ分析（7ペルソナ中5つが日常的にUSDTを出金）です。これにより、エージェントが制約を表示せずに、EU居住者にUSDTを使った取引を推奨することはありません。v0.47ではcompare_interface_costs（19番目のツール）を追加します。一般消費者向けとPROの2つのインターフェースのコストを比較します。同じ口座でも、低コストの板取引インターフェース（Kraken Pro、Coinbase Advanced、Bitvavoの取引機能）と、提示価格にスプレッドが埋め込まれた高コストの一般消費者向けアプリが利用できる場合があります。TUMの実際の€100取引の往復コスト調査（2025年10～11月、MiCA認可済みのEUプラットフォーム6社を対象。2026-03にはFrankfurt Schoolが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ドルの固定手数料がコストを押し上げ、単純な指値注文にも約定手数料が1%かかります）。取引所ごとの行には、一般消費者向け商品の名称と料金モデル、モデル化された片道の総コスト、実測した往復コスト、隠れた上乗せ（パーセントポイント）、PROのメーカー／テイカー基準料率、両者の差（パーセントポイント）が含まれます。monthly_volume_usdを指定すると、アプリを使い続けることで発生する年間の追加コストも表示します（Coinbaseは月1,000ドルの場合、年間約168ドル）。サブスクリプションに関する注意事項（Kraken+の月額4.99ドル／1万ドル手数料免除、Coinbase One）や、アプリでの取引量はPRO段階の判定に加算されない点も含まれます。Bitpanda／BISONはブローカー専業です（プレミアム自体が手数料であり、切り替え先のPROインターフェースはありません）。Bitstamp Basicは未検証として示され、居住地のゲートも適用されます。同じコスト差をconsumer_interfaceヒントとして、またCONSUMER_INTERFACE_MORE_EXPENSIVE警告として、手数料／節約額／総コスト／推奨ツールに自動挿入します。v0.30／v0.31では日英の説明文出力を追加します。説明文を含む15個のツールでlanguage: "en" | "zh"を指定すると、すべてのアドバイス／警告／トレードオフ／理由／tier_warning文字列が指定言語になります（数値、フィールド名、エラーコードは変わりません）。またv0.31では、以前は「holding at least undefined BNB」と表示されていた、保有要件付きのBNB段階警告も修正します。

ツール	トリガー（英語／中国語）	戻り値
compare_exchange_fees	「手数料が最も安い取引所はどこですか」／「取引所の手数料を比較」	加重実効手数料率で並べた取引所、メイカー／テイカーの内訳、VIP ティア、トークン割引＋紹介割引
get_referral_link	「Binance の紹介リンクを教えてください」／「Binance のお得な登録リンク」	紹介 URL ＋ 割引率 ＋ 注記
calculate_savings	「先物で 10 万 USDT 取引すると、いくら節約できますか」／「10 万 USDT でいくら節約できるか」	元の手数料、紹介後の手数料、トークン割引後の手数料、最終手数料、節約額、任意の資金調達コスト
compare_total_cost	「資金調達と出金を含む実際のコスト」／「資金調達と出金を含む実際の総コストを比較」	取引所ごとの取引手数料 ＋ 資金調達コスト ＋ 出金手数料を比較して順位付けします。v0.26 では、年換算した直接法定通貨の入金／出金手数料（fiatDepositAmountUsd／fiatDepositsPerYear ＋ 出金相当の値）を任意で total_cost に含めます。また、直接利用できる送金手段がない取引所には fiat_deposit_available／fiat_cashout_available フラグを付け、その区間を除外します。決してコストをゼロとして扱いません
recommend_exchange	「どの取引所を使えばよいですか」／「どの取引所を選べばよいか」	理由、トレードオフ、アドバイス、順位付きの代替候補とともに、スコア（0～100）に基づく最適な候補を提示します。v0.27 では、ユーザーの直接法定通貨入金／出金の利用状況をスコアに反映します（ばらつきに応じた重み 0.2～0.5）。送金手段のない取引所には明示的なトレードオフを付記し、取引手数料だけでなく法定通貨の送金手段も考慮して、カード／SEPA の少額入金に対応する取引所を順位付けします
calculate_annual_cost	「年間の取引コストはいくらですか」／「年間の手数料はいくらか、VIP に上がるといくら節約できるか」	年換算した取引手数料 ＋ 資金調達コスト ＋ 出金手数料（＋ v0.26 の任意の年間法定通貨入金／出金コストを annual_total_cost に含む）、さらに次の VIP ティアに必要な条件と年間の節約額
get_data_sources	「データの出典はどこですか」／「データの出典はどこか、更新頻度はどれくらいか」	ファイルごとの last_verified 日付とソース URL（取引所の公式手数料ページ）＋注意事項
get_funding_rates	「BTC 無期限先物の現在の資金調達率」／「各取引所の現在の資金調達率はいくらか」	無期限先物ペア（デフォルトは BTC/USDT）の取引所ごとの資金調達率 ＋ 間隔。バンドル済みの平均値、または取引所ごとのフォールバック付きリアルタイムレートを返します
get_execution_cost	「5 万ドルの成行注文でスプレッドとスリッページはいくらですか」／「スプレッドやスリッページはいくらか、大口注文の価格インパクトコスト」	注文サイズに応じた取引所ごとの片道執行コストを bps ＋ USD で返します。全スプレッド、スプレッドの半分を超えるコスト、板の深さに基づくスリッページ、消費した価格レベル、約定状況を含みます。バンドル済みの基準値、または板の上位 100 件を対象としたリアルタイムの板分析に対応します
get_fiat_cost	「ユーロの入金／銀行口座への出金で最も安い方法」／「入出金手数料、SEPA／ACH／電信送金／PIX のうちどれが安いか」	金額に応じた取引所ごとの直接法定通貨入金または出金の見積もりを返します。手数料（率 ＋ 固定額、最低額／最高額付き）、USD 換算額、実効率、受取額、所要時間、取引所ごとの最安の送金手段、全体での最適な選択肢と最も高い選択肢との差額を含みます。居住地に基づく送金手段の絞り込みを行い、USD／EUR／GBP／BRL でカード／ACH／SEPA／FPS／電信送金／SWIFT／PIX に対応します
get_withdrawal_fees	「USDT の出金で最も安いネットワーク／ETH L2 の出金手数料を比較」／「各取引所の出金手数料、TRC20／ERC20／Layer2 のうちどれが安いか、どのチェーンが停止中か」	資産（および任意のネットワーク）に応じた取引所ごとの出金見積もりを返します。各ルートの現地通貨建て手数料 ＋ USD 換算手数料と available フラグ（停止中のウォレットも表示し、隠しません）、取引所ごとの利用可能な最安ルート、全体での best、最も高い選択肢との差額、警告を含みます。TRC-20／ERC-20／BEP20／Arbitrum／Optimism／Base／Polygon／Avalanche C／Solana／TON／AssetHub およびネイティブチェーンの 16 資産に対応し、完全オフラインで動作します
analyze_persona	「少額購入者／スキャルパー／HODLer に合う取引所はどこですか」／「自分に合うお得な取引所、積立購入・長期保有／スイングトレード／高頻度取引のおすすめ」	調査に基づく 7 種類のトレーダーペルソナ（カジュアル購入者、HODL 積立投資家、アクティブな現物トレーダー、スイング先物トレーダー、デイスキャルパー、VIP／機関投資家、DEX ネイティブ）について、すべてのコストを含む年間ランキングを提示します。取引手数料 ＋ 資金調達コスト ＋ スプレッド ＋ 出金 ＋ 法定通貨の入出金を対象に、コンポーネント別コストの内訳、各項目で最も有利な取引所、best_complete（そのペルソナに必要なすべてのコストが算出できる取引所のうち最安の候補）、警告、実行可能なアドバイスを返します。すべての送金手段がないために見出し上の最安候補となった取引所はフラグで示し、暗黙に $0 として扱いません。v0.25 では analyze_token_discount と相互参照します。useToken=false（デフォルト）で実行すると、ランキング上位 3 取引所それぞれに token_discount_hint（トークン、割引率、年間節約額、損益分岐までの月数、保有コスト、固定率／段階制）が付き、統合された token_discount_hints 配列と具体的なアドバイスも返します。これにより、1 回の呼び出しで「自分に合う取引所はどこか」と「その取引所のトークンを保有する価値があるか」の両方に答えられます。すべてのプリセットを上書きできます
analyze_token_discount	「手数料割引のために BNB／GT／KCS を保有する価値はありますか」／「取引所トークンを保有する価値はあるか、割引で元が取れるまで何か月か、損をしないためにはトークン価格の下落がどこまで許容されるか」	ネイティブトークンによる手数料割引の損益分岐を分析します。トークンなしの場合の年間手数料（残高ゼロのティア、切り替えなし）と、トークンありの場合（BNB／MX／BGB／KCS の固定額控除、GT／MX／HYPE の保有ティア制、Gate 先物のメイカー手数料ゼロ、GT／KCS／BNB のティア引き上げ）を比較します。年間の USD 節約額、ロックされたトークン残高の機会コスト（USD）、損益分岐までの月数、節約額で吸収できる 1 年間の最大トークン価格下落率を返します。tokenBalance を省略すると、到達可能なすべてのティアを損益分岐までの期間で順位付けします
compare_personas	「あらゆるタイプのトレーダーに合う取引所はどこですか」／「すべてのペルソナを比較、どんな人がどの取引所を使うべきか、意思決定マトリクス、最も万能な取引所」 (v0.28)	1 回の呼び出しで、国ごとに7 種類すべてのペルソナ（または一部）について、すべてのコストを含む年間コストを計算し、意思決定マトリクスを返します。ペルソナごとの見出し上の最安候補 ＋ 現実的な best_complete、ペルソナ×取引所の annual_all_in グリッド（安い順、セルごとの送金手段／ルートのフラグ付き）、ペルソナ横断の venue_wins、most_versatile を含みます。たとえば日本では、Hyperliquid が見出し上で 3 ペルソナの最安候補でも、送金手段がないため現実的な候補としての最安には一度も選ばれません。一方、OKX はすべてのコストを含めた場合に最も万能な取引所です
volume_what_if	「取引量が増えると手数料はどう変わりますか／次の VIP ティアに上がるには、取引をあとどれくらい増やせばよいですか」／「月間取引量によって手数料はいくら変わるか、ティアを上げて節約するには取引量があとどれだけ必要か、各取引所のティア変動点、取引量に応じた手数料率の曲線」 (v0.34)	利用可能なすべての取引所について、現物／先物の取引量を変えた場合の一括比較を実行します。取引量の各ポイントでの取引所横断の最安ランキング（ティア ＋ 加重手数料 ＋ 年間取引手数料）、tier_crossed マーカー付きの取引所ごとの推移曲線、フラットな tier_crossings リストを返します。baseVolume を指定すると、取引所ごとの next_tier に正確な閾値、現在の取引量から必要な月間追加取引量、年間の USD 節約額が表示されます。取引量だけでは到達できない段階には blocked_by_holding_gate: true が付きます（例：Binance 現物の BNB AND 条件）。デフォルトのスイープ点はすべての取引所の VIP 閾値を統合したものです（16 件を超える場合はサンプリングして警告を表示）。任意のポイントを指定するには volumes を渡します
compare_countries	「同じ利用条件を国ごとに比較／国を移ると何が変わるか／この国で利用できない取引所はどれか」／「同じ利用習慣ならどの国が最も安いか、居住地を変えるとどうなるか、各国にどの取引所があるか、自分の国で使えない取引所はどれか、国別比較マトリクス」 (v0.35)	1 つのペルソナ（デフォルトは active_spot_trader、7 種類のいずれも指定可能）について、複数の国（デフォルトは US／GB／DE／JP／SG／BR／CN、最大 12 か国）で、すべてのコストを含む年間コストを計算します。行ごとの見出し上の 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	「自分の実際の手数料はいくらですか／実際の VIP メイカー／テイカー手数料／読み取り専用 API キーで自分の口座手数料を確認」／「自分の実際の手数料、口座の本当の VIP ティア、API で自分の手数料を確認、読み取り専用キーで手数料を確認」 (v0.39)	読み取り専用キーで認証して実際のメイカー／テイカー手数料を取得し、指定された取引量での公開手数料表のティアとの差を bps で算出します。18 取引所中 13 取引所に対応（Phemex／BloFin は ccxt 非対応、Finst、Bitpanda、Bison は公開 API／コネクターなし。Bitstamp／Bitvavo は現物のみのため、これらの無期限先物は非対応）。キーはキャッシュにもログ記録にも保存されません。まずコンプライアンス上の条件を確認し、認証／ネットワークエラーには型付きエラーコードを返します
get_stablecoin_access	「EU で USDT の取引／出金はまだできますか／USDT はここで上場廃止になりましたか／MiCA 準拠のステーブルコイン代替候補」／「EU で USDT はまだ使えるか、USDT の上場廃止、欧州のステーブルコイン、USDC／EURC の MiCA 準拠ステーブルコイン」 (v0.46)	ステーブルコイン（デフォルトは USDT。USDC／EURC／EURI／EURCV／USDQ／EURQ にも対応）の MiCA に基づく地域別利用可否を返します。発行者 ＋ MiCA EMT 認可、地域ごとの取引所取引制限と期限（2026-07-01 以降の EEA30）、カストディ／出金／セルフカストディの権利、取引所ごとのステータス（上場廃止 ＋ 日付／未提供／取引所による制限、EEA／全世界の範囲、照会対象国での利用可否）、準拠する代替候補、英語と日本語のアドバイスを含みます。同じ警告は、USDT／EEA のリクエストに対して、手数料、出金、執行コスト、ペルソナ関連ツールにも自動的に追加されます
compare_interface_costs	「Kraken／Coinbase のアプリはなぜこんなに高いのですか／Instant Buy や Simple に隠れたスプレッド」／「アプリでの購入がなぜこんなに高いか、アプリに隠れたスプレッド、2 つの価格体系、簡単売買の手数料、TUM の実測値」 (v0.47)	取引所ごとに、一般ユーザー向け商品の名称 ＋ 手数料モデル、モデル化した片道の総コスト、TUM で測定した往復コスト、隠れた上乗せ幅（ポイント）、PRO のメイカー／テイカー基本手数料と差（ポイント）を返します。monthly_volume_usd を指定すると、一般ユーザー向けアプリと PRO の年間超過コストを年換算して表示します（例：Coinbase で月 1,000 ドルの場合、年間約 168 ドル）。サブスクリプションに関する注意事項（Kraken+／Coinbase One）、PRO ティアのクレジット対象外である旨、居住地による利用制限も含みます。Bitvavo は 0.58% のパススルー料金に基づく透明性の基準として表示されます
get_fee_changes	「最近手数料を変更した取引所はありますか／手数料変更の履歴／どの取引所が最近手数料を改定したか、手数料率の変更履歴、手数料の変更を監視する方法」 (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日間のローリング取引量ティア、1時間ごとの資金調達、ステークした HYPE による手数料割引、KYC 不要）、BingX（v0.21：取引量のみで決まる Elite 段階を含む VIP Club の段階制、取引量または資産額による適格性判定、8時間ごとの資金調達）、Phemex（v0.24：シンガポールを拠点とし、Morgan Stanley 出身チームが運営する、業界最低水準のメイカー手数料 — Standard ティアでは現物／先物ともに 0.01%、30日間の取引量のみで決まる VIP 段階制、8時間ごとの資金調達、現物＋先物で PT トークンによる一律20%の手数料割引）、BloFin（v0.37：2023年から稼働するケイマン諸島／マーシャル諸島拠点のデリバティブ取引所、24時間あたり約12億ドルの無期限先物取引量 — 6段階のティア制で、先物手数料は基本の 0.020%／0.060% から VIP5 では 0%／0.035% に低下、30日間の取引量／現物取引量／口座資産額による3トラックのいずれかで適格性を判定（資産額50,000ドルのみで先物 VIP1 に到達）、8時間ごとの資金調達、無期限先物の通常スプレッドは約3 bps、独自トークンなし、法定通貨の直接入出金なし。米国／カナダ／中国／シンガポールおよび MiCA 下の EEA では利用不可）、Bitstamp（v0.38：ルクセンブルクで創業（2011年）、Robinhood 傘下、最も規制が厳しい取引所 — MiCA CASP／NYDFS BitLicense／英国 FCA／シンガポール MAS の認可・登録を保有。11段階の取引量のみで決まる現物ティア制は 0.30%／0.40% から、10億ドルで 0%／0.03% に低下。EEA30 限定の規制対象 USD 無期限先物は、メイカーリベート −0.005%／テイカー 0.015% の一律料金、8時間ごとの P2P 資金調達、国×商品ごとの肯定的な地域許可リストで利用を制限（v0.40）。米国 ACH は無料、SEPA 入金は無料／出金は €3、SWIFT は 0.05%／0.1%、カードは約4%。出金は ERC-20 中心 — USDT は ERC-20 のみで約20、USDC は Solana／L2 も対応。独自トークンなし）、Bitvavo（v0.42：アムステルダム（2018年）、オランダ発のユーロ現物取引所として最大 — AFM MiCA CASP #41000010 として EEA パスポート権を保有、ユーザー数は約400万人以上、世界のユーロ建て現物取引量のおよそ半分を占める。30日間のユーロ取引量のみで決まる9段階の単一トラック PRO 現物ティア制は 0.15%／0.25% から、2,500万ユーロ超で 0%／0.02% に低下。トークン／資産額による判定なし。このモデルで最も狭い EU ユーロ板スプレッドは 1.0 bps（Kaiko 2026-05）。SEPA／SEPA Instant は入出金とも無料（iDEAL／Bancontact 対応）、EU カードは入金のみ約1%。BTC のみ動的出金手数料 0.00005。現物のみ — 無期限先物なし。取引所単位の肯定的なサービス地域許可リスト（region_allowed: EEA30）で利用を制限するため、GB／CH（別個の未モデル化エンティティ）を含む EEA 外の居住者はすべて取引所を利用不可）、Finst（v0.43：アムステルダム（2022年、DEGIRO 出身チーム）、このモデルで初の、オーダーブック型取引所ではなく証券仲介／SOR 型の取引所 — AFM MiCA CASP #41000015 として EEA パスポート権を保有。すべての売買／スワップに一律 0.15% を課し、メイカー／テイカーの区別、ティア、スプレッド上乗せなし。取引量に依存しない単一のティア段階としてモデル化。SEPA／SEPA Instant／iDEAL／Bancontact は EUR のみで入出金とも無料。カード／PayPal／USD／GBP 非対応。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%、時価総額1億ユーロ未満の小型銘柄は2.49% — メイカー／テイカーの区別なし、取引量ティアなし。pricing_model: "spread" とし、二重計上防止のためスプレッド基準値を 0 bps に固定。さらに execution_quality の根拠を記録（表示上の往復手数料は2.98%に対し、TUM の実資金による測定値は6.23%、非表示分は4.25pp。Frankfurt School 2026-03 による再現検証）。EUR は SEPA／SEPA Instant／入金のみのカード／PayPal／Apple-Google Pay が無料。2026年から GBP は FPS／カードに対応。USD の入金経路なし。BTC 0.00000598（約$0.46）、ETH 0.0006（約$1.51）の動的ネットワークコスト転嫁。現物のみ。region_allowed: ["EEA","GB"] により EEA30＋GB がサービス対象（GB は単独メンバーの地域キー）— EEA 現物取引所は10社となり、Bitvavo／Finst と異なり GB も対象。別個の Fusion プロ取引所、株式／金属、10倍マージンはモデル化対象外。紹介制度なし、ccxt クラスがないため口座手数料の照会には非対応）、BISON（v0.45：シュトゥットガルト（2019年）、Boerse Stuttgart Group — このモデルで18番目の取引所、2つ目のスプレッド価格設定の証券仲介。EUWAX AG がプリンシパルとしてレートを提示（オーダーブックなし、レート有効期間は約10秒）。Boerse Stuttgart Digital Custody は BaFin の MiCA カストディ／移転ライセンスを初めて取得（2025-01-17）、EUWAX の取引所サービスは2025-04-01から MiCA 認可、アクティブユーザー100万人以上。コンシューマーアプリではペア別上書きにより BTC／ETH は片道1.25%、その他すべてのコインは片道1.75%（往復で約2.5%／約3.5%）を価格に含める — メイカー／テイカーの区別なし、ティア制なし。pricing_model: "spread" とし、スプレッド基準値を 0 bps に固定。さらに execution_quality の根拠を記録（表示上の2.5%に対し、TUM の実資金による測定値は2.58%、非表示分は約0.08pp のみ — 検証対象となった6プラットフォームのうち、公開値と実測値の一致度が最も高い）。SEPA／SEPA Instant は EUR の入出金とも無料で、スイスのユーザーも対象。カード／Apple／Google Pay は入金のみ2.49%。GBP／USD／CHF の入出金経路なし。BTC および ETH のオンチェーン出金は公式に無料で、手数料は0（ネットワークコストはグループが負担。最低額は 0.001 BTC、Lightning／Taproot 非対応。ETH はメインネットのみで L2 非対応）。現物のみで、先物／マージンなし。region_allowed: ["EEA","CH"] により EEA30＋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 の現物取引ペアは、Class A（流動性の高い主要銘柄 — 表示される段階表）、Class B（Class A のちょうど 2 倍）、Class C（ちょうど 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 からメイカーリベートがマイナスになります。Kraken にはネイティブトークンがないため、useToken は適用されません。また、紹介リンクもありません。すべての Kraken の結果には、資格要件に関する注意事項（単一出来高入力の制限、米国／カナダ／ニュージーランドでの先物クロス資格、一般向けアプリと Pro の料金の違い）を記載した exchange_notes が含まれます。コンプライアンス: Kraken は US（現物。CFTC 規制下の Kraken/Bitnomial 無期限先物は 47 州で利用可能）、HK、JP、TH で利用でき、CN と SG では利用できません。
  • Coinbase の現物 — 出来高のみのティア（v0.19）: Advanced Trade では、全ペアを対象とする 30 日間のローリング USD 出来高に基づき、1 時間ごとに更新されるオーダーブックのメイカー／テイカー手数料が表示されます（Tier 1 = 0.40%/0.60% … $10k で Tier 2 = 0.25%/0.40% … $400M で Tier 9 = 0%/0.04%）。資格要件は出来高のみです。保有量トラックもネイティブトークンもないため、tokenBalance / useToken は適用されず、accountAssetsUsd は無視されます。Coinbase は現物のみの取引所で、先物手数料の比較とリアルタイム資金調達率の取得から自動的に除外されます（一般向けのナノ BTC/ETH 無期限先物はモデル化されていません）。現物の執行コストには、通常の全スプレッド基準値として 2.0 bps を使用します（リアルタイムモードでは coinbaseexchange のオーダーブックをたどります）。出金経路は BTC / ETH / USDT（ERC-20、Base、Solana）/ USDC（Base は無料、ERC-20）に対応し、動的なガス代に基づく手数料の注記が付きます。コンプライアンス: US と SG の居住者が利用でき、CN、HK、TH、JP では利用できません。
  • Hyperliquid の現物＋先物 — 14 日間の出来高ティア＋HYPE ステーキング割引（v0.20）: 最初の DEX 取引所です。完全オンチェーンの L1 オーダーブック（HyperCore）を備え、取引ガス代はゼロ、USDC 証拠金の無期限先物と USDC 建ての現物取引に対応します（入金は Circle CCTP 経由で、最小 5 USDC）。ティアは14 日間のローリング加重出来高期間に基づいて毎日更新されます（現物出来高は 2 倍で計上されます。他の取引所が使う 30 日間の期間とは異なるため、安定したペースで取引するトレーダーの実際のティアは 1 段階低くなる場合があります）。無期限先物は Tier 0 の 0.045%/0.015% から Tier 6（$7B）の 0.024%/0% まで、現物は 0.070%/0.040% から 0.025%/0% まで下がります。Tier 4 からメイカー手数料は通常の 0% です（マイナスではありません）。資格要件は出来高のみで、HYPE を保有してもティアの資格は得られません。HYPE ステーキング段階表（10/100/1k/10k/100k/500k HYPE → 現物と無期限先物のすべてのメイカー＋テイカー手数料から 5/10/15/20/30/40% 割引）は出来高ティアと乗算で重ねて適用されます。useToken と tokenBalance にはステーキング済みの数量を渡してください（HYPE を保有しているだけでは割引されません）。資金調達は毎時精算されます。組み込みの 0.00125%/1h は、CEX 取引所の中立的な平均値 0.01%/8h と同じです。リアルタイムモードにも対応しています。出金は Arbitrum One / 22 以上の CCTP チェーンへの一律約 1 USDC の経路が 1 つあります（USDC のみ。USDT 経路はありません。入金は無料です）。BTC 無期限先物の通常のスプレッドは 0.8 bps です（組み込みの基準値。リアルタイムモードでは hyperliquid のオーダーブックをたどります）。KYC、法定通貨の入出金経路、紹介リンクはありません。コンプライアンス: 米国ではフロントエンドが地域制限されています（利用規約の制限対象リスト）。CN、HK、SG、JP、TH からは利用できます。
  • BingX の現物＋先物 — 出来高のみの Elite 段階を含む VIP Club 段階表（v0.21）: 商品ごとに異なる 30 日間の出来高しきい値に基づく 8 段階（Regular → Elite → VIP1–5 → Supreme）です。先物は 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% まで下がります。資格は 3 つのトラックのうち最も高いもので決まります。30 日間の現物出来高、30 日間の Standard Contract 先物出来高、または accountAssetsUsd で指定する前日の口座資産です（先物 VIP1 = $50k … VIP5 = $3M。レベルは毎日 03:00 UTC+8 に更新）。Elite と Supreme の段階は出来高のみです。資産によって VIP1～VIP5 まで昇格できますが、Elite や Supreme には昇格できません（口座資産が $10B でも VIP5 が上限です）。VIP4/VIP5/Supreme ではさらに、API 経由の取引出来高を総出来高の 20% 以下にする必要があります（エンジンは条件を満たしているものと仮定します）。クローズ専用のコピートレード商品 Standard Futures（一律 0.045%）はモデル化されていません。段階表が示すのは Standard Contract のオーダーブックです。ネイティブトークン（したがって useToken は適用されません）も紹介リンクもなく、法定通貨の直接入出金経路もありません（P2P／サードパーティのゲートウェイのみ）。資金調達は標準的な中立平均 0.01% で 8 時間ごとに精算されます（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 の結果には 6 つの exchange_notes（トラック、出来高のみの段階、API 比率ルール、Standard Futures の除外、トークン／紹介リンクがないこと、情報源の確認）が含まれます。コンプライアンス: US、CA、GB、CN、HK、SG では利用できません。また、MiCA の適用開始後（v0.41。オーストリア FMA の申請は現在も「審査が進んでいる」段階で未承認）のため、EEA 全域で取引所が利用不可です。JP、TH、AU、BR およびその他の EEA 外の国では利用できます。
  • BloFin の現物＋先物 — 3 トラックの OR 条件による 6 ティア段階表（v0.37）: BuildLight Future Limited（ケイマン諸島／マーシャル諸島）。デリバティブ取引は 2023 年 1 月に開始し、無期限先物の 24 時間取引高は約 $1.2B（CoinGecko）、Fireblocks でカストディを行い、ISO 27001 を取得、毎月 1:1 のプルーフ・オブ・リザーブを実施しています。KYC は不要です（未認証アカウントの出金上限は 1 日 20,000 USDT）。商品ごとに 6 ティアがあり、30 日間の先物出来高、30 日間の現物出来高、または accountAssetsUsd で指定する日次スナップショットの口座資産のうち、最も高いもので資格が決まります（レベルは毎日 00:00–12:00 UTC に更新）。先物は、出来高 <$10M かつ資産 <$50k の Regular が 0.020%/0.060%、$10M または 資産 $50k で VIP1 が 0.006%/0.050%（資産トラックとしては異例に低い手数料）となり、$500M/$3M で VIP5 の 0%/0.035% まで下がります。現物は 0.10%/0.10% → 出来高 $1M／資産 $50k で VIP1 の 0.035%/0.06% → 出来高 $8M／資産 $3M で VIP5 の 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 では利用できません。また、MiCA CASP 認可が 2026-07-01 の経過措置期限までに取得されなかったため EEA でも利用できません。DE は利用不可として明示的にモデル化されています。HK、JP、TH、GB、BR およびその他 150 以上の国では利用できます。
  • Bitstamp の現物＋先物 — 出来高のみの現物 11 ティア段階表＋EU 専用の規制対象無期限先物と取引所×国の商品ゲート（v0.38）: 2011 年にルクセンブルクで創業（モデル対象中で最も歴史の長い取引所）。2025 年に Robinhood が約 $200m で買収しました。EU MiCA CASP パスポート（ルクセンブルク CSSF）、米国 NYDFS BitLicense＋40 以上の州の MTL、英国 FCA、シンガポール MAS、カナダの登録のもとで規制されており、モデル内のコンプライアンス基準となる取引所です。現物 PRO/API 手数料は、資産やトークンのトラックがない、30 日間の USD 取引高に基づく単一トラックです。$10k 未満では 0.30%/0.40%、$10k で 0.20%/0.30%、$100k で 0.10%/0.20%、$1B 以上で 0.00%/0.03% となる 11 段階です。スプレッドベースの価格を提示する一般向け Basic インターフェース、最初の $1,000 が無料となるキャンペーン、FX／ステーブルコイン／USDT の半額手数料のサブスケジュールはモデル化されていません。規制対象の USD 証拠金無期限先物は一律の単一ティアです。メイカー −0.005%（リベート）／テイカー 0.015%。プラットフォームの取り分なしで 8 時間ごと（00:00/08:00/16:00 UTC）にピアツーピアで資金調達され、組み込みの平均は 0.01% です。無期限先物はEEA の利用資格を持つ居住者のみに提供されるため、Bitstamp には商品ごとのゲートが設定されています。v0.40 以降、正の地域許可リストで制御され、product_region_gates.bitstamp.futures = ["EEA"] を regions.EEA のメンバーシップ表（EU27 か国＋アイスランド／リヒテンシュタイン／ノルウェーの EEA 30 か国）と照合します。現物は取引所レベルで 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 では blocked ではなく unsupported_product に分類されます）。EEA のメンバーは両商品を利用できます。これは、明示的なエントリーがない EEA 外の国にも無期限先物を誤って開放していた、v0.38 の否定リストの default キーを置き換えるものです。商品ゲートは 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 は ERC-20 のみ一律 20（TRC-20/Solana なし。モデル内で最も高い USDT 経路。EU では USDT 自体を取引所で取引できません）、USDC は ERC-20 で 4 です（Solana/Arbitrum/Polygon/Optimism/Avalanche/Stellar の経路もありますが、個別にはモデル化されていません）。主要ペアの組み込み通常の現物スプレッドは 2 bps で、Coinbase Advanced と同水準です。ネイティブトークン（useToken は使えません）も紹介リンクもありません。
  • Bitvavo の現物 — EUR 出来高に基づく 9 段階の PRO ティア＋取引所レベルの EEA サービス地域許可リスト（v0.42）: 2018 年にアムステルダムで創業。Bitvavo B.V. はオランダ AFM に MiCA の暗号資産サービスプロバイダーとして登録されています（#41000010）。EEA 全域でパスポート制度を利用し、約 400 万人以上のユーザーと、EUR 建て現物出来高の大きなシェアを占めています。これまでのすべてのゲート（否定的な region_blocked による禁止や、商品レベルの product_region_gates）とは異なり、Bitvavo は取引所レベルの正のサービス地域ゲートを使用してモデル化されています。region_allowed.bitvavo = ["EEA"] を regions.EEA（30 か国）と照合します。取引所に登録できるのは EEA 居住者のみで、GB / CH を含むその他すべての居住地は、実際には別法人の Bitvavo がサービスを提供しているものの意図的にモデル化されておらず、明示的なキーの市場も default キーの国も、取引所として利用不可（COUNTRY_BLOCKED）となります。許可リストとの一致は、古い国別 allowed エントリーより優先されます。取引所ごとのゲート優先順位: region_blocked による禁止 → 国別 blocked → region_allowed の許可リストに一致（許可）→ 許可リストに不一致（拒否）→ 国別 allowed の値（空なら制限なし）。国が指定されていない場合は安全側で拒否されます。手数料は 30 日間の EUR ローリング出来高に基づく単一の PRO/API オーダーブックスケジュールです（しきい値は USD 相当として扱います）。9 段階は、€100k 未満の 0.15%/0.25% から、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% → €25M 以上（主要銘柄）の 0.00%/0.02% です。ネイティブトークンも資産トラックもありません。埋め込みスプレッド価格の一般向け Basic インターフェース（2026 年の TUM 調査で約 0.08 pp の隠れた上乗せが測定されています）はモデル化されていません。Bitvavo は現物のみで、無期限先物を提供していません。そのため、すべての先物スタック／資金調達率の取得対象から除外され、EEA の先物利用者に対する compare_countries では blocked ではなく unsupported_product として表示されます。EEA 外では blocked です。EUR のオーダーブックは USDT ではなく EUR で表示され、モデル内で最も狭い通常スプレッドを持ちます。主要銘柄では全幅 1.0 bps／クロス時 0.5 bpsです（Kaiko の 2026-05 の測定値は 0.981 bps で、欧州のどの取引所よりも低い値です。出来高の少ないアルトコインはペアクラス倍率により幅が広がります）。法定通貨: SEPA/SEPA Instant の EUR は入金・出金ともに無料（iDEAL と Bancontact も SEPA を利用。出金上限は 1 日 €25,000）、EU 発行カードの入金は約 1%（サードパーティの情報源では 0.5–1.5% のため、モデルでは中央値を採用）で、カード出金はありません。PayPal（約 2%）は注記のみで、モデル化されていません。USD/GBP の経路はありません。出金はネットワークコストを動的に転嫁する BTC のみで、0.00005 BTC としてモデル化されています（Lightning なし。1 つのアグリゲーターによる 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%の手数料を提示し、メイカー／テイカーの区別も、出来高段階表も、最低手数料もなく、スプレッドの上乗せもないとしています。そのため、モデルには出来高に依存しない単一の段階（tier: "Flat 0.15%"、すべての出来高でメイカー = テイカー = 0.15%。単調増加段階表の監査は自明に合格）と、コホートのスプレッド代理値として全幅 1.0 bps／クロス時 0.5 bpsを設定しています（SOR 取引所のオーダーブック調査はありません）。アクセスには Bitvavo と同じ取引所レベルの正のゲート region_allowed.finst = ["EEA"] を使用するため、EEA 30 か国のみが取引所の料金算出対象になります（EEA の現物スタックは 9: bitstamp, bitvavo, bybit, coinbase, finst, gate, hyperliquid, kraken, okx）。GB/US/CH/JP/AU/BR を含むその他すべての居住地では、取引所が利用不可／対象外として表示されます。Finst はデリバティブを一切提供していません。futures: [] のため規制上の商品ゲートは適用されず（EEA 内では isVenueUsableFor は true のまま。Coinbase/Bitvavo と同様の仕様）、先物料金のスタックにも含まれません。EEA の先物利用者に対する compare_countries では unsupported_product、EEA 外では blocked として表示されます。法定通貨: EUR の SEPA 経路（SEPA Instant/iDEAL/Bancontact）のみで、入金・出金ともに無料です。カード経路はなく、method: "card" を明示した照会では available: false／経路なしとして取引所が返されます（EEA の国については比較配列に残りますが、best にはなりません）。PayPal および USD/GBP もありません。出金: 公式のスケジュールでは、ネットワークの動的手数料を原価で転嫁し、暗号資産の出金ごとに一律 €2.50 のサードパーティ手数料が加算されます。WithdrawalFee に上乗せ手数料のフィールドはなく、スキーマも意図的に拡張していないため、BTC 経路は合計 0.000085 BTC／約 $6.57としてモデル化されます（$77,298 のスナップショットで、ネットワーク手数料相当の約 0.00005 BTC＝約 $3.86 と、€2.50＝約 $2.72〔€1 = $0.92〕の合計）。経路の 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）を受け、EEA 30 か国にパスポート制度で展開しています。オーストリア FMA のライセンスも保有し、FCA 登録済みの Bitpanda Broker UK Ltd を通じて英国でもサービスを提供しています（ユーザー約 740 万人）。一般向けアプリはオーダーブック取引所ではありません。手数料を上乗せとして内包した価格を提示し、別途の手数料項目はありません。スキーマには "order_book" と "flat" に加えて 3 つ目の料金モデル pricing_model: "spread" が追加され、ほとんどの資産に対して出来高に依存しない単一の段階 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 の往復取引 50 回の平均は6.23%です（2025 年 10～11 月、プラットフォームごとに往復取引 50 回）。公表値を 4.25 パーセントポイント上回る隠れたコストがあり、2026-03 に Frankfurt School of Finance が実施した調査（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）となり、Bitvavo/Finst とは異なり GB でも利用できます。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 以外のすべての暗号資産では出来高に依存しない単一の段階 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%です。2025 年 10～11 月の 12 取引日にわたる標準化された €100 の往復取引 50 回（MiCA 対応 6 プラットフォーム。BISON はこの 6 プラットフォームのサンプルに含まれます）で、未公表の差はわずか 0.08 パーセントポイントでした。このサンプルでは公表値と実測値の一致度が最も高く、次点は Bitvavo の −0.58% で、Bitpanda は 6.23%、Coinbase は 7.49% でした。アクセスには取引所レベルの正のゲート region_allowed.bison = ["EEA","CH"] を使用し、CH を第 2 の単一メンバー地域キー（regions.CH = ["CH"]）として追加します。EEA 30 か国すべてとスイスで利用できます（DE/AT/CH では積極的にサービスを提供し、その他の EEA 諸国では条約上の自由に基づいて受動的にサービスを提供）。一方、GB では取引所が利用不可です。EEA+GB を許可する Bitpanda とは意図的に相互補完的な設定です。US/CA/JP/SG/AU/BR/CN/KR も利用できません。EEA の現物スタックは 11、CH のスタックは 15となり、GB/US/JP の結果に BISON が含まれることはありません。futures: []（取引所が提供する先物やマージン取引はありません）のため、サービス提供地域内では unsupported_product、地域外では blocked になります。法定通貨はEUR のみです。スイスのユーザーが EUR で入金する場合も含めて、SEPA/SEPA Instant は入金・出金とも無料です。スイスは SEPA に属しますが EU 地域テーブルには含まれないため、取引所の許可リストで利用可否を制御する地域未指定の経路としてモデル化されています。また、即時のカード／Apple Pay／Google Pay 入金には 2.49%の手数料がかかります（パートナーである 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 を返します。出金比較には意図的に国別ゲートを適用しません。€1.99 のドイツ株式／ETF の定額注文（ドイツのみ）と、ステーキング報酬の 27% の手数料（ETH/SOL）は対象外です。友達紹介プログラム（DE/AT/CH の ETH 報酬）にはアフィリエイト URL がなく、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） — USD 建ての口座資産総額です。現物・先物とも、VIP レベルは 30 日間の出来高段階と資産段階のうち、高い方になります（例: OKX VIP1 = $100k … VIP9 = $500M、メイカーリベートはマイナス。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 ではさらに非 API 出来高を 80% 以上にする必要があります（エンジンは条件を満たしているものと仮定し、注意事項を exchange_notes に表示します）。このパラメーターを省略すると、出来高ティアが表示され、資産による昇格のヒントとして next_min_assets が返されます。
• pair（任意、v0.12） — BTC/USDT、BTC/FDUSD、BTCUSDT などの取引ペアです（区切り文字は正規化されます）。ペアに既知の手数料プロモーションがある場合は、口座ティアの手数料に代わってプロモーションのレートが適用され、結果には pricing_basis: "pair" と pair_note が含まれます。それ以外の場合、料金の基準は account_tier のままです。確認済みのペア別プロモーション: MEXC — すべての現物ペアでメイカー 0%＋テイカー 0%（手数料無料プログラム）、先物 100 以上のペアで 0/0（アカウントごとの上限あり）。Binance — FDUSD ペア（BTC/ETH/BNB/DOGE/LINK/SOL/XRP）はメイカー 0%、テイカーはティアに応じた手数料。USDC ペアはメイカー 0%／テイカー 0.095%。Bitget — USDC/USDT と USDGO/USDT は 0/0（出来高は VIP 資格に算入されません）。Bitpanda（v0.44） — BTC と主要ステーブルコインのペアは、表示価格の 1.49% に対して、プレミアムを内包する片側 0.99% の価格帯です（スプレッド型ブローカーの価格帯であり、プロモーションではありません。非プロモーションとしてフラグ付けされます）。Bison（v0.45） — BTC/EUR と ETH/EUR は、表示価格の 1.75% に対して片側 1.25% の価格帯です（同じくプロモーションではないスプレッド価格帯）。ペアの上書きはメイカーのみ、テイカーのみ、または両方に適用できます。
• makerShare（0～1、デフォルト 0） — メイカー（指値注文）として執行される出来高の割合です。加重レート = maker × share + taker × (1-share)。指値注文で取引する場合は、0.7～1 を渡してください。
• useToken — ネイティブトークンによる割引を適用します。BNB（現物 25%／先物 10%）、GT（先物のメイカー手数料 → 0。さらに tokenBalance に応じて保有量別の 10～50% 割引）、MX（現物＋先物 20%。500 以上の MX で割引が 50% に引き上げられ、重ねて適用はされず高い方が使われます）、BGB（現物＋先物 20%）、KCS（現物 Class A/B/C＋先物で 20%。VIP8 以上ではメイカーがすでに 0% のため、テイカー側のみ割引されます）、OKB（OKX のティアに組み込み済み）、および Hyperliquid のステーキング済み HYPE（ステーキング量 10/100/1k/10k/100k/500k → すべてのメイカー＋テイカー手数料から 5/10/15/20/30/40% 割引。出来高ティアと乗算で重ねて適用されます。tokenBalance にはステーキング済みの数量を指定してください。保有しているだけでは割引されません）。
• 負のメイカーレート — OKX VIP7 以上のメイカー手数料は現物／先物ともマイナス（最大 -0.0075%）です。Kraken の先物メイカー手数料も Tier 11 からマイナスになり（Pro 5 では最大 -0.006%）、取引所からメイカーリベートが支払われます。これらのレートは紹介／トークン割引をそのまま適用します（割引によってリベートが減ることはありません）。手数料見積もりにはマイナスとして表示され、有料の手数料より上位に評価されます。
• holdingHours（先物）— 1 か月あたりのポジション保有時間です。各取引所の資金調達率に基づいてコストを算出します（ほとんどの取引所では 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 なども指定可）の現在の資金調達率を各取引所からリアルタイムで取得します。取引所ごとに独立して取得し、タイムアウトは 8 秒です。取得に失敗した取引所（タイムアウト、地域制限、ペアなし）は、透過的に組み込み平均値へフォールバックし、専用ツールでは failures に記載されます。結果はメモリ内で 5 分間 TTL キャッシュされます（資金調達は数時間ごとにしか精算されないためです）。リアルタイムの負のレートはそのまま適用されます。ロングは報酬を受け取ることになります。単独の 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 の現物では kucoinfutures ではなく kucoin クラスを使用）。side: "buy" | "sell" に応じて板の厚みをたどって VWAP を算出し、最良気配を超える注文サイズに応じたスリッページに加え、levels_consumed、available_depth_usd、fully_filled も測定します。取引所ごとの取得失敗（タイムアウト、地域制限、市場なし）は組み込み基準値にフォールバックし、failures に記載されます。注文サイズが表示されている板の厚みを超える場合は、測定値を維持したうえで warnings に記載します（板の厚みを超える影響は外挿されません）。板の走査結果は 30 秒間 TTL キャッシュされます。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）、居住国を ISO 形式で指定する country（コンプライアンスによるフィルタリングと地域ごとの入出金経路の両方を決定します。例: Bybit の EU 発行カードは 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）。結果には経路ごとの手数料、USD 相当額、実効率、手取り額、所要時間、取引所ごとの最安経路、全体の 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）。これにより、個人トレーダーが実際に支払うコスト全体 — 取引手数料＋資金調達＋スプレッド／スリッページ＋オンチェーン出金＋銀行／カード入金・出金 — を 1 回の呼び出しで算出できます。実際に利用できる無料経路は fiat_deposit_available: true とともにコスト 0 を返します。直接入出金経路のない取引所（例: Hyperliquid/BingX/Phemex/BloFin）は、経路を黙って無料として扱わず、その項目を除外して（0）fiat_deposit_available: false を返します。法定通貨の利用習慣を指定しない場合、該当キーは省略され、従来の挙動が維持されます。
• 法定通貨を考慮した推奨（v0.27） — recommend_exchange は同じ 6 つの法定通貨関連パラメーターを受け付け、年換算した直接入出金コストをスコアに加えます。法定通貨の重みはコストのばらつきに基づいて動的に決定されます。fiatWeight = 0.2 + 0.3 × dispFiat / (dispFee + dispFiat)。ここで、各 disp は取引所間の年換算コスト差です。そのため、法定通貨の手数料差が取引手数料差を大きく上回ると、重みは 0.2 から 0.5 まで上がります（毎月の入出金額が少ない利用者の場合）。出来高の多いトレーダーでは 0.2 のままです。残りの重みは、手数料／資金調達／スプレッドに再配分されます。入出金経路のない取引所は、該当する方向のスコアが 0 になります（実際に利用できる無料経路は 100）。実際に必要となるサードパーティ／P2P 経路（通常 1.99～5.5%）を明記したトレードオフも返されます。勝者が同じ利用習慣に対してより多くの費用を請求する場合、アドバイスには法定通貨の入出金が最安の取引所と年間差額も記載されます。これらのパラメーターを指定しない場合、スコアは v0.27 以前の重みテーブルとバイト単位で同一です。勝者が入れ替わる例（v0.41、EEA）: DE の現物取引で月 $500、SEPA 入金が €1,000 を年 12 回の場合、利用習慣を指定しなければ、EEA で利用可能な取引所の中から、手数料スコア 100 の Hyperliquid が勝ちます。利用習慣を指定すると、SEPA が入金・出金とも無料の OKX が 92.2 で勝ち、Hyperliquid は 62.7 です（Binance/MEXC は EEA では利用できません）。
• withdrawalAsset + withdrawalNetwork（v0.18、ネットワーク対応） — ネットワーク別の出金手数料を追加します。組み込みテーブルでは 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、および各資産のネイティブチェーンにわたって扱います（取引所ごとに利用できる経路は異なります。Coinbase、BingX、BloFin、Bitstamp は BTC / ETH / USDT / USDC のみ対応。Bitvavo（v0.42）は動的な BTC のみを 0.00005 としてモデル化し、その他すべての資産は未対応と表示。Finst（v0.43）は合計 0.000085 の BTC のみをモデル化し、動的なネットワーク手数料と一律 €2.50 のサードパーティ手数料を合算して経路の注記に表示。その他すべての資産は未対応。Bitpanda（v0.44）は実費を転嫁する動的手数料で BTC 0.00000598（$0.4622）と ETH 0.0006（$1.5072）のみをモデル化し、fee_usd は保存せず価格スナップショットから再計算。その他すべての資産は未対応。Bison（v0.45）は手数料 0 で BTC と ETH に対応。オンチェーンのネットワークコストはグループが負担するため、両資産で世界全体の best となります（BTC メインネットは最小 0.001、ETH はメインネットのみで最小 0.01、L2 なし）。その他すべての資産は未対応。Hyperliquid は Arbitrum／22 以上の CCTP チェーンへの一律約 1 USDC の経路を 1 つ掲載。BloFin はネットワークコストを動的に転嫁し、TRC-20 のステーブルコインは約 1）。ネイティブ単位の手数料は、2026-09-12 の価格スナップショット（asset_prices_usd）から USD に換算されます。2026 年 8～9 月に停止された経路（例: 5 つの取引所の TON ウォレット、Gate/KuCoin/BingX の USDC-TRC20、DOT のリレーチェーン）には suspended: true が付き、利用可能な経路として扱われることはありません。ネットワークを指定しない場合は、取引所で利用可能な最安の経路が自動的に適用されます。ネットワーク入力では別名（trc20、erc20、arb、matic、sol など）を使用できます。calculate_annual_cost は 1 回あたりの手数料に 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 にある、調査に基づく 7 つの典型像には、市場（現物／先物）、月間出来高、メイカー比率、月間の保有時間、標準的な注文サイズ（tradeSizeUsd）、出金資産＋年間回数、年間の法定通貨の入金／出金（通貨＋経路の利用習慣）を含む、行動特性一式が設定されています。各ペルソナは、casual_buyer（少額をカードで入金する買い手。カード手数料が大半を占める）、hodler_accumulator（毎月の DCA＋BTC をコールドストレージに出金）、active_spot_trader、swing_futures_trader（資金調達コストが最大の費目）、day_scalper（出来高が多く、90% がメイカー）、vip_institutional（月 $30M、資産 $3M、注文サイズ $100k → リアルタイムのスプレッドを推奨）、dex_native（オンチェーンの USDC フローで、KYC／法定通貨の入出金は不要。経路がない場合はゼロとせず明示）です。各ペルソナは他のツールが個別に算出するのと同じ年換算コスト全体（取引手数料＋資金調達＋執行＋出金 1 回あたりの手数料＋法定通貨）を計算し、取引所ごとの cost_mix_pct、component_leaders、概要の best と、別枠の best_complete を返します。best_complete は、ペルソナに必要なすべての費目を実際に算出できる取引所のうち最安のものです（例: 先物ペルソナの概要では Hyperliquid が最安でも、法定通貨の入出金経路や USDT/BTC の出金経路がない場合があります。その場合は withdrawal_unsupported／法定通貨利用可否でその旨を示し、現実的に全費目を満たす候補と追加コストを表示します）。各プリセットはデフォルト値であり、monthlyVolumeUsd、makerShare、useToken、tokenBalance、accountAssetsUsd、holdingHours、tradeSizeUsd、pair、currency、およびリアルタイム上書きの fundingMode / fundingPair、spreadMode / spreadPair で変更できます。ペルソナはスキーマに照らして検証され、他のデータファイルと同様にバージョン管理されます。
• 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 以前とバイト単位で同一です。数値、フィールド名、エラーコード、機械処理向けの注記は言語に依存しないため、言語を切り替えてもデータスキーマは変わりません。
• format / tableMetric（v0.36、3 つのマトリックスツールのみ） — compare_personas、volume_what_if、compare_countries は format: "json"（デフォルト）| "markdown" | "csv" | "both" を受け付けます。JSON 以外の形式を指定すると、結果に rendered: { metric, markdown?, csv? } オブジェクトが追加されます。language に応じて英語または中国語で出力される、タイトル付きですぐに貼り付けられるテーブルです。ペルソナのマトリックスは、取引所×ペルソナの年間合計コストを示します（経路がないセルには Markdown のみ † が付き、CSV は数値のままです）。what-if は、月間出来高の行×取引所で、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 }（ベアラー認証が有効な場合も、認証は不要です）。
• 不明なパス → 404。/mcp への POST 以外のリクエスト → Allow: POST を付けて 405。不正な 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>	MCP POST に対するクライアント IP ごとの固定ウィンドウ制限。上限を超えると 429 と Retry-After（-32001）を返します。未認証の試行もカウントされるため、トークンなしの大量リクエストで制限を回避することはできません。0／未設定の場合は無制限です。
FEE_MCP_ACCESS_LOG=1	リクエストごとに、構造化された JSON を 1 行、標準出力に出力します：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 クライアントの設定（ベアラートークンを使用した 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) — 紹介URLを解決します。該当する場合は 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）**でスコアに加わります。取引所間の法定通貨手数料の差が年間の取引手数料の差を上回るほど（少額の月次入金を行うユーザーに典型的です）、法定通貨コストの影響が大きくなります。直接レールのない取引所は該当項目のスコアがゼロとなり、未算定コストを抱えたまま上位になるのではなく、明示的なトレードオフが示されます。例：月1,000ユーロをSEPA経由で入金し、月500ドル分だけ取引するドイツのユーザーには、名目上は手数料の安いMEXC（SEPA手数料は年間約16ドル）より、SEPA無料のBinanceが推奨されます。一方、月10万ドル取引するユーザーは、引き続き取引手数料を基準に評価されます。

• 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 指定時は年間取引想定額×bps）＋出金手数料（1回あたりの額×年間回数）＋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: [...] により、エージェントが再検証の必要なバンドルをすぐに確認できます。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" }] } を返します。4つのコスト関連ツールは、追加で 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 }] } を返します。4つのコスト関連ツールは、追加で 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? } を返します。停止中のルートも available: false として networks に残ります。対象の資産／ネットワークのルートがない取引所は 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?) — 調査に基づく7種類のトレーダーペルソナのうち1つについて、年間総コストを分析します。既定モードでは完全オフラインで動作します。{ 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のティア引き上げ）を比較します。年間のドル建て節約額、必要なトークン残高をロックする機会費用、投資回収までの月数、節約分で吸収できる1年間の最大トークン価格下落率（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）— 1回の呼び出しで複数ペルソナの判断マトリックスを返します。既定モードでは完全オフラインで動作します。すべてのペルソナ、または personas: [...] で指定した部分集合（順序を維持し、重複を除去）を analyze_persona と同じエンジンで実行し、{ 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点まで指定できます。next_tier は baseVolume を指定した場合にのみ含まれます（nullは、その取引所の取引量ティアがすでに最上位であることを示します）。紹介割引と任意のプラットフォームトークン割引は、compare_exchange_fees と同様に適用されます。取引手数料のみが対象で、ファンディング／スプレッド／出金／法定通貨は含まれません。tableMetric（JSON以外の format を指定した場合）：weighted_fee_pct（既定値）｜annual_fee_usd｜tier。エラーコード：BAD_VOLUME、UNKNOWN_CURRENCY、INVALID_INPUT（不正な形式／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 エンジンを国ごとに1回実行し、{ 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 のコスト、そうでなければ勝者のコストです。これにより、法定通貨／出金レールのない取引所が、ある国のコストを不当に安く見せることはありません。ライブの上書き情報（ファンディング／板の深さ）は、選択された国のいずれかで利用可能な取引所すべてを対象に1回取得します。tableMetric（JSON以外の format を指定した場合）：availability（既定値）｜cost。エラーコード：INVALID_INPUT（不明なペルソナ／不正な形式／tableMetric）、UNKNOWN_CURRENCY。

• get_account_fee_tier(exchange, purpose, country, apiKey, secret?, password?, pair?, monthlyVolumeUsd?) (v0.39) — 公開手数料体系から呼び出し元の実際のアカウント手数料を取得する、パーソナライズされたブリッジです。ccxt を介して、取引所の認証済み手数料エンドポイントに読み取り専用API キーでアクセスし（利用可能な場合は 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 } を返します。差分がマイナス bps の場合、そのアカウントが該当取引高の公開ティアよりも低い手数料を支払っていることを意味します（サーバー側の 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 の認可を受けた9取引所は delisted と日付、禁止されている CASP 6社は venue_blocked、グローバル対象の3取引所は never_offered）。EEA 外（米国／英国／スイスなど）では restriction.applies は false となり、グローバル対象の行のみが返されます。exchange を指定すると、1行に絞り込まれます。エラーコード：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、MiCA認可を受けたEUの6プラットフォーム）をFrankfurt Schoolが再現したもの（2026-03、9プラットフォームで432往復取引）です。手数料は、Bitvavo 0.58% < BISON 2.58% < Kraken app 5.81% < Bitpanda 6.23% < Coinbase Simple 7.49%の順です。Bitstamp Basicは未検証（取引所独自の開示のみ）と明記されています。Bitpanda/BISONはブローカーのみ（PROインターフェースなし）のため、pro は省略されます。exchange を指定すると1つの取引所に絞り込み、country を指定すると居住地の利用可否が適用されます（Bitvavo/Bitpanda/BISONはサービス提供地域外では利用不可）。また、monthly_volume_usd を指定すると、消費者向けの片道コストがPROのテイカー基本手数料を上回る場合に 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 } を返します。根拠は2段階に分かれます。curated の行（confidence: high|medium）は、取引所の公式告知や手数料ページと照合して人手で検証済みで、data/fee_changes.json に含まれています。detected の行は、snapshots/fee_ladders/*.json の連続する月次スナップショットの差分から自動生成されます（リポジトリ内のみ。npm tarballには含まれず、その場合は snapshot_coverage.available が false になります）。確認済みとして扱ってはなりません。kind は rate | threshold | ladder_structure | promo | token_discount | pricing_model のいずれかです。rateの変更前後の値にはエンジンの小数点以下4桁のパーセント精度が使われ、段階はティア名で照合されます。日付の降順、次に確信度の順位で並び替えられます。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) は、呼び出しごとに1回、呼び出し元が提供する読み取り専用キーを使って取引所のアカウント手数料エンドポイントに認証リクエストを送信します（認証情報の取り扱いを参照）：

ファイル	内容
data/fee_rates.json	VIP ティアごとのメイカー／テイカー手数料率（現物＋先物）。v0.44 で、スプレッド型ブローカーの取引所向けに、取引所ごとの pricing_model（order_book|flat|spread）と execution_quality の根拠（公表値と独立測定による往復取引コスト）を追加（v0.44 Bitpanda、v0.45 Bison — 2つ目のスプレッド型取引所）
data/referral_links.json	紹介 URL、ユーザー割引率、開示されている場合は運営者のリベート（内部用）
data/token_discounts.json	BNB／OKB／GT／MX／BGB／KCS／PT の割引ルール＋Hyperliquid のステーキング済み HYPE の段階式割引（乗算式、ステーキング必須）
data/pair_fees.json	ペア単位の手数料プロモーション（MEXC の 0 手数料、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	ネイティブおよび複数チェーンのルート（TRC-20/ERC-20/BEP20/Arbitrum/Optimism/Base/Polygon/Avalanche C/Solana/TON/AssetHub）における 16 資産の取引所別出金手数料、USD 換算用の asset_prices_usd（2026-09-12 のスナップショット）、一時停止中のウォレットを示す 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 は単一メンバーの GB 地域キーで EEA＋GB。v0.45 Bison は単一メンバーの CH 地域キーで EEA＋CH）
data/fiat_routes.json	取引所が直接運営する法定通貨決済手段（カード／ACH／SEPA／FPS／電信送金／SWIFT／PIX）。取引所、通貨、地域、方向別に、パーセント手数料＋固定手数料＋最低／最高手数料と所要時間を収録（決済ゲートウェイ／P2P は対象外）
data/personas.json	analyze_persona 用の、調査に基づく 7 種類のトレーダーペルソナ。行動プリセット（取引量、メイカー比率、保有時間、注文サイズ、出金／法定通貨の利用習慣）、バイリンガルの説明、前提、調査ソース（2026 年の個人トレーダー調査）を収録
data/token_prices.json	手数料割引のためにトークンを保有する機会費用の推定に使用する、ネイティブトークン（BNB/OKB/GT/MX/BGB/KCS/HYPE）の 2026-09 時点の静的 USD 価格スナップショット。呼び出しごとに 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 の実資金による往復取引コストの測定値と隠れスプレッドの pp、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

同じ監査 → ビルド → テスト → HTTP スモークテストのパイプラインに加え、npm pack の成果物／インストールチェックが、プッシュおよびプルリクエストのたびに CI で実行されます（Node 18/20/22、.github/workflows/ci.yml）。リリース履歴は CHANGELOG.md にあります。

ライセンス

MIT