mcpField
Q
quicknode-skill

quicknode-skill

github.com/quiknode-labsクラウド・DevOps19253 回インストール11 週間前に更新
リポジトリ

quicknode-skill について

quicknode-skillは、QuicknodeのブロックチェーンAPIとインフラの利用をエージェント向けに案内し、RPC照会からデータ配信、アカウント操作まで扱います。読み取り専用とテストネットを優先し、書き込みや支払いには事前確認を求めます。

主な機能

  1. 01対応チェーンのRPCアクセス
  2. 02StreamsとWebhooksの案内
  3. 03リアルタイムデータの選択肢
  4. 04インデックスデータとDeFi APIの参照
  5. 05インフラ変更時の安全確認

活用シーン

  1. 01RPCでブロックチェーンデータを照会
  2. 02監視と履歴データパイプラインの計画
  3. 03実行前のリソース作成内容の確認

MCP 対応

Quicknode MCPについて説明し、MCP対応AIツールからQuicknodeを管理するAdmin APIコネクターを紹介します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/quiknode-labs/blockchain-skills --skill quicknode-skill

インストール後、Claude Code で/quicknode-skillを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

PRODUCT_CATALOG.md
references/
addons.md
admin-api-reference.md
agent-identity-reference.md
agent-subscriptions-reference.md
blockbook-reference.md
cli-reference.md
hypercore-hyperliquid-reference.md
ipfs-reference.md
kv-reference.md
mcp-reference.md
metaplex-das-reference.md
mpp-reference.md
ordinals-runes-reference.md
rpc-reference.md
sdk-reference.md
solana-das-api-reference.md
solana-grpc-reference.md
sql-explorer.md
streams-backfills-reference.md
streams-reference.md
swap-api-reference.md
webhooks-reference.md
x402-reference.md

詳細

Quicknode ブロックチェーンインフラストラクチャ

初回確認事項

  • Quicknode の対象とするチェーンとネットワークを教えてください。
  • 読み取り専用ですか、それともインフラストラクチャ（ストリーム、Webhook、IPFS への書き込み）を作成しますか？
  • リアルタイムストリーミング（Solana gRPC／Blazar WSS／HyperCore gRPC）が必要ですか、それとも標準 RPC で十分ですか？
  • 使用するエンドポイントまたは API キーを教えてください（デフォルト：QUICKNODE_RPC_URL、オプション：QUICKNODE_WSS_URL／QUICKNODE_API_KEY）。
  • API キーがない場合、エージェントは従量課金アクセス（x402、MPP）を希望しますか、それともエージェントサブスクリプションを通じてウォレットで支払う Quicknode アカウントを希望しますか？
  • 制約（レイテンシ、リージョン、スループット、送信先）はありますか？

安全性のデフォルト設定

  • ネットワークが指定されていない場合は、テストネット／devnet をデフォルトにします。
  • リソースを作成する前に、読み取り専用操作とドライランを優先します。
  • 秘密鍵やシークレットキーを要求したり、受け取ったりしないでください。

書き込み前の確認

  • Streams、Webhooks、IPFS アップロードを作成または変更する前に、明示的な確認を求めます。
  • Agent Subscription の作成、クレジットの追加、または x402 や MPP を通じて実際の資金を使用する操作の前に、明示的な確認を求めます。
  • 確認がない場合は、確認用に正確な API ペイロードを返します。

クイックリファレンス

インフラストラクチャ
製品説明ユースケース
Core RPC API80 以上のチェーンに対応した高性能なブロックチェーンアクセスdApp バックエンド、ウォレットとのやり取り
Dedicated Clusters専用のプライベートノードクラスター高スループットの本番環境、コンプライアンス上の分離
IPFS分散型ファイルストレージNFT メタデータ、アセットのホスティング
リアルタイムデータ
製品説明ユースケース
Streamsブロックチェーンデータのリアルタイムおよび履歴データパイプラインイベント監視、分析、インデックス作成
Streams BackfillsStreams へのオンデマンドの履歴データ補完データ欠損の回復、履歴データの再インデックス
Webhooksイベント駆動型の通知アラート、トランザクション監視
Solana gRPCSolana Geyser のストリーミング — Scale／Business プランに含まれ、Build／Accelerate プランではアドオンアカウント、トランザクション、スロットデータのリアルタイム取得
Blazar WSSQuicknode が構築した Solana WebSocket エンジン — すべてのプランで利用可能、無料ブロック、アカウント、トランザクション、スロットの高速なサブスクリプション
HyperCore gRPCHyperliquid L1 向けの gRPC ストリーミング — すべての有料プランに含まれる取引、オーダーブックの差分、イベント、ブロックのリアルタイム取得
インデックス済みデータ
製品説明ユースケース
SQL Explorerインデックス済みブロックチェーンデータへの直接 SQL アクセス取引分析、履歴クエリ、市場分析
Agent Identity (ERC-8004)オンチェーンのエージェント検出と評判記録エージェントの識別情報、機能の公開
BlockbookJSON-RPC によるウォレット中心のブロックチェーンデータアドレス残高、UTXO、トランザクション履歴
Metaplex DAS APISolana Digital Asset Standard — NFT、cNFT、代替可能トークン、MPL CoreNFT／トークンのクエリ、圧縮 NFT、アセット検索
Ordinals & Runes APIBitcoin のインスクリプションと Runes プロトコルデータインスクリプションの検索、UTXO の追跡、Runes 残高
トレーディングと DeFi
製品説明ユースケース
Swap API複数の DEX を集約したトークンスワップSolana（Jupiter／Metis）、EVM（0x、OpenOcean、Aerodrome、Velodrome、Titan）
エンドポイントの追加機能
製品説明ユースケース
Solana Priority Fee APISolana トランザクションに推奨される優先手数料手数料の見積もり、トランザクションの確実な処理
Jito BundlesSolana バンドルの送信およびステータス APIMEV を考慮したトランザクションの配信
Single Flight RPC同一の処理中 RPC 呼び出しのリクエスト重複排除高並行読み取りワークロード
Multi-region Transaction Broadcast複数リージョンにわたるトランザクションの伝播レイテンシが重視される送信
Risk Assessment APIウォレットおよびトランザクションのリスクデータコンプライアンス、不正監視
Block Timestamp Lookupタイムスタンプからブロックを検索するユーティリティ時間範囲からブロック範囲への変換
Multi-chain Stablecoin Balance API対応チェーン全体のステーブルコイン残高財務、決済、ポートフォリオの状態
GoldRush Multichain Data APIsマルチチェーンのウォレットおよびポートフォリオデータウォレットの概要、トークン／NFT の保有状況
エージェント向け機能
製品説明ユースケース
x402テストネットでは月間上限、メインネットではステーブルコインによるリクエストごとの支払いAPI キー不要の RPC アクセス、AI エージェント、従量課金
MPPテストネットでは月間上限、メインネットでは IETF Payment Authentication によるリクエストごとの支払いAI エージェント、複数サービスの支払い、大量のセッション
Agent Subscriptionsウォレットで支払う Quicknode アカウントの作成。QN_* のフルプラットフォーム API キーを返しますフルプラットフォームアクセスを必要とする自律型エージェント
Quicknode CLIエンドポイント、Streams、Webhooks、KV、SQL をターミナルから操作する qn CLI。Tooling Access または x402／MPP の支払いによる RPC にも対応スクリプト作成、CI/CD、インフラストラクチャの自動化、API キー不要の有料 RPC
Quicknode MCPネイティブの Claude／OpenAI コネクターと汎用 MCP サーバー — MCP 経由の Admin APIClaude、ChatGPT、Codex、Cursor、または MCP 対応の AI ツールから Quicknode を管理
プラットフォーム
製品説明ユースケース
Admin APIアカウント管理用 REST APIエンドポイントの作成・読み取り・更新・削除、使用状況の監視、請求
Key-Value Storeサーバーレスのキー・バリューストレージおよびリストストレージ（ベータ版）Streams 用の永続状態、動的なアドレスリスト
Quicknode SDKQuicknode 製品 API 用の公式 SDK。Tooling Access または x402／MPP の支払いによる RPC にも対応Admin API、Streams、Webhooks、KV、SQL Explorer、RPC 呼び出し

コア RPC API

Quicknode は、80 以上のブロックチェーンネットワーク向けに低レイテンシの RPC エンドポイントを提供します。

qn rpc call（CLI）と qn.rpc.call（SDK）を使うと、Quicknode が短期間有効な JWT を使用して自動的にプロビジョニングする、単一のマルチチェーン読み取り専用エンドポイントである Tooling Access 経由で、対応する任意のネットワークにアクセスできます。エンドポイントのセットアップは不要です。references/cli-reference.md／references/sdk-reference.mdを参照してください。固定 URL、読み取り専用ではないメソッド、または専用スループットが必要な場合は、以下の専用エンドポイントを使用してください。

エンドポイントのセットアップ
// EVM chains (ethers.js)
import { JsonRpcProvider } from 'ethers';
const provider = new JsonRpcProvider(process.env.QUICKNODE_RPC_URL!);

// EVM chains (viem)
import { createPublicClient, http } from 'viem';
import { mainnet } from 'viem/chains';
const client = createPublicClient({
  chain: mainnet,
  transport: http(process.env.QUICKNODE_RPC_URL!),
});

// Solana
import { createSolanaRpc } from '@solana/kit';
const rpc = createSolanaRpc(process.env.QUICKNODE_RPC_URL!);
認証

Quicknode エンドポイントでは、URL に認証情報が含まれます。

https://{ENDPOINT_NAME}.{NETWORK}.quiknode.pro/{API_KEY}/

セキュリティをさらに強化するには、Quicknode ダッシュボードで JWT 認証または IP 許可リストを有効にしてください。

対応ネットワーク
カテゴリネットワーク
EVMEthereum、Polygon、Arbitrum、Optimism、Base、BSC、Avalanche、Fantom、zkSync、Scroll、Linea、Hyperliquid EVM（HyperEVM）
非 EVMSolana、Bitcoin、NEAR、Stacks、Cosmos、Sei、Aptos、Sui、TON、Hyperliquid（HyperCore）

すべてを網羅した一覧ではありません。完全な一覧：https://www.quicknode.com/chains

レート制限とプラン

2026-02-02 時点の情報です。本番システムの規模を決める前に、Quicknode のドキュメントで現在の制限を確認してください。

プランリクエスト/秒クレジット/月
無料トライアル1510M
Build5080M
Accelerate125450M
Scale250950M
Business5002B

EVM、Solana、Bitcoin の各チェーンのメソッド表、WebSocket のパターン、バッチリクエストの例など、RPC の完全なドキュメントについては、references/rpc-reference.md を参照してください。

IPFS

Quicknode の IPFS ゲートウェイを利用した分散型ファイルストレージです。

アップロード例、メタデータの例、IPFS の完全なドキュメントについては、references/ipfs-reference.md を参照してください。

専用クラスター

予測可能なスループット、リージョンごとのピン留め、またはコンプライアンス上の分離を必要とするチーム向けの、専用プライベートノードクラスターです。エージェントが専用クラスターを直接プロビジョニングすることは通常ありません。これはアカウント所有者が行うインフラストラクチャ上の判断です。

マーケティング： https://www.quicknode.com/clusters ドキュメント： https://www.quicknode.com/docs/custom-rpc-options

Streams

ブロックチェーンのリアルタイムデータと履歴データをフィルタリング、変換し、指定した送信先に届けるデータパイプラインです。

ストリームの種類
種類データ用途
ブロックブロックの全データブロックエクスプローラー、分析
トランザクショントランザクションの詳細トランザクションの監視、インデックス作成
ログコントラクトイベントDeFi の追跡、NFT の販売、トークンの送金
レシートトランザクションレシートガス分析、ステータスの追跡
クイックセットアップ
  1. Quicknode ダッシュボードでストリームを作成します
  2. ネットワークとデータの種類を選択します
  3. フィルター関数（JavaScript）を追加します
  4. 送信先（webhook、S3、データベース）を設定します

フィルターの例と Streams の完全なドキュメントについては、references/streams-reference.md を参照してください。

Streams のバックフィル

既存のストリームに、オンデマンドで履歴データを配信します。バックフィルを使うと、欠損データを復元したり、新しいデータストアに履歴データを投入したり、パイプラインを再構築せずにブロック範囲を再インデックスしたりできます。

ドキュメント： https://www.quicknode.com/docs/streams/backfilling

使用するタイミング
  • ストリームの送信先が停止しており、見逃したブロックを再生する必要がある場合。
  • 新しいストリームを開始し、ブロック N から現在の最新ブロックまでの履歴データが必要な場合。
  • フィルター関数を更新した後、ブロック範囲を再処理する場合。
提供する情報

エージェントにバックフィルの実行を依頼する際は、次の情報を提供してください。

  • ストリーム ID（Quicknode ダッシュボードまたは Admin API から取得）
  • 開始ブロック番号
  • 終了ブロック番号（または latest）
  • 送信先の確認（バックフィルはストリームの既存の送信先にデータを配信します）

データセットの選択、範囲の計画、バッチ処理、圧縮、コストの目安、自動化に関する注意事項については、references/streams-backfills-reference.md を参照してください。

Webhooks

ブロックチェーン上のアクティビティをイベント駆動で通知します。

Webhooks と Streams の比較
機能WebhooksStreams
セットアップシンプルより多くの設定が必要
フィルタリングアドレス／イベントベースカスタム JavaScript
送信先HTTP エンドポイントのみWebhook、S3、Postgres、Azure
処理基本的な処理完全な変換
用途シンプルなアラート複雑なパイプライン

API の例と Webhooks の完全なドキュメントについては、references/webhooks-reference.md を参照してください。

Solana gRPC（旧 Yellowstone gRPC）

gRPC 経由でブロックチェーンデータをリアルタイムにストリーミングする、高性能な Solana Geyser プラグインです。Scale プランと Business プランに含まれ、Build プランと Accelerate プランではアドオンとして利用できます。

クイックセットアップ
import Client, { CommitmentLevel } from "@triton-one/yellowstone-grpc";

// Derive from HTTP URL: https://example.solana-mainnet.quiknode.pro/TOKEN/
const client = new Client(
  "https://example.solana-mainnet.quiknode.pro:10000",
  "TOKEN",
  {}
);

const stream = await client.subscribe();
stream.on("data", (data) => {
  if (data.transaction) console.log("Tx:", data.transaction);
});

stream.write({
  transactions: {
    txn_filter: {
      vote: false,
      failed: false,
      accountInclude: ["PROGRAM_PUBKEY"],
      accountExclude: [],
      accountRequired: [],
    },
  },
  accounts: {},
  slots: {},
  blocks: {},
  blocksMeta: {},
  transactionsStatus: {},
  entry: {},
  accountsDataSlice: [],
  commitment: CommitmentLevel.CONFIRMED,
});
フィルターの種類
フィルター説明
accountspubkey、owner、またはデータパターンによるアカウントデータの変更
transactions投票／失敗／アカウントのフィルターを適用できるトランザクションイベント
transactionsStatus軽量なトランザクションステータスの更新
slotsスロットの進行状況とステータスの変更
blocksオプションでトランザクション／アカウントを含められるブロック全体のデータ
blocksMeta全コンテンツを含まないブロックメタデータ
entryPoH エントリーの更新

Solana gRPC の完全なドキュメントについては、references/solana-grpc-reference.md をご覧ください。

Blazar WSS

Quicknode が構築した Solana WebSocket エンジンです。標準の Solana サブスクリプションメソッド（blockSubscribe、accountSubscribe、transactionSubscribe、logsSubscribe など）をすべて、信頼性と速度を高めて再構築しています。すべてのプランで無料で利用でき、アドオンは不要です。標準の Solana RPC と同じ WSS エンドポイント URL（QUICKNODE_WSS_URL）を使用します。

ドキュメント： https://www.quicknode.com/docs/solana

クイックセットアップ
const ws = new WebSocket(process.env.QUICKNODE_WSS_URL!);

ws.on('open', () => {
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'blockSubscribe',
    params: ['all', { commitment: 'confirmed', encoding: 'jsonParsed' }]
  }));
});

ws.on('message', (raw) => {
  const msg = JSON.parse(raw.toString());
  if (msg.params?.result?.value?.block) {
    console.log('New block slot:', msg.params.result.context.slot);
  }
});
対応しているサブスクリプションメソッド

blockSubscribe、accountSubscribe、logsSubscribe、programSubscribe、signatureSubscribe、slotSubscribe、slotsUpdatesSubscribe、transactionSubscribe、voteSubscribe

HyperCore（Hyperliquid）

Hyperliquid L1 チェーン向けの Quicknode のデータ配信インフラストラクチャです。gRPC、JSON-RPC、WebSocket、Info API を利用できます。現在、パブリックベータ版です。有料プランすべてに含まれています。

アクセス方法
方法パス／ポート用途
Info API/info (POST)市場データ、ポジション、注文に関する 50 以上のメソッド
JSON-RPC/hypercore (POST)ブロッククエリ（hl_getBlock、hl_getBatchBlocks）
WebSocket/hypercore/wsリアルタイムサブスクリプション（hl_subscribe）
gRPCポート 10000取引、注文、板情報向けの最低レイテンシーのストリーミング
gRPC ストリームの種類
ストリームボリューム説明
TRADES高約定データ：コイン、価格、数量、売買方向、手数料
ORDERS非常に高18 種類以上のステータスに対応した注文ライフサイクル
BOOK_UPDATES非常に高L2 注文板の差分
TWAP低時間加重平均価格注文の更新
EVENTS高台帳の更新、資金調達、入金、出金
BLOCKS極めて高HyperCore の生ブロック（gRPC のみ）
WRITER_ACTIONS低システムレベルのトークン送金
HyperEVM
パスDebug／Traceアーカイブ用途
/evmいいえ部分的標準的な EVM 操作
/nanorethはい拡張デバッグ、トレース、WebSocket サブスクリプション

HyperCore と Hyperliquid の完全なドキュメントについては、references/hypercore-hyperliquid-reference.md をご覧ください。

SQL Explorer

インフラストラクチャを必要とせず、インデックス化されたブロックチェーンデータに SQL で直接アクセスできます。標準的な SQL 構文を使って、オンチェーンデータの数十億行をクエリし、数秒で結果を取得できます。

ドキュメント： https://www.quicknode.com/docs/sql-explorer

クイックセットアップ
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "SELECT timestamp, coin, side, price, size FROM hyperliquid_trades WHERE block_time > now() - INTERVAL 1 HOUR ORDER BY block_number DESC LIMIT 10",
    "clusterId": "hyperliquid-core-mainnet"
  }'
カバレッジ

Hyperliquid（HyperCore） - 取引、注文、約定、資金調達、注文板の差分、無期限市場、現物市場、ブロック、トランザクション、システムアクション、ビルダーのアクティビティ、ステーキング、台帳の更新などをカバーするテーブルです。

主な機能
  • インフラストラクチャ不要 - データベースやインデクサーのセットアップは不要です
  • 標準 SQL - JOIN、サブクエリ、CTE、ウィンドウ関数を含む完全な SQL 構文に対応
  • 40 以上の事前構築済みクエリ - 取引分析、クジラ追跡、清算に関する一般的なパターン
  • 最適化されたパフォーマンス - 月単位のパーティショニング、ソートキー、カラム型ストレージ
  • REST API - HTTPS 経由でプログラムからクエリを実行

テーブルスキーマ、クエリ例、最適化のヒント、API リファレンスの全内容については、references/sql-explorer.md をご覧ください。

エージェントのアイデンティティ（ERC-8004）

ERC-8004 標準に基づく、オンチェーンのエージェントアイデンティティと評判の検索機能です。erc-8004.quicknode.com は、対応する EVM ネットワーク全体の登録、フィードバック、検証、評判をインデックス化します。

API ベース： https://erc-8004.quicknode.com REST プレフィックス： /v1

検証済みエンドポイント、x402 の動作、レート制限、オンチェーン登録のガイダンスについては、references/agent-identity-reference.md を参照してください。

Blockbook

Blockbook JSON-RPC アドオンを通じた、ウォレットを中心とするブロックチェーンデータです。対応チェーン全体のアドレス残高、UTXO セット、トランザクション履歴を提供します。特に、標準の RPC メソッドではウォレットレベルのインデックス機能が不足している Bitcoin などの UTXO ベースのチェーンで役立ちます。

製品情報： https://www.quicknode.com/blockbook ドキュメント： https://www.quicknode.com/docs/bitcoin/blockbook/overview

対応チェーン

Bitcoin（BTC）、Ethereum（ETH）、Bitcoin Cash（BCH）、Dogecoin（DOGE）、Litecoin（LTC）、Zcash（ZEC）。各チェーンは、エンドポイント上で個別のアドオンとして利用できます。

使用する場面
  • Bitcoin または UTXO チェーンのアドレスについて、残高全体とトランザクション履歴を取得する場合。
  • トランザクションを構築するために UTXO を取得する場合。
  • 個人用インデクサーを実行せずに、アドレスの承認済み／未承認の残高を調べる場合。

メソッドと使用例については、references/blockbook-reference.md を参照してください。

Metaplex DAS API（Solana）

Solana のデジタルアセットを照会するための包括的な API です。標準 NFT、圧縮 NFT（cNFT）、代替可能トークン、MPL Core Assets、Token 2022 Assets に対応します。Quicknode Solana エンドポイントで、Metaplex Digital Asset Standard（DAS）API アドオンとして利用できます。以前、このスキルでは「Solana DAS API」として記載されていました。

製品情報： https://www.quicknode.com/metaplex-das-api ドキュメント： https://www.quicknode.com/docs/solana/solana-das-api

クイックセットアップ
// Get all assets owned by a wallet
const response = await fetch(process.env.QUICKNODE_RPC_URL, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'getAssetsByOwner',
    params: {
      ownerAddress: 'E645TckHQnDcavVv92Etc6xSWQaq8zzPtPRGBheviRAk',
      limit: 10,
      options: { showFungible: true, showCollectionMetadata: true }
    }
  })
});
const { result } = await response.json();
// result.total — total assets
// result.items — array of asset metadata
// result.cursor — for pagination
利用可能なメソッド
メソッド説明
getAsset単一アセットのメタデータを取得
getAssets複数アセットのメタデータを取得
getAssetProof圧縮アセットの Merkle 証明を取得
getAssetProofs複数アセットの Merkle 証明を取得
getAssetsByAuthorityオーソリティ別にアセットを一覧表示
getAssetsByCreator作成者別にアセットを一覧表示
getAssetsByGroupグループ（コレクションなど）別にアセットを一覧表示
getAssetsByOwnerウォレット所有者別にアセットを一覧表示
getAssetSignatures圧縮アセットのトランザクション署名を取得
getTokenAccountsミントまたは所有者別にトークンアカウントを取得
getNftEditionsマスター NFT のエディション詳細を取得
searchAssets柔軟なフィルターでアセットを検索

すべてのメソッド、パラメーター、使用例を含む DAS API の完全なドキュメントについては、references/metaplex-das-reference.md を参照してください。

Ordinals & Runes API

Quicknode Ordinals & Runes API アドオンを通じた、Bitcoin のインスクリプションおよび Runes プロトコルのデータです。Bitcoin エンドポイント上で、JSON-RPC と ORD 互換 REST を使用して、インスクリプションのメタデータ、サトシのデータ、Rune の詳細、コレクションデータを照会できます。利用可能なメソッドは 21 個です。

製品情報： https://www.quicknode.com/ordinals-runes ドキュメント： https://www.quicknode.com/docs/bitcoin/ord_getInscription

使用する場面
  • 指定したインスクリプション ID の詳細（コンテンツタイプ、サトシ番号、希少度、生成トランザクション）を調べる場合。
  • Rune のエッチングの詳細、ミントのパラメーター、リアルタイムの供給量を照会する場合。
  • Bitcoin のアウトプットと、それらに含まれるインスクリプションまたは Rune を取得する場合。

対応メソッドと使用例については、references/ordinals-runes-reference.md を参照してください。

アドオン

Quicknode エンドポイントで有効化できる、特定の機能向けのエンドポイントアドオンです。正確な API 形式については、アドオンのドキュメントまたはダッシュボードで提供されるエンドポイントの詳細を参照してください。

Solana Priority Fee API
// Get recommended priority fees
const response = await rpc.request('qn_estimatePriorityFees', {
  last_n_blocks: 100,
  account: 'YOUR_ACCOUNT'
}).send();
Jito Bundles

Jito アドオンを有効にしたユーザー向けの、MEV を考慮した Solana バンドルの送信およびステータス API です。

単一フライト RPC

同一の実行中 RPC 呼び出しに対するリクエストの重複排除です。多くのワーカーやユーザーが同時に同じデータをリクエストする、高並行性アプリケーションに役立ちます。

マルチリージョンのトランザクションブロードキャスト

レイテンシーに敏感なトランザクション送信の伝播を改善するため、署名済みトランザクションを複数のリージョンにブロードキャストします。

リスク評価 API

コンプライアンス、不正行為の監視、リスクを考慮したトランザクションワークフロー向けの、ウォレットおよびトランザクションのリスクデータです。

ブロックタイムスタンプ検索

人間が指定した時間範囲をブロック範囲に変換するための、タイムスタンプからブロックを検索するユーティリティです。

マルチチェーンのステーブルコイン残高 API

トレジャリー、決済、ポートフォリオのワークフロー向けに、対応チェーン全体のステーブルコイン残高を提供します。

GoldRush マルチチェーンデータ API

対応している場合、残高、トークン保有状況、NFT 保有状況、トランザクション履歴などのマルチチェーンウォレットおよびポートフォリオデータを提供します。

最新のアドオン情報と製品固有の参考リンクについては、references/addons.md を参照してください。

Swap API

Quicknode アドオンを介した、複数の DEX を集約したトークンスワップです。Metis/Jupiter、0x、OpenOcean、Aerodrome、Velodrome、Titan Meta Aggregator、Hyperliquid Exchange API に対応しています。各プロバイダーは、エンドポイントまたはアカウントで個別のアドオンまたは製品機能として有効化します。

マーケティング： https://www.quicknode.com/swap-api

Solana — Metis（Jupiter）
import { createJupiterApiClient } from '@jup-ag/api';

const jupiterApi = createJupiterApiClient({
  basePath: process.env.QUICKNODE_METIS_URL!
});

const quote = await jupiterApi.quoteGet({
  inputMint: 'So11111111111111111111111111111111111111112',   // SOL
  outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
  amount: 1_000_000_000,  // 1 SOL in lamports
  slippageBps: 50
});

const swapResult = await jupiterApi.swapPost({
  swapRequest: {
    quoteResponse: quote,
    userPublicKey: 'YourPubkey...'
  }
});
// swapResult.swapTransaction — serialized tx ready for signing

QUICKNODE_METIS_URL に Metis エンドポイント（例：https://jupiter-swap-api.quiknode.pro/YOUR_TOKEN）を設定してください。Quicknode ダッシュボードで Metis Jupiter Swap API アドオンを有効にしてください。

プロバイダーの位置づけ、検証済みの例、安全なデフォルト設定、トラブルシューティングについては、references/swap-api-reference.md を参照してください。

x402（リクエストごとの支払い RPC）

ステーブルコイン決済による、リクエストごとの支払い RPC アクセスです。API キーは不要です。3 つの決済モデルに対応しています。リクエストごとの支払い（$0.001/呼び出し）、ナノペイメント（Circle Gateway 経由で一括処理）、クレジットの引き落とし（SIWX 認証、メインネットのクレジット 100 万件あたり $10）です。テストネットのウォレットでは、ウォレットごとに月間上限 1,000,000 クレジットが共有されます。メインネットのウォレットには上限がありません。Base、Polygon、Solana 上の USDC と、XLayer 上の USDG に対応しています。140 以上のチェーンエンドポイントを利用できます。

クイックセットアップ
import { createQuicknodeX402Client } from "@quicknode/x402";

const client = await createQuicknodeX402Client({
  baseUrl: "https://x402.quicknode.com",
  network: "eip155:84532", // Base Sepolia payment network
  evmPrivateKey: process.env.PRIVATE_KEY as `0x${string}`,
  paymentModel: "pay-per-request",
});

// Use like normal fetch — payment negotiation is handled automatically
const response = await client.fetch("https://x402.quicknode.com/ethereum-mainnet", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    jsonrpc: "2.0",
    method: "eth_blockNumber",
    params: [],
    id: 1,
  }),
});

多くの場合、最も手軽な方法はゲートウェイパッケージではなく、Quicknode CLI または SDK を使うことです。qn rpc call --x402（CLI v0.6.0 以降）、または scheme: "x402" を指定した rpc.payment（SDK は Node 3.8.0 以降、その他の言語は 0.8.0 以降）を使用します。

SIWX 認証、クレジット管理、@quicknode/x402 のセットアップなど、x402 の全ドキュメントについては、references/x402-reference.md を参照してください。

MPP（Machine Payments Protocol）

IETF Payment Authentication ヘッダーによる、リクエストごとの支払い RPC アクセスです。API キーは不要です。2 種類のインテントに対応しています。チャージ（$0.001/リクエスト）とセッション（オフチェーンバウチャー経由で $0.00001/リクエスト）です。Tempo テストネットのウォレットでは、ウォレットごとに月間上限 1,000,000 クレジットが共有されます。メインネットのウォレットには上限がありません。Tempo メインネット上の PathUSD または USDC.e、Tempo テストネット上の PathUSD、または Solana 上の USDC で決済できます。140 以上のチェーンエンドポイントを利用できます。

クイックセットアップ
import { Mppx, tempo } from 'mppx/client'
import { privateKeyToAccount } from 'viem/accounts'

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`)

// Polyfills globalThis.fetch — handles 402 challenges automatically
Mppx.create({
  methods: [tempo({ account })],
})

// Charge intent ($0.001/req) — payment is transparent
const response = await fetch('https://mpp.quicknode.com/tempo-mainnet', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'eth_blockNumber',
    params: [],
  }),
})

const { result } = await response.json()
console.log('Block number:', BigInt(result))

Quicknode CLI と SDK でも、このゲートウェイを利用できます。qn rpc call --mpp（CLI v0.6.0 以降）、または scheme: "mpp" を指定した rpc.payment（SDK は Node 3.8.0 以降、その他の言語は 0.8.0 以降）を使用します。

チャージとセッションのインテントの違い、Solana のセットアップ、CLI の使用方法、決済レシートなど、MPP の全ドキュメントについては、references/mpp-reference.md を参照してください。

エージェントサブスクリプション

自律型エージェント向けの、Quicknode アカウントのプログラムによる作成機能です。x402 または MPP の決済を伴う /api/v1/agent/subscriptions への単一の POST リクエストで、有料アカウントを同期的に作成し、プラットフォーム全体で使える QN_* API キーを返します。ダッシュボードでの登録やメール確認は不要です。x402 および MPP のリクエストごとの RPC に使用する決済 SDK と同じものを、サブスクリプションの決済署名にも使用します。

ドキュメント： https://www.quicknode.com/docs/build-with-ai/agent-subscriptions

使用するタイミング
  • エージェントが永続的な状態を必要とせず、短期間の RPC アクセスのみを必要とする場合は、従量課金（x402、MPP）を使用します。
  • Streams、Webhooks、Key-Value Store、複数のエンドポイント、セキュリティルール、請求、その他の Admin API の機能など、エージェントがプラットフォーム全体を必要とする場合は、Agent Subscriptions を使用します。
プランを確認する

現在のプラン一覧、価格、利用可能な決済ネットワーク、アセットのコントラクトアドレス、受取先（payTo）アドレスを取得するには、決済ヘッダーを付けずにリクエストを送信します。サーバーは HTTP 402 と、本文内の詳細、および PAYMENT-REQUIRED ヘッダー（x402 要件を base64 でエンコードしたもの）を返します。

curl -X POST https://www.quicknode.com/api/v1/agent/subscriptions \
  -H "Content-Type: application/json" \
  -d '{}'

402 の本文を解析してプランを選び、SDK 経由でリクエストを再試行します。

クイックセットアップ（x402）
import { createQuicknodeX402Client } from '@quicknode/x402'

const client = await createQuicknodeX402Client({
  baseUrl: 'https://www.quicknode.com',
  network: 'eip155:8453', // Base Mainnet
  evmPrivateKey: process.env.PRIVATE_KEY as `0x${string}`,
})

const res = await client.fetch(
  'https://www.quicknode.com/api/v1/agent/subscriptions',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      plan_name: 'b6_build', // b6_build | b6_accelerate | b6_scale | b6_business
      interval: 'monthly', // monthly | yearly
      email: '[email protected]',
      password: process.env.ACCOUNT_PASSWORD,
      password_confirmation: process.env.ACCOUNT_PASSWORD,
      full_name: 'Autonomous Agent',
      name: 'Agent Account',
      billing_address: {
        line1: '123 Main St',
        city: 'New York',
        postal_code: '10001',
        country: 'US',
      },
    }),
  },
)

const { api_key } = await res.json() // "QN_..." full platform API key

返される api_key は、このスキルの他の箇所で使用する QUICKNODE_API_KEY と同じです。これを https://api.quicknode.com/v0/... に対して使用すると、エンドポイントのプロビジョニング、セキュリティの設定、クレジットの追加、残高の確認などを行えます。

Solana で支払いますか？ @quicknode/x402-solana を使用すると、EVM の秘密鍵ではなく Solana のキーペアで x402 の支払いに署名できます。設定後のサブスクリプションリクエスト本文と Admin API の手順は、上記の x402 の例と同じです。設定の詳細は、How to Access Solana RPC with x402 ガイドを参照してください。

クイックセットアップ（MPP）
import { Mppx, tempo } from 'mppx/client'
import { privateKeyToAccount } from 'viem/accounts'

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`)

Mppx.create({ methods: [tempo({ account })] })

const subscriptionRes = await fetch(
  'https://www.quicknode.com/api/v1/agent/subscriptions',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      plan_name: 'b6_build', // b6_build | b6_accelerate | b6_scale | b6_business
      interval: 'monthly', // monthly | yearly
      email: '[email protected]',
      password: process.env.ACCOUNT_PASSWORD,
      password_confirmation: process.env.ACCOUNT_PASSWORD,
      full_name: 'Autonomous Agent',
      name: 'Agent Account',
      billing_address: {
        line1: '123 Main St',
        city: 'New York',
        postal_code: '10001',
        country: 'US',
      },
    }),
  },
)

const { api_key } = await subscriptionRes.json() // "QN_..." full platform API key
エンドポイント
メソッドパス認証レート制限用途
POST/api/v1/agent/subscriptions決済ヘッダー（x402 または MPP）IP + メールアドレスごとに 20 回/分、5 回/時アカウントとサブスクリプションを作成
POST/api/v1/agent/top_upAPI キー + 決済ヘッダーAPI キーごとに 30 回/分既存のサブスクリプションにクレジットを追加
GET/api/v1/agent/balanceAPI キーAPI キーごとに 60 回/分現在のクレジット残高を確認

すべてのリクエストの送信先は https://www.quicknode.com です。

プラン ID

b6_build、b6_accelerate、b6_scale、b6_business。これらは pricing に掲載されている一般公開の Build／Accelerate／Scale／Business プランに直接対応しています。エージェントが動的にプランを選択する必要がある場合は、上記のプラン確認用 402 を使用してください。

安全上の制約
  • 実際の資金が必要です：サブスクリプションの決済には、メインネットの決済ネットワーク上の実際のステーブルコインを使用します。リクエストを送信する前に、プラン、期間、決済ネットワークをユーザーに確認してください。
  • メールアドレスの重複防止：既存のメールアドレスを再利用するとエラーが返されます。失敗したリクエストは重複アカウントを作成せず、同じ email と password を使って再開してください。
  • 決済の再試行時の安全性：決済ヘッダーの生成後に検証に失敗した場合は、同じ署名済み決済ヘッダーをバイト単位で変更せずに再試行してください。サーバーが新しいチャレンジを要求しない限り、同じ操作を再試行するために新たな決済へ署名しないでください。
  • 無料トライアルはありません：すべてのサブスクリプションは、最初のリクエストから本番環境向けです。
  • 同期的な作成：アカウントの作成とサブスクリプションの有効化は、同じリクエスト内で行われます。待機が必要な非同期ジョブや Webhook はありません。
  • 詳細を捏造しないでください：請求情報、パスワード、メールアドレスを決して捏造しないでください。ユーザーから明示的に入力してもらってください。パスワードは 8～64 文字で、小文字、大文字、数字、特殊文字をそれぞれ少なくとも 1 つ含める必要があります。

エンドポイントの完全なリファレンス、トップアップのフロー、残高の確認については、references/agent-subscriptions-reference.md を参照してください。

Quicknode CLI

ターミナルから Quicknode インフラを管理するためのコマンドラインツール（qn）です。すべての有料プランで利用できます。

また、キー不要の有料利用方法にも対応しています（v0.6.0 以降）。qn wallet と qn rpc call --x402／--mpp を使うと、Quicknode アカウント、API キー、ログイン、Tooling Access、プロビジョニング済みエンドポイントなしで、ステーブルコインを使って RPC 呼び出しの料金を支払えます。

インストール
# Homebrew
brew install quicknode/tap/qn

# Docker
docker pull quiknode/qn-cli:latest
認証

ローカルで作業する場合は対話型ログインを使用し、非対話型環境では API キーを明示的に渡してください。

qn auth login
qn auth login --api-key <KEY>
qn auth whoami

認証情報の優先順位は、--api-key、--config-file、~/.config/qn/config.toml の順です。CLI は環境変数から API キーを直接読み込みません。

エージェントのコンテキスト
qn agent context
qn agent context -o json
主なコマンド
# Endpoints
qn endpoint list
qn endpoint create --chain ethereum --network mainnet

# RPC (Tooling Access) — no endpoint setup required
qn tooling-access status
qn tooling-access enable
qn rpc call eth_getBlockByNumber '["latest", false]' --network base-mainnet

# Account and chain metadata
qn auth whoami --format json
qn chain credits ethereum --format json

# SQL Explorer
qn sql query "SELECT COUNT(*) FROM hyperliquid_trades" --cluster-id hyperliquid-core-mainnet --format json
qn sql schema hyperliquid-core-mainnet

# Streams / Webhooks / KV
qn stream list
qn webhook list
qn kv set get my-key

機械可読な出力には --format json を使用してください。変更を伴うコマンドは実行前に確認を求めます。自動化で確認プロンプトを省略する場合は、ユーザーから明示的な確認を得てください。

有料 RPC（x402 / MPP）

v0.6.0 以降が必要です。ネットワークとアセットはハードコードせず、提供されているものを確認してください。また、すべての署名アクションで --max-amount（アセットの整数単位で指定する、1 回の呼び出しあたりの上限額）を設定してください。

# One-time keyless setup — the key is written locally and is not recoverable
qn wallet generate --vm evm --name payer

# Discover what each gateway accepts
qn rpc x402 supported-payments
qn rpc mpp supported-payments

# Pay per request (query network and payment network are independent)
qn rpc call eth_blockNumber --network ethereum-mainnet \
  --x402 --payment-wallet payer \
  --payment-network base-sepolia --payment-asset USDC --max-amount 1000

# Prepaid credits (x402) or an escrow channel (MPP) for sustained usage
qn rpc x402 buy-credits --network ethereum-mainnet --payment-wallet payer \
  --payment-network base-sepolia --payment-asset USDC --max-amount 10000000
qn rpc call eth_blockNumber --network ethereum-mainnet --x402-drawdown --payment-wallet payer

これらのコマンドは実際の資金を移動します。事前にユーザーから明示的な確認を得て、専用の最小限の資金だけを入れたウォレットを使用してください。qn wallet rm、qn rpc x402 buy-credits、qn rpc mpp open／top-up／close は実行前に確認を求めます。有料呼び出しは自動再試行されません。終了コード 2 は決済が完了していないことを示し、終了コード 3 は結果が不明で、ウォレットからすでに請求されている可能性があることを示します。再実行せず、ウォレットを確認してください。

CLI の詳細については、references/cli-reference.md を参照してください。

Quicknode MCP

Quicknode Admin API の機能を Model Context Protocol（MCP）経由で AI アシスタントに提供する、Claude/OpenAI ネイティブコネクターおよび汎用 MCP サーバーです。

セットアップ

Claude Web/Desktop： Settings → Customize → Connectors → Quicknode を検索 → Connect。

Claude Code：

claude mcp add --transport http quicknode https://mcp.quicknode.com/mcp

対話型セットアップでは OAuth を使用します。Quicknode にログインし、Viewer または Admin を選択して、アクセスを許可してください。読み取り専用の確認には Viewer を使用し、アシスタントによるリソースの作成、削除、変更が必要な場合に限り Admin を使用してください。

OpenAI（ChatGPT/Codex）： ChatGPT Apps カタログから Quicknode をインストールするか、利用可能な場合は Codex で /plugin を使用してください。最新のセットアップ手順については、Quicknode MCP のドキュメントページにある OpenAI 統合タブを参照してください。

機能

MCP サーバーは、エンドポイント管理（一覧表示、作成、削除、レート制限）、セキュリティルール、使用状況の監視、請求、チェーンの検出を行うツールを提供します。エージェントやユーザーは、AI ツールから離れることなく、会話形式で Quicknode ワークスペースを管理できます。

ツールの全容とセットアップ手順については、references/mcp-reference.md を参照してください。

Quicknode SDK

Quicknode 製品 API（Admin API、Streams、Webhooks、Key-Value Store、SQL Explorer）向けの公式 SDK です。rpc クライアント（Node は 3.7.0+、その他の言語は 0.7.0+）を使用すると、Tooling Access 経由でサポート対象の任意のネットワークに JSON-RPC 呼び出しを行えます。エンドポイントのセットアップは不要です。型付きのチェーン抽象化や専用エンドポイントが必要な場合は、引き続きチェーン固有のクライアントライブラリを使用してください。

同じ rpc クライアントを使って、x402 または MPP 経由でステーブルコインによる呼び出しの支払いもできます（Node は 3.8.0+、その他の言語は 0.8.0+）。Quicknode アカウントや API キーは不要です。

インストール
npm install @quicknode/sdk
基本的な使い方
import { QuicknodeSdk } from '@quicknode/sdk';

const qn = QuicknodeSdk.fromEnv();

const endpoints = await qn.admin.getEndpoints({
  limit: 20,
  sortBy: 'created_at',
  sortDirection: 'desc',
});

const account = await qn.admin.accountInfo();
const apiCredits = await qn.admin.getApiCredits('ethereum');

const trades = await qn.sql.query(
  'SELECT * FROM hyperliquid_trades LIMIT 5',
  'hyperliquid-core-mainnet'
);
RPC マイクロペイメント

rpc.payment を設定すると、SDK が 402 Payment Required のチャレンジに応答し、支払いに署名してリクエストを再送信します。この方法では API キーは必要ありません。

import { QuicknodeSdk, generatePaymentWallet } from '@quicknode/sdk';

// One-time: the key is returned once and cannot be recovered. Persist it securely.
const wallet = generatePaymentWallet('evm'); // 'evm' or 'svm'
console.log('Fund this address:', wallet.address);

const qn = new QuicknodeSdk({
  rpc: {
    payment: {
      scheme: 'x402', // or 'mpp'
      key: process.env.QN_PAYMENT_KEY!,
      payNetwork: 'eip155:84532', // Base Sepolia
      asset: '0x036CbD53842c5426634e7929541eC2318f3dCF7e', // Base Sepolia USDC
      maxAmount: '10000', // spend ceiling in base units, not the amount sent
    },
  },
});

const blockNumber = await qn.rpc.call('eth_blockNumber', [], 'ethereum-mainnet');

callWithReceipt は決済メタデータを返します（MPP では null 以外、x402 では null）。継続的に利用する場合は、gatewayAuthenticate／gatewayBuyCredits／gatewayDrawdownCall（x402 クレジット）、または mppOpen／mppSessionCall（MPP チャネル）を使用してください。この方法では実際の資金が移動します。事前にユーザーから明示的な確認を得てください。また、生の秘密鍵を含む支払い設定をログに記録しないでください。

SDK の詳細については、references/sdk-reference.md を参照してください。

Admin API

Quicknode のエンドポイント、使用状況、レート制限、セキュリティ、請求、チームをプログラムで管理するための REST API です。インフラストラクチャをコードで管理するワークフローを実現します。

クイックリファレンス
リソースメソッドエンドポイント
チェーンGET/v0/chains
アカウント情報GET/v0/account/info
API クレジットGET/v0/api-credits/{chain}
エンドポイントGET, POST, PATCH, DELETE/v0/endpoints
メトリクスGET/v0/endpoints/{id}/metrics
レート制限GET, POST, PUT/v0/endpoints/{id}/method-rate-limits、/v0/endpoints/{id}/rate-limits
セキュリティGET/v0/endpoints/{id}/security_options
ツールへのアクセスGET, PATCH, POST/v0/tooling-access、/v0/tooling-access/token
使用状況GET/v0/usage/rpc、by-endpoint、by-method、by-chain
請求GET/v0/billing/invoices
チームGET/v0/teams
認証

すべてのリクエストでは、https://api.quicknode.com/v0/ に対して x-api-key ヘッダーを使用します。

const QN_API_KEY = process.env.QUICKNODE_API_KEY!;

const res = await fetch('https://api.quicknode.com/v0/endpoints', {
  headers: { 'x-api-key': QN_API_KEY },
});
const endpoints = await res.json();

エンドポイントの CRUD、使用状況の監視、レート制限の設定、セキュリティオプション、Tooling Access、請求、チームを含む Admin API の全ドキュメントについては、references/admin-api-reference.md を参照してください。

キー・バリューストア（ベータ版）

リストとキー・バリューセット向けのサーバーレスストレージです。主に qnLib ヘルパーライブラリを介して Streams のフィルター関数内からアクセスします。REST API からも利用できます。

Stream 連携（qnLib）

リスト操作 — アイテムのリスト（例：ウォレットアドレス）を管理します。

  • qnLib.qnUpsertList — リストを作成または更新
  • qnLib.qnAddListItem — リストにアイテムを追加
  • qnLib.qnRemoveListItem — リストからアイテムを削除
  • qnLib.qnContainsListItems — 一括メンバーシップ確認
  • qnLib.qnDeleteList — リストを削除

セット操作 — キー・バリューペアを管理します。

  • qnLib.qnAddSet — キー・バリューセットを作成
  • qnLib.qnGetSet — キーで値を取得
  • qnLib.qnBulkSets — セットを一括作成／削除
  • qnLib.qnListAllSets — すべてのセットキーを一覧表示
  • qnLib.qnDeleteSet — セットを削除

REST API の使用方法、サイズ制限、CLI（qn kv）コマンドについては、references/kv-reference.md を参照してください。

その他の Quicknode 製品

以下の Quicknode 製品も利用できますが、通常、エージェントが直接呼び出すことはありません。アカウント所有者がダッシュボードから、または人間のオペレーターがプロビジョニングします。

よくあるパターン

マルチチェーン RPC の設定
import { JsonRpcProvider } from 'ethers';

const ethereum = new JsonRpcProvider(process.env.QUICKNODE_ETH_RPC_URL!);
const base = new JsonRpcProvider(process.env.QUICKNODE_BASE_RPC_URL!);

const [ethBlock, baseBlock] = await Promise.all([
  ethereum.getBlockNumber(),
  base.getBlockNumber(),
]);
リアルタイムのトランザクション監視
  1. Stream を作成し、コントラクトアドレスでフィルタリングします
  2. フィルター関数を追加し、関連イベントを抽出します
  3. Webhook の送信先を設定し、サーバーを指定します
  4. バックエンドでイベントを処理します
Solana gRPC によるリアルタイム監視
  1. ポート 10000 で認証トークンを使ってgRPC 経由で接続します
  2. プログラムまたはアカウントでフィルタリングして、トランザクションをサブスクライブします
  3. ストリーミングインターフェースを介して、リアルタイムで更新を処理します
  4. 指数バックオフを使った再接続を実装します
Hyperliquid 取引データパイプライン
  1. 最低レイテンシーを実現するため、ポート 10000 でgRPC 経由で接続します
  2. コインフィルターを指定して、TRADES/ORDERS ストリームをサブスクライブします
  3. イベントを処理します — 約 12 ブロック／秒のスループットに対応します
  4. アカウント状態と市場メタデータには、Info API（/info）を使用します
SQL Explorer による過去の取引分析
  1. 過去の取引をクエリします — SELECT * FROM hyperliquid_trades WHERE block_time > ...
  2. メトリクスを集計します — GROUP BY を使って、出来高、件数、平均値を集計します
  3. テーブルを結合します — 取引、注文、資金調達を組み合わせて包括的に分析します
  4. データをエクスポートします — 後続処理用の JSON として結果を出力します

ベストプラクティス

RPC
  • サブスクリプションとリアルタイムデータには WebSocket を使用します
  • 指数バックオフによる再試行ロジックを実装します
  • データが頻繁に変化しない場合は、レスポンスをキャッシュします
  • バッチリクエストを使用して API 呼び出しを減らします
Streams
  • 狭いフィルターから始め、必要に応じて範囲を広げます
  • デプロイ前にフィルター関数をローカルでテストします
  • Streams は障害発生時に自動的に再試行します
  • ダッシュボードでストリームの状態を監視します
Security
  • API キーは環境変数に保存します
  • 本番環境では IP アロウリストを有効にします
  • 機密性の高い操作には JWT 認証を使用します
  • API キーを定期的にローテーションします
gRPC
  • 帯域幅を削減するために zstd 圧縮を有効にします（Hyperliquid では最大 70％）
  • ストリームが切断されることがあるため、指数バックオフによる再接続ロジックを実装します
  • データ量を最小限に抑えるため、狭いフィルター（特定のアカウント、コイン、プログラム）を使用します
  • 適切なコミットメントレベルを設定します（Solana gRPC：ほとんどのユースケースでは CONFIRMED、不可逆性が必要な場合は FINALIZED）
  • 接続を維持するため、キープアライブの ping を送信します（Solana gRPC では 10 秒ごと、HyperCore では 30 秒ごと）
SQL Explorer
  • パーティションプルーニングのため、常に時間範囲でフィルタリングします（WHERE block_time > ...）
  • スキャンするデータ量を減らすため、探索的なクエリでは LIMIT を使用します
  • 最適なクエリパフォーマンスを得るため、ソートキー（スキーマリファレンスを確認）を活用します
  • 事前構築済みのクエリから始め、ニーズに合わせてカスタマイズします
  • クエリの統計情報（rows_read、bytes_read）を監視して、パフォーマンスを最適化します

ドキュメントリンク

Quicknode 製品
チェーン別ドキュメント
LLM 向けに最適化されたドキュメント
その他のリソース

コメント

Markdown 対応