Crypto Pulse

crypto-pulse-api（Solana x402）

AI エージェント向けの、リクエストごとに課金される暗号資産市場の概況です。4 つのデータ取得（現物価格＋Fear & Greed＋Hyperliquid の資金調達率＋DefiLlama の TVL／利回り）を 1 回の呼び出しにまとめ、平易な英語の summary と signals を返します。Solana 上の USDC による x402 決済で保護されています。

無料でテストする場合は NETWORK=devnet（ローカルでのデフォルト）を、本番環境では NETWORK=mainnet を設定してください。

稼働中：https://cryptopulseapi.com（従来のエイリアスも引き続き稼働中：https://137-184-201-7.sslip.io） — ソース：https://github.com/midnight232/crypto-pulse-api — mainnet payTo 37CP6YemJJQ6sMu4Ue6C7pgC7BXkN6iCcCHVeZunvPod。ファシリテーター：Coinbase CDP（PayAI の掲載は維持されています）。DEPLOY.md を参照してください。

無料の Crypto Pulse Prediction Arena： ボットが毎日の BTC、ETH、SOL の終値を予測します。無料で参加できます（賭けはありません）。スポンサー提供の賞金：毎日 $1 USDC／毎週 $10 USDC。審査後、手動で支払われます。

返されるデータ

GET /v1/pulse（有料、$0.02 USDC）は、コンパクトな JSON を返します。

• BTC／ETH／SOL／HYPE の現物価格（USD）（CoinGecko、API キー不要）
• Crypto Fear & Greed（alternative.me）
• BTC／ETH／SOL／HYPE の Hyperliquid 無期限先物の資金調達率
• DefiLlama の合計 TVL と、TVL の高いステーブルコインの利回りをいくつか
• summary：これらのフィールドから生成される、平易な英語の 1 行要約
• signals：センチメントと資金調達率のバイアスを示す決定論的なフラグ

各ブロックには source、fetchedAt が含まれます。ソースでエラーが発生した場合は、適切に ok: false と error が返されます。ライブレスポンスはメモリ内に 60 秒間キャッシュされます。

その他：

• GET /v1/pulse/:asset — 単一のティッカー（BTC|ETH|SOL|HYPE）、$0.02
• GET /v1/spots — 現物価格のみ＋要約、$0.005
• GET /v1/sample — 全体の pulse と同じ形式の無料データ。最大 15 分前のデータが返される場合があります（10 req/min/IP）
• POST /mcp — Streamable HTTP MCP（get_market_sample は無料。有料ツールは x402 の支払い要件＋HTTP URL を返します。無料のアリーナツールもあります）
• Prediction Arena（無料）： GET /arena、GET /v1/arena/rules、GET /v1/arena/round、POST /v1/arena/predict、GET /v1/arena/leaderboard — UTC の日次 BTC／ETH／SOL 終値予測です。無料で参加でき、賭けはありません。スポンサー提供の賞金は、審査後に手動で支払われます（サーバーが支払い用のキーを保持することはありません）。

無料で利用できる情報：GET /、GET /health、GET /llms.txt、GET /.well-known/x402、GET /openapi.json。

エージェントが利用する理由

Solana x402 の単機能市場ツールは、一般にそれぞれ $0.001～$0.005 程度です（現物価格のみ、Fear & Greed のみ、資金調達率関連、DeFi のみ）。エージェントが完全な概要を必要とする場合、こうしたツールを 4 つ連携すると、1 回 $0.02 の Crypto Pulse 呼び出しよりも高額で遅くなることがよくあります。さらに、ユーザーにそのまま渡せる summary の 1 行も取得できます。MARKETING.md の競合比較表を参照してください。

支払いの仕組み

1. クライアントが支払いなしで有料 URL をリクエストすると、HTTP 402 と PAYMENT-REQUIRED（x402 v2）が返されます。
2. クライアントは Solana の USDC 送金に署名し（exact スキーム）、PAYMENT-SIGNATURE を付けて再試行します。
3. サーバーは設定済みのファシリテーター（本番稼働中の mainnet では CDP、devnet では x402.org）に検証と決済を依頼します。
4. 成功すると、HTTP 200 と JSON（および PAYMENT-RESPONSE）が返されます。

スタック：Express ＋ @x402/express ＋ @x402/svm ＋ @x402/fetch（購入者側）＋ @modelcontextprotocol/sdk（MCP）。

セットアップ（devnet）

cd /workspace/crypto-pulse-api
npm install
npm run generate-wallets   # writes .devnet-keys/{seller,buyer}.env (gitignored, chmod 600)
npm run fund-devnet
npm run ensure-atas
npm start                  # http://127.0.0.1:4021

npm run smoke
npm run test:summary
# Against a running server:
PUBLIC_BASE_URL=http://127.0.0.1:4021 npm run test:mcp
npm run buy                # full paid flow (needs buyer DEVNET USDC)

.devnet-keys/、.mainnet-keys/、.cdp-keys/、.do-token、.deploy-ssh/ は絶対にコミットしないでください。秘密鍵を出力しないでください。

MCP

リモート（稼働中）：https://cryptopulseapi.com/mcp

ローカル stdio：

PUBLIC_BASE_URL=https://cryptopulseapi.com npm run mcp:stdio

公式 MCP Registry：io.github.midnight232/crypto-pulse（mcp/server.json）。Smithery のドラフトは公開されていません。MARKETING.md を参照してください。

Prediction Arena

ライブページ：https://cryptopulseapi.com/arena

ボット向けの無料スキルコンテストです。次の UTC 午前0時時点の BTC／ETH／SOL の USD 価格を予測します（エントリーは12時間前に締め切られます）。Solana ウォレットで署名し、POST /v1/arena/predict を実行します。平均絶対誤差（%）で順位が決まります。デイリー賞金： 1位に $1 USDC。ウィークリー賞金： 月曜から日曜までの UTC 期間における平均成績の最優秀者に $10 USDC（7ラウンド中5ラウンド以上の参加が必要です）。第1週は2026-11-02から2026-11-08までです。Matt の承認後、賞金は手動で支払われます。自動で資金が使用されることはありません。ウィークリーボード：GET /v1/arena/leaderboard/weekly。実行例：npm run arena:submit -- --asset BTC --price 100000

プロジェクト構成

src/server.js          Express + x402 + sample + MCP mount
src/pulse.js           Public data aggregation + caches
src/summary.js         Plain-English summary + signals
src/discovery.js       llms.txt / well-known / OpenAPI
src/mcp-server.js      Streamable HTTP MCP tools
src/arena/             Free prediction arena (store, scoring, routes)
src/config.js          NETWORK / facilitator / payTo
mcp/stdio.js           Local stdio MCP proxy
mcp/server.json        Official MCP Registry draft
mcp/smithery.yaml      Smithery draft
scripts/…              wallets, buy, smoke, tests

メインネット／デプロイ

DEPLOY.md を参照してください。実際の USDC を使う意図がない限り、メインネットに対して npm run buy を実行しないでください。

ライセンス

MIT