cryptocapi

検証可能な証明付きの暗号資産市場分析を、MCP に対応するあらゆるエージェント向けのネイティブツールとして提供します。
すべての回答には入力値の SHA-256 が付与されるため、分析を再計算して検証できます。モデルを信じる必要はありません。

始める  ·  ツール  ·  デモ  ·  証明を検証する  ·  設定  ·  cryptocapi.com

これを貼り付ければすぐに使えます

アカウントも登録もキーも不要です。お使いの MCP クライアントの設定ファイルに追加してください：

{
  "mcpServers": {
    "cryptocapi": {
      "command": "npx",
      "args": ["-y", "@cryptocapi/mcp"]
    }
  }
}

これでエージェントに Bitcoin や Ethereum について質問し、2 つのエンジンが署名した分析を受け取れます。デモで利用できる範囲の詳細は下記をご覧ください。

Claude を使ってトレーディングを分析していますか？ガイド Claude で作るトレーディングボット：価格を捏造しない方法 には、依頼の例とモデルが数値を捏造しないようにするルールを掲載しています。

4つのツール、3つのエンジンとMarket Scan

ツール	エンジン	返される内容	必要なもの
get_insight	Radar	資産の分析。alphaビューには署名が付きます	パスなしの pulse は無料キーで利用可能 · alpha には Radar Alpha パスが必要です
get_insight（engine="quant_plus"）	Quant Plus	決定論的エンジンが署名した同じ資産の分析。reproducible署名付きです	Quant Plus パス
batch_signals	Quant Plus	1回の呼び出しで複数の資産のシグナル	Quant Plus パス
get_signal	Quant Pro	取引ペアの定量シグナル	Quant Pro パス
scan_market	Market Scan（ランキングレイヤー）	戦略に基づく市場ランキング	Market Scan パス

4つのツールに対して5行あるのは、get_insightが2つのエンジンへの入口であり、それぞれに専用のパスが必要だからです。Radar Alphaを持っていても、同じツールのQuant Plusは利用できません。パラメーターengineを変えると、必要なパスも変わります。

Market Scanは4つ目のエンジンではありません。 独自のシグナルを計算するのではなく、Quant Plusのシグナルに基づいて市場を並べ替えます。別の製品であるため、個別に販売されています。

get_market_summary、get_prices、get_macroはどうなったのですか？

2026-08-30までは、サードパーティーのデータを返すツールが3つ（get_market_summary、get_prices、get_macro）ありました。時価総額と恐怖・強欲指数、CoinGeckoの価格、FREDのマクロ時系列データを返していました。CryptoCapiはアグリゲーターではなく、エンジンが導出されたインテリジェンスに署名し、他社のデータは内部の入力として使うため、これらは廃止されました。「市場の状況は？」と尋ねたエージェントが、エンジンに触れずにサードパーティーのデータを含むサマリーを取得してしまっていたためです。これらのエンドポイントはREST APIには引き続き存在します。廃止されたのは、エージェントからツールとして見えるようにすることです。

各エンジンは個別に購入する必要があるため、1つを持っていても他のエンジンは利用できません。 ツールの説明では、汎用的な「PRO」ではなく、必要なエンジンを明記しています。これにより、エージェントが自分のキーでは利用できないツールに無駄な試行をしないようにしています。それでも呼び出した場合、単なる403ではなく、不足しているパスと、現在持っているパスをエラーで知らせます。

エージェントが失敗しやすい形式上の注意点があります。get_signalは取引ペア（BTCUSDT）を受け取り、batch_signalsは通貨識別子（bitcoin）を受け取ります。同じエンジンでも形式は異なり、それぞれのフィールドのスキーマに明記されています。

登録せずに試す

デフォルトの設定では、公開デモキーを使用します。アカウントは不要です。

{
  "mcpServers": {
    "cryptocapi": {
      "command": "npx",
      "args": ["-y", "@cryptocapi/mcp"],
      "env": { "CRYPTOCAPI_API_KEY": "demo_btc_eth_public" }
    }
  }
}

envは任意です。変数を何も設定しなければ、パッケージは自動的に公開デモキーを使用するため、commandとargsだけで十分です。

2026-08-30に公開バージョンで確認した、デモキーで利用できる内容：

エンジン	ツール	デモキーでの利用可否
Radar	get_insight	✅ bitcoinとethereumのみ。pulseを指定した場合も、常に署名付きのalphaビューになります
Quant Plus	get_insight?engine=quant_plus	✅ bitcoinとethereumのみ。input_vector付きの再現可能な署名が得られます
Quant Plus	batch_signals	✅ bitcoinとethereumのみ。get_insightと同じ範囲です
Quant Pro	get_signal	❌ すべてのペアで利用不可
Market Scan	scan_market	❌ すべての戦略で利用不可

利用できない3つのツールは、通貨によって失敗するのではなく、常に失敗します。Bitcoinの取引ペアであるBTCUSDTを使ったget_signalも、403を返します。bitcoinとethereumに限られる制約は、get_insightだけに適用されます。

つまり、初回のセッションで応答するのは4つのツールのうち1つであり、それこそが製品の特徴を示すツールです。Bitcoinの分析に、署名を行う2つのエンジンを使います。

通貨の制限なしで3つのエンジンとMarket Scanを試すには、https://www.cryptocapi.com で14日間の無料トライアルに登録してください。トライアルキーを使えば、期間中はすべて利用できます。

違い

エンジンの応答には、分析を生成した決定論的な計算の証明となる protocol_hash を含む audit_trail が付属します。このパッケージは、これらの値を API から受け取ったまま再シリアライズせずに転送します。数値をひとつでも再フォーマットすると、ハッシュの検証に失敗するためです。

こちらを信じる必要はありません。エージェントに get_insight(coin_id="bitcoin", view="alpha") で分析を取得させ、その出力の protocol_hash を、同じクエリを API に直接送って取得したものと比較してください。

curl -H "x-api-key: demo_btc_eth_public" \
  "https://api.cryptocapi.com/v1/market/insights/bitcoin?view=alpha"

両者は完全に一致するはずです。いつか一致しないことがあれば、このパッケージの不具合なので issue を作成してください。

限界についても明確にしておきます。 この証明は、計算が再現可能であり、言語モデルが書いたものではないことを示します。分析が正しいことを証明するものではありません。また、現時点では暗号署名のないチェックサムなので、証明できるのは完全性であり、出所ではありません。

パッケージも検証できます

証明がデータを対象とする一方、ダウンロードした tarball がこのコードから生成されたものかどうかは、別の方法で確認できます。このパッケージは npm の来歴情報を付けて CI から公開されるため、各バージョンがビルドに使用した commit と workflow にひも付けられています。

npm audit signatures

npm のパッケージページには、正確な commit へのリンクも表示されます。これは protocol_hash と同じ原則を、データではなくサプライチェーンに適用したものです。信じる必要はなく、検証できます。

設定

変数	用途	デフォルト
CRYPTOCAPI_API_KEY	API key	demo_btc_eth_public
CRYPTOCAPI_API_BASE	API のベース URL。開発用	https://api.cryptocapi.com/v1
CRYPTOCAPI_TIMEOUT_MS	リクエストごとの予算（ms）。下記を参照	ツールによって異なります

タイムアウトの予算は一律ではありません。 ツールごとに必要な時間は異なるため、それぞれ個別に設定されています。単一アセットのエンジンでは 20 秒（get_insight、get_signal）、複数アセットを処理するものでは 45 秒（batch_signals、scan_market）です。市場全体のスキャンに単一の読み取り用の予算を適用すると、実際には処理中なのにタイムアウトとなり、エージェントは API が停止していると判断してしまいます。

CRYPTOCAPI_TIMEOUT_MS はこれらの予算を 置き換えます。追加されるわけではありません。設定した数値が、4 つのツールすべてに適用されます。scan_market に余裕を持たせるため 30000 に設定すると、実際には 45 秒から 30 秒に短縮されます。変更する場合は、最も大きな予算を上回る値にするのがおすすめです。

ツールがタイムアウトすると、エラーに実際に適用された予算が表示されます。そのため、設定値はその数値を上回る必要があります。

14 日間のトライアル付き API key の取得先：cryptocapi.com

開発

npm install
npm run check      # tipos + tests + auditoría de dependencias
npm run contrato   # verifica contra la API real que el contrato copiado sigue vigente

テストはNodeのネイティブランナーで実行し、テスト用の依存関係は一切なく、ネットワークにも接続しません。APIはnode:httpで偽装して起動します。サービスではなくパッケージをテストするため、高速で安定しています。

このランナーはTypeScriptをトランスパイルせずに読み込むため、開発には Node 22.18以上が必要です。一方、公開パッケージは20でも実行できます。enginesで宣言している要件であり、ビルド済みの成果物を20、22、24で起動してCIでも検証しています。これは開発要件であり、利用要件ではありません。

そのため、意図的にカバーしていない部分が半分あります。公開パッケージが実際のAPIやエージェント内で正しく動作するかどうかです。これを確認するのがPRUEBAS.mdです。リリースごとに実施する14項目の手動チェックが記載されています。

npm run contratoは、人の手を介さずにその半分の一部をカバーします。テストは意図的にネットワークに接続しませんが、その隔離には見落としが生じる余地があります。2026年9月に4つのバグが見つかり、そのうち3つは、APIが実際に送る内容とパッケージが想定していた内容の違いに関するものでした。テストで記述した内容だけを返す偽サーバーでは見つけられないバグです。コントラクトチェックはまさにこの点を確認し、1日1回だけ実行して、変更があればissueを作成します。

見つかったものの、まだ修正されていない項目はPENDIENTES.mdに記載されています。それぞれの理由と、再調査せずに作業を再開できるだけの情報も含まれています。

公開

タグを使って起動し、CIからnpmとMCP Registryにprovenance付きで公開します。

npm version <patch|minor|major>   # subir también las dos versiones de server.json, y commitear
git tag -a vX.Y.Z -m "vX.Y.Z" && git push origin vX.Y.Z

ワークフローではまず、タグがpackage.jsonのバージョンとserver.json内の2つのバージョンに一致するか確認します。npmでは同じバージョンを再利用できず、この操作は取り消せないためです。認証にはトークンを使わないOIDCによるtrusted publishingを使用します。これはrelease.ymlというファイル名に紐づいているため、ファイル名を変更すると公開できなくなります。

npmへの公開が完了すると、2つ目のジョブがOIDCを使ってserver.jsonをRegistryに送信します。Registryで問題が発生した場合に「Re-run failed jobs」を実行すると、npm publishを再実行せず、そのジョブだけを再試行できるよう、別のジョブにしています。

サーバーのバージョンの唯一の情報源はnpm versionです。公開済みのpackage.jsonを読み取ってserverInfo.versionを設定し、2つのバージョンが食い違うとハンドシェイクのテストが失敗します。手動で記述する値はserver.jsonのものだけで、これが古いままだとタグは最初のチェックを通りません。

バージョニング

1.0.0以降、このパッケージはsemverに従います。コントラクトの対象は4つのツール、そのパラメーター、レスポンスの形式です。

• パッチ（1.0.x）： 修正やテキストの変更です。ツールとそのパラメーターは変更しません。
• マイナー（1.x.0）： ツールや任意のパラメーターの追加など、既存の機能を壊さない新機能です。
• メジャー（2.0.0）： ツールの削除や名前変更、既存パラメーターの変更です。必要になった場合は、事前にお知らせします。

レスポンスはAPIが返す内容をそのまま渡すため、パッケージの新しいバージョンをリリースしなくても、新しいフィールドが追加されることがあります。

ライセンス

MIT

cryptocapi.com  ·  npm  ·  Issues