DEX 取引

DEXTrades Cube には、取引ごとの DEX スワップイベントが格納されています。利用可能な中で最も粒度の細かいトレーディングデータです。個別の取引の取得、ウォレット活動の分析、トークン価格の追跡、トップトレーダーの特定などに使えます。

以下の例はすべて network: sol（Solana）を使用しています。他の対応チェーンでは eth、bsc、polygon に置き換えてください。

最新の DEX 取引を取得するには？

Solana 上の直近 10 件の DEX 取引を取得します。ブロック情報、トランザクションハッシュ、売買の詳細、DEX プロトコルを含みます。

query {
  Solana {
    DEXTrades(
      limit: {count: 10}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time, Slot }
      Transaction { Hash }
      Trade {
        Buy {
          Currency { MintAddress }
          Amount
          PriceInUSD
          Account { Owner }
        }
        Sell {
          Currency { MintAddress }
          Amount
          Account { Owner }
        }
        Dex { ProgramAddress, ProtocolName }
      }
      Pool { Address }
    }
  }
}

GraphQL IDE で開く — 上記クエリを貼り付けて、オートコンプリートとスキーマ探索付きで対話的に実行できます。

主要フィールド

フィールド	説明
`Block.Time`	ブロックのタイムスタンプ（ISO 8601）
`Block.Slot`	Solana のスロット番号（Solana 固有）
`Transaction.Hash`	オンチェーンのトランザクションハッシュ — エクスプローラーで tx を調べる際に使用
`Trade.Buy.Currency.MintAddress`	買い側トークンのアドレス
`Trade.Buy.PriceInUSD`	取引時点での買いトークンの USD 価格
`Trade.Buy.Account.Owner`	買い手ウォレットのアドレス
`Trade.Dex.ProtocolName`	DEX 名（例: Raydium、Orca、Jupiter）
`Pool.Address`	取引が実行された流動性プールのアドレス

カスタマイズのヒント

チェーンの切り替え: network: sol を network: eth、network: bsc、network: polygon に置き換える
件数の増加: count: 10 を最大 10000 まで変更する
時間フィルター: where: {Block: {Time: {after: "2025-03-01T00:00:00Z"}}} を追加して期間を絞る
DEX で絞り込み: where: {Trade: {Dex: {ProtocolName: {is: "Raydium"}}}} を追加して特定プロトコルに限定する

特定トークンの取引を取得するには？

tokenAddress セレクターにトークンアドレスを渡して、そのトークンの取引を取得します。

query {
  Solana {
    DEXTrades(
      limit: {count: 10}
      tokenAddress: {is: "TOKEN_ADDRESS"}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time }
      Trade {
        Buy { Amount, PriceInUSD, Account { Owner } }
        Sell { Currency { MintAddress }, Amount }
        Dex { ProtocolName }
      }
      Pool { Address }
    }
  }
}

TOKEN_ADDRESS を実際のトークン mint アドレスに置き換えてください（例: Solana 上の USDC は EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v）。名前からアドレスを調べる場合はトークンメタデータを参照してください。

主要フィールド

フィールド	説明
`Trade.Buy.Amount`	買い付けたトークン数量
`Trade.Buy.PriceInUSD`	取引時点のトークン単価（USD）
`Trade.Buy.Account.Owner`	買いを実行したウォレット
`Trade.Sell.Currency.MintAddress`	売却側トークンのアドレス（ペアのもう一方）
`Trade.Dex.ProtocolName`	DEX プロトコル名

カスタマイズのヒント

最小数量でフィルター: where: {Trade: {Buy: {Amount: {gt: 1000}}}} を追加して大口取引のみ表示
価格帯でフィルター: where: {Trade: {Buy: {PriceInUSD: {gte: 0.001, lte: 1.0}}}} で価格レンジを指定
疑わしい取引の除外: デフォルトで IsSuspect = false フィルターが適用済み — bot/MEV 取引はすでに除外されています

ウォレットの全取引を取得するには？

特定ウォレットアドレスによるすべての取引を取得します。

query {
  Solana {
    DEXTrades(
      limit: {count: 20}
      walletAddress: {is: "WALLET_ADDRESS"}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time }
      Trade {
        Buy { Currency { MintAddress }, Amount, PriceInUSD }
        Sell { Currency { MintAddress }, Amount }
        Dex { ProtocolName }
      }
      Transaction { Hash, FeeInNative }
    }
  }
}

walletAddress セレクターは、指定ウォレットが買い手または売り手のいずれかである取引にマッチします。

主要フィールド

フィールド	説明
`Trade.Buy.Currency.MintAddress`	買ったトークン
`Trade.Sell.Currency.MintAddress`	売ったトークン
`Transaction.FeeInNative`	ネイティブトークン建てのガス手数料（Solana では SOL）

カスタマイズのヒント

単一トークンに絞る: tokenAddress: {is: "TOKEN_ADDRESS"} と組み合わせて、このウォレットの特定トークン取引のみ表示
時間ウィンドウ: where: {Block: {Time: {after: "2025-03-01T00:00:00Z"}}} を追加して直近の取引に限定
件数の増加: count: 100 に設定してより長い履歴を取得（最大 10,000）

トークンの現在価格を取得するには？

最新の非疑義取引から、トークンの最新価格を取得します。

query {
  Solana {
    DEXTrades(
      limit: {count: 1}
      tokenAddress: {is: "TOKEN_ADDRESS"}
      where: {IsSuspect: {eq: false}}
      orderBy: {descending: Block_Time}
    ) {
      Trade {
        Buy { PriceInUSD, PriceInNative }
      }
      Block { Time }
    }
  }
}

主要フィールド

フィールド	説明
`Trade.Buy.PriceInUSD`	直近取引からの USD 価格
`Trade.Buy.PriceInNative`	チェーンのネイティブトークン（SOL、ETH、BNB）建ての価格
`Block.Time`	取引のタイムスタンプ — 価格の新しさを示す

カスタマイズのヒント

複数価格: count を増やして直近価格の系列を取得し平均化に利用
マルチチェーン: network: eth を使うと Ethereum 上の同一トークン価格を取得（そのチェーンに存在する場合）

時系列で信頼できるトークン価格が必要な場合は、代わりに Pairs Cube の利用を検討してください — 1 分足の open/high/low/close を事前計算したローソク足データを提供します。

トークンのトップトレーダーを見つけるには？

集約を使ってトークンのトップトレーダーを取得します。このクエリは買い手ウォレットごとに取引をグループ化し、買い件数とボリュームの合計を返します。

query {
  Solana {
    DEXTrades(
      limit: {count: 100}
      tokenAddress: {is: "TOKEN_ADDRESS"}
      where: {IsSuspect: {eq: false}}
    ) {
      Trade {
        Buy {
          Account { Owner }
          Amount
          PriceInUSD
        }
      }
      count
      sum(of: Trade_Buy_Amount)
    }
  }
}

主要フィールド

フィールド	説明
`Trade.Buy.Account.Owner`	ウォレットアドレス（グループ化キー）
`count`	このウォレットの取引件数
`sum(of: Trade_Buy_Amount)`	このウォレットが買い付けたトークン合計

カスタマイズのヒント

ボリュームでソート: 結果はディメンションフィールドでグループ化されます — ディメンションを減らすとより高レベルの集約になります
期間付きランキング: where: {Block: {Time: {after: "2025-03-01T00:00:00Z"}}} を追加して特定期間に限定
小口取引の除外: where に Trade: {Buy: {Amount: {gt: 100}}} を追加

メトリクスフィールド（count、sum）をディメンションフィールドと一緒に指定すると、API は選択したディメンションで結果を自動的にグループ化します。詳細は Metrics & Aggregation を参照してください。

マルチチェーンの例

同じクエリは対応チェーンすべてで動作します — network パラメータを変更するだけです。

Solana
Ethereum
BSC

query {
  Solana {
    DEXTrades(
      limit: {count: 5}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time, Slot }
      Trade {
        Buy { Currency { MintAddress }, PriceInUSD }
        Dex { ProtocolName }
      }
    }
  }
}

query {
  EVM(network: eth) {
    DEXTrades(
      limit: {count: 5}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time, Height }
      Trade {
        Buy { Currency { MintAddress }, PriceInUSD }
        Dex { ProtocolName }
      }
    }
  }
}

query {
  EVM(network: bsc) {
    DEXTrades(
      limit: {count: 5}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time, Height }
      Trade {
        Buy { Currency { MintAddress }, PriceInUSD }
        Dex { ProtocolName }
      }
    }
  }
}

次のステップ

送金（Transfers）

オンチェーンのトークン送金データをクエリします。

残高とホルダー

ウォレット残高、残高履歴、トップホルダーを調べます。

プールと流動性

DEX プールと流動性データを探索します。

OHLC と統計

ローソク足、取引統計、時価総額、トークンメタデータを取得します。

はじめに

GraphQL IDE

スキーマとデータモデル

クエリ例

課金とクレジット

最新の DEX 取引を取得するには？

特定トークンの取引を取得するには？

ウォレットの全取引を取得するには？

トークンの現在価格を取得するには？

トークンのトップトレーダーを見つけるには？

マルチチェーンの例

次のステップ

送金（Transfers）

残高とホルダー

プールと流動性

OHLC と統計

​最新の DEX 取引を取得するには？

​特定トークンの取引を取得するには？

​ウォレットの全取引を取得するには？

​トークンの現在価格を取得するには？

​トークンのトップトレーダーを見つけるには？

​マルチチェーンの例

​次のステップ

送金（Transfers）

残高とホルダー

プールと流動性

OHLC と統計

最新の DEX 取引を取得するには？

特定トークンの取引を取得するには？

ウォレットの全取引を取得するには？

トークンの現在価格を取得するには？

トークンのトップトレーダーを見つけるには？

マルチチェーンの例

次のステップ