クエリテンプレート

クエリテンプレートとは

クエリテンプレートは、Solana、Ethereum、BSC でよく使う分析ユースケースをカバーする、あらかじめ書かれた GraphQL クエリです。各テンプレートは特定の Cube を対象とし、正しいクエリ構造・フィールド・フィルター引数が埋め込まれており、プレースホルダーを実値に置き換えればすぐ実行できます。テンプレートで次のことができます。

スキーマを例から学ぶ — 実際のクエリでフィルターや並び順がどう動くか確認する
ゼロから書かずに素早く始める
知らなかった Cube を見つける

テンプレートへのアクセス

サイドバーを開く

サイドバーのトグルをクリックするか、Ctrl/Cmd+B で左パネルを開きます。

Queries タブを選ぶ

サイドバーには Queries（テンプレート）と Saved（保存したクエリ）の 2 タブがあります。Queries を選びます。

チェーンと Cube で閲覧

テンプレートはツリーで整理されています。Chain（Solana / Ethereum / BSC）→ Cube（DEXTrades、Transfers など）→ Template の順です。

クリックして読み込む

任意のテンプレートをクリックするとクエリエディターに読み込まれます。プレースホルダーは置き換えしやすいよう強調表示されます。

テンプレートの構成

テンプレートは 2 階層です。

Chain (Solana / Ethereum / BSC)
 └── Cube
      └── Template

各チェーンには同じ Cube とテンプレートのセットがあり、正しい network 値（sol、eth、bsc）で事前設定されています。

テンプレート一覧

Cube	テンプレート	件数
DEXTrades	Latest Trades · Token Trades · Pair Trades · Trades by DEX · Wallet Trades	5
Transfers	Token Transfers · Wallet Transfers	2
BalanceUpdates	Token Balance Updates · Wallet Balance Updates	2
DEXPools	Pool Info · Token Pools · Liquidity Snapshots	3
TokenSupplyUpdates	Mint & Burn Events · Market Cap (via TokenSupplyUpdates)	2
TokenHolders	Top Holders	1
WalletTokenPnL	Wallet PnL	1
Pairs	Price Candles	1
Tokens	Trade Statistics · Search Tokens (via token dimensions)	2

よく使う Cube は 19 テンプレートでカバーしています。各テンプレートはサポートするすべてのチェーンで利用できます。

Cube 別テンプレート詳細

DEXTrades（5 テンプレート）

テンプレート	説明	プレースホルダー
Latest Trades	ネットワーク上の直近の DEX 取引	—
Token Trades	特定トークンに関する取引	`TOKEN_ADDRESS`
Pair Trades	特定トークンペアの取引	`TOKEN_ADDRESS`（×2）
Trades by DEX	DEX プロトコル名で絞った取引	—
Wallet Trades	ウォレットが実行したすべての DEX 取引	`WALLET_ADDRESS`

Transfers（2 テンプレート）

テンプレート	説明	プレースホルダー
Token Transfers	特定トークンの転送イベント	`TOKEN_ADDRESS`
Wallet Transfers	ウォレットが送受信したすべての転送	`WALLET_ADDRESS`

BalanceUpdates（2 テンプレート）

テンプレート	説明	プレースホルダー
Token Balance Updates	特定トークンの残高変化イベント	`TOKEN_ADDRESS`
Wallet Balance Updates	ウォレットのすべての残高変化	`WALLET_ADDRESS`

DEXPools（3 テンプレート）

テンプレート	説明	プレースホルダー
Pool Info	特定プールのメタデータと準備金	`POOL_ADDRESS`
Token Pools	トークンを含むすべての流動性プール	`TOKEN_ADDRESS`
Liquidity Snapshots	プールの時系列での流動性データ	`POOL_ADDRESS`

TokenSupplyUpdates（2 テンプレート）

テンプレート	説明	プレースホルダー
Mint & Burn Events	トークン供給に影響するミント・バーンイベント	`TOKEN_ADDRESS`
Market Cap	トークンの時価総額スナップショット	`TOKEN_ADDRESS`

TokenHolders（1 テンプレート）

テンプレート	説明	プレースホルダー
Top Holders	残高順の特定トークンの上位保有者	`TOKEN_ADDRESS`

WalletTokenPnL（1 テンプレート）

テンプレート	説明	プレースホルダー
Wallet PnL	ウォレット–トークンペアの実現・未実現 PnL	`WALLET_ADDRESS`, `TOKEN_ADDRESS`

Pairs（1 テンプレート）

テンプレート	説明	プレースホルダー
Price Candles	間隔を設定可能な OHLC ローソク足データ	`TOKEN_ADDRESS`

Tokens（2 テンプレート）

テンプレート	説明	プレースホルダー
Trade Statistics	集計された取引量、件数、ユニークトレーダー数	`TOKEN_ADDRESS`
Search Tokens	名前・シンボル・アドレスによる全文検索	—

プレースホルダー

テンプレートでは、実行前に実際のオンチェーンアドレスに置き換える値を、大文字のプレースホルダーで示します。

プレースホルダー	説明	例
`TOKEN_ADDRESS`	トークンコントラクト／ミントアドレス	`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`（Solana 上の USDC）
`WALLET_ADDRESS`	ウォレットの公開アドレス	`5Q544fKrFoe6tsEbD7S8EmxGTJYAKtTVhAW5Q5pge4j1`
`POOL_ADDRESS`	DEX 流動性プールのアドレス	`58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2`

プレースホルダーはクエリ内の文字列として現れます（例: MintAddress: {is: "TOKEN_ADDRESS"}）。引用符を含めたプレースホルダー文字列全体を、実際のアドレスに置き換えてください。

例: テンプレートの使い方

Solana で DEXTrades → Latest Trades テンプレートを使う手順です。

サイドバーを開きテンプレートを選ぶ

Solana → DEXTrades → Latest Trades に移動し、クリックして読み込みます。

読み込んだクエリを確認する

エディターには次のように入ります。

query {
  Solana {
    DEXTrades(
      limit: {count: 10}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time Slot }
      Transaction { Hash }
      Trade {
        Buy {
          Currency { MintAddress Symbol Name }
          Amount
          PriceInUSD
        }
        Sell {
          Currency { MintAddress Symbol Name }
          Amount
        }
        Dex { ProtocolName }
      }
    }
  }
}

実行する

このテンプレートにプレースホルダーはありません。直近 10 件の取引を取得します。Ctrl/Cmd+Enter で実行します。

反復する

フィルターを追加したり、limit を変えたり、別のフィールドを選んだりしてクエリを調整します。スキーマのオートコンプリートで利用可能なオプションを探せます。

はじめに

GraphQL IDE

スキーマとデータモデル

クエリ例

課金とクレジット

クエリテンプレート