PumpView — Solana Trading & Live Data

PumpView エージェントキット

AI エージェント向けの Solana 取引とリアルタイム取引データです。 スワップを作成し、ローカルで署名して PumpView 経由で送信し、確定後に実行レシートを読み取れます。

取引 API · ダッシュボード · クイックスタート · OpenAPI

公式 MCP レジストリに fun.pumpview/trading として登録されています。ホスト型サーバーは、検証済みの pumpview.fun ドメイン名前空間を使用します。 Glama MCP ディレクトリでも利用できます。

エージェントを接続する

このリポジトリからスキルをインストールします。

npx skills add grinchdev/pumpview-agent-kits --skill pumpview-trading

または、カスタムヘッダーに対応するクライアントでリモート MCP 接続を設定します。

URL: https://api.pumpview.fun/mcp/
Transport: Streamable HTTP
Authorization: Bearer <PUMPVIEW_API_KEY>

ヘッダーの設定方法はクライアントによって異なります。PumpView は OAuth ではなく API キーを使用します。実際のキーはクライアントのシークレットストアに保管してください。初期化、ツールの検出、取引設定は公開されていますが、アカウント操作にはキーが必要です。スキルをインストールしても、アカウントが作成されたり、支出が許可されたりすることはありません。

キーなしで公開情報の検出を試せます（Node 18 以降）。

node examples/mcp-discovery.mjs

アクセスを取得する

PumpView アカウントをお持ちの場合： ダッシュボードに サインインし、署名ウォレットをリンクして API キーを作成します。

エージェント所有のウォレットの場合： /v1/agent/challenge をリクエストし、その正確なメッセージにローカルで署名して、署名を /v1/agent/access に送信します。これにより、ブラウザーで登録せずにキーを作成できます。 ウォレットのオンボーディングに関するリファレンスを参照してください。 PumpView に秘密鍵やシードフレーズを送信しないでください。

アトリビューション

キーの作成時に任意の acquisition_source を記録できるため、PumpView は獲得チャネル別にリクエストと確定済み取引量を報告できます。npx skills でインストールした場合は skills_sh、ClawHub からインストールした場合は clawhub を使用してください。GitHub から直接利用する場合は github を使用できます。出所不明のキットをインストールした場合は agent_kit を使用します。Python クライアントの complete_wallet_access(..., acquisition_source="skills_sh") は、このラベルを受け付けます。 これはクライアントが申告するアトリビューションであり、紹介の検証ではありません。元のリファラー URL やシークレットを送信しないでください。手数料、上限、権限には影響しません。

MCP 経由でリアルタイムデータへのアクセスを購入する

list_data_plans → get_payment_instructions → prepare_invoice_payment の順に使用します。請求書と未署名の支払い内容を確認してから、ローカルウォレットで署名し、ブロードキャストしてください。取引がファイナライズされるまで、confirm_invoice_payment にその取引署名を指定して呼び出し、その後 get_access_status を読み取ります。既存の請求書を復元するには get_invoice_status を使用します。確認が保留中の間は、支払いを繰り返さないでください。取引にデータパッケージは必要ありません。Coinbase のサービスは不要です。

Python クライアント

Python 3.10 以降が必要です。クライアントに実行時依存関係はありません。ローカルクローンからインストールします。

git clone https://github.com/grinchdev/pumpview-agent-kits.git
cd pumpview-agent-kits
python -m pip install -e .

環境変数またはシークレットマネージャーを通じて PUMPVIEW_API_KEY を読み込み、スリッページ 1% で 0.06 SOL → USDC の未署名スワップを作成します。

python examples/build_swap.py --wallet YOUR_LINKED_PUBLIC_KEY --output USDC --amount 60000000 --slippage-bps 100 --state state/intent-001.json

この例では、PumpView に接続する前にリクエスト ID を保存します。同じファイルと引数で実行すると、ビルドがタイムアウトした後に復旧できます。ビルドとシミュレーションのみを行い、署名や送信は行いません。USD の最低額チェックでは現在の価格が使われるため、新しいインテントを開始する前に、この例の金額を調整する必要がある場合があります。

クライアントには、wallet_challenge、complete_wallet_access、trading_config、swap_status、trading_usage、recent_trades、submit_swap も用意されています。**submit_swap はトランザクションをブロードキャストし、資金を使用する可能性があります。**ユーザーが承認したローカルウォレットで確認し、署名したバイト列のみを指定してください。

import os
from pumpview_agent_kit import PumpView

client = PumpView(os.environ["PUMPVIEW_API_KEY"])
policy = client.trading_config()
volume = client.trading_usage()
# Recover a known submission without creating or sending another trade:
# receipt = client.swap_status(saved_swap_id)

TypeScript の場合、examples/build_swap.mts は Node 22.18 以降で直接実行できます。PUMPVIEW_API_KEY、PUMPVIEW_WALLET、PUMPVIEW_OUTPUT、PUMPVIEW_AMOUNT、PUMPVIEW_SLIPPAGE_BPS と、事前に保存した PUMPVIEW_REQUEST_ID を指定してください。PUMPVIEW_INPUT の既定値は SOL です。node examples/build_swap.mts を実行します。この例もビルドとシミュレーションのみを行います。

取引ワークフロー

1. /v1/swaps/config を読み込み、利用可能状況、サポートされているペア、現在のコストを確認します。
2. 一意のリクエスト ID と正確なインテントを保存します。REST または MCP を使ってビルドします。
3. 返されたバージョン付きメッセージ、最低出力額、手数料、チップを承認済みのインテントと照合して確認し、独自のウォレットアダプターを使って正確なメッセージに署名します。
4. ビルド ID と署名済みバイト列を安全に保存します。署名済みトランザクションを送信します。
5. 同じスワップ ID をポーリングします。submitted の応答は実行を意味しません。レシートは confirmed から始まります。finalized の決済が必要な場合は、ポーリングを続けてください。

SDK には、意図的に自動リクエスト再試行やウォレット署名機能がありません。 ビルドがタイムアウトした後はリクエスト ID を再利用し、送信がタイムアウトした後は同じスワップ ID を照会してください。ブロックハッシュを自動的に変更したり、代わりのリクエストを作成したりしないでください。429 の場合は Retry-After に従ってください。完全な 統合リファレンスでは、認証、復旧、原子単位について説明しています。

コストとサポートされているペア

• 取引 API の利用にサブスクリプション料金はかかりません。実行されたスワップには0.5% のプラットフォーム手数料に加え、チップとネットワークコストがかかります。最低チップは 0.002 SOL です。
• 少なくとも片方のレッグは SOL、WSOL、またはネイティブ Solana USDC である必要があります。それ以外の TOKEN–TOKEN スワップと、ラップのみの SOL–WSOL リクエストはサポートされていません。ルーティングには Jupiter を使用します。利用可能かどうかはトークンと現在のプールによって異なります。
• SOL はラップ／アンラップを伴うネイティブ SOL を意味し、WSOL は SPL トークン残高を意味します。ExactIn の金額は原子単位の整数文字列で指定し、スリッページは明示します。
• 最低スワップ額は、Unlimited 未加入の場合 5 ドル相当です。Unlimited ではこの最低額がなくなります。すべての取引で、コストと該当するレンタル料を支払うのに十分な SOL が引き続き必要です。
• PumpView は MEV 保護機能付きのランディングインフラストラクチャを通じて、4 つのバリデーターに同時に送信します。PumpView によると、現在のブロックへの計測済み取り込み時間は 100 ms 未満です。これは独自のベンチマークであり、確定／ファイナライズのタイミングに関する SLA ではありません。
• 認証済み HTTP 呼び出しと MCP 呼び出しは、Free または Day Pass／Starter／Unlimited のアカウントごとに、毎秒 3／5／20 リクエストの上限を共有します。キーを増やしても上限は増えません。

ライブデータと取引量

取引とライブデータへのアクセスは別々です。データの利用には有効なプランが必要です。 現在のプランが正式な情報源です。現在、Unlimited は30日間で49 USDCです。すべてのプランで、1アカウントにつきWSS接続は1つです。 USDCの請求書による直接支払いにCoinbaseは必要ありません。

get_recent_tradesは、受理されたスワップの概要を返します。get_stream_connection はwss://api.pumpview.fun/v1/streamについて説明します。エージェントのランタイムで ソケットと再生カーソルを維持します。フィードにはPumpViewの疑わしい価格を除外する フィルターとデコーダーの対応範囲が反映されます。Solanaの個々のスワップすべてや アーカイブ履歴を網羅するものではありません。

get_trading_usage / /v1/swaps/usageは、アカウント単位およびキー単位の約定取引量を 返します。確定したスワップは1回だけカウントされ、ファイナライズやポーリングの繰り返しで 取引量が増えることはありません。USDの合計にはビルド時の価格推定値を使用します。価格が 付いていないスワップも表示されます。

開発

python -m unittest discover -s tests

server.jsonは、公式Registry向けのホスト型MCPについて記述します。マニフェストを 公開しても、新しいサーバーがデプロイされるわけではありません。ホスト型サービスには、 独自のアクセス制御と手数料が適用されます。このリポジトリには、MITライセンスの クライアントコード、サンプル、エージェント向け指示が含まれています。バックエンドの 認証情報や署名キーは含まれていません。