pumpdata

pumpdata の使用例

エージェントやスクリプトから pumpdata.fun を呼び出せます。pump.fun の初日から現在まで、bonding curve と PumpSwap を含むすべての pump.fun の取引を、売却済みのコインも含めてチェーンの台帳から読み取ります。Solana 上で x402 を通じて、呼び出しごとに USDC で支払います。キーもアカウントも不要です。

呼び出し	内容	価格
GET /baserate?band=15k-28k&from=<iso>&to=<iso>&venue=any	指定期間に時価総額の価格帯内で初めて取引されたコインの数と、3 時間以内に 2 倍、5 倍、10 倍、20 倍に達した数	$0.005
POST /wallets {"addresses": [...], "mint": "<optional>"}	最大 50 件のウォレットの実績（勝者、ボット、供給量の売り手、新規）と、その根拠となる SOL	$0.01
GET /launch/{mint}	デプロイヤーの実績、作成時のバンドル、インサイダーの保有割合、同様のローンチが 24 時間でどのように推移したか	$0.005
POST /replay {"picks": [{"mint", "at", "size_sol"}, ...]}	最大 500 件のピックを手数料と約定を含めてチェーンの履歴に照らして再生します（ジョブがキューに登録されます。GET /replay/{id} をポーリングしてください）	$2

無料で支払い不要：各価格帯の昨日のベースレートを /public/baserate.json で公開しています。1 時間ごとに更新されます。

API 仕様：/openapi.json。エージェント向けドキュメント：/llms.txt。スキル：/skill.md。

呼び出しの支払い方法

1. 支払いなしで呼び出します。本文と PAYMENT-REQUIRED ヘッダーに、価格、支払先、ネットワーク（Solana メインネット上の USDC）、入力の Bazaar 宣言を含むオファーが返されます。応答コードは 402 です。
2. ウォレットで、その金額の USDC 送金に署名します（ネットワーク手数料はファシリテーターが支払うため、SOL は不要です）。
3. 署名済みの支払いを PAYMENT-SIGNATURE に含めて再度呼び出します。データが返され、PAYMENT-RESPONSE にレシートが含まれます。

x402 クライアントライブラリが手順 2 と 3 を代行します。すべての応答には X-Data-As-Of（データのビルド元）と X-Data-From（データの開始地点）が含まれます。データのない期間を指定すると、404 が返され、料金はかかりません。

使用例

• curl.sh：402 応答と無料ファイルを確認できます。ウォレットは不要です。
• node.mjs：@x402/fetch と Solana のキーペアを使った有料呼び出しです。
• python.py：Python で 402 応答と無料ファイルを確認でき、有料の再試行には x402 パッケージを使います。
• mcp.md：同じ呼び出しを MCP ツールとして使用できます（Claude Code、Cursor、Cline、Claude Desktop）。

使う前にベースレートを確認：エージェント向けレシピ

有料の GET /baserate（$0.005）を 4 つの形式で紹介します。それぞれ 17～21 行です。支払い用キーは PUMPDATA_PAYER_KEY （base58、または solana-keygen の JSON 配列）から取得します。ウォレットには USDC が必要ですが、SOL は不要です。キーを絶対にコミットしないでください。

ファイル	内容	実行方法
x402-fetch.ts	公式クライアント @x402/fetch + @x402/svm を使った通常の fetch	npm run fetch
elizaos-action.ts	ElizaOS（@elizaos/core 1.x）：PUMPDATA_BASE_RATE アクションを備えた pumpdata プラグイン	npm run eliza
solana-agent-kit-tool.ts	solana-agent-kit v2：プラグイン内の Action を executeAction で実行	npm run agent-kit
vercel-ai-tool.ts	Vercel AI SDK（ai v7）：generateText / streamText 用の tool()	npm run ai-sdk

npm install
export PUMPDATA_PAYER_KEY='<secret key>'
npm run fetch        # yesterday's (UTC) $15-28K base rate, any venue
npm run typecheck

3 つのフレームワーク用ファイルは、x402-fetch.ts の baseRate() を再利用します。単独で実行すると、フレームワークの場合と同様にアクションまたはツールを直接呼び出すため、試す際にモデルやエージェントは必要ありません。

pump.fun との提携関係はありません。