跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt

Use this file to discover all available pages before exploring further.

預計耗時：約 5 分鐘

​
準備工作

開始前請確認：
  • 已註冊 ChainStream 賬號（點此註冊）
  • 擁有 API Key（以 cs_live_... 開頭）
GraphQL API 與 REST Data API 共用同一 API Key。若你已有 REST API 的 Key，可直接在此複用。

​
第一步：獲取 API Key

  1. 登入 ChainStream Dashboard
  2. 進入 Applications
  3. 點選 Create New App（或選擇已有應用）
  4. 複製你的 API Key

​
第二步：開啟 GraphQL IDE

訪問 ChainStream GraphQL IDE：

GraphQL IDE

https://ide.chainstream.io
IDE 提供自動補全、語法高亮、內聯文件與查詢歷史 — 是探索 schema 與編寫查詢最快的方式。

​
第三步：配置鑑權

在 IDE 中開啟 Headers 面板（左下角），新增 API Key： 
{
  "X-API-KEY": "your_api_key"
}

​
第四步：執行示例查詢

將以下查詢貼上到編輯器。它會拉取 Solana 上最近 10 筆 DEX 成交，含區塊時間、交易雜湊、買賣代幣資訊、數量、USD 價格與 DEX 協議名。 
query {
  Solana {
    DEXTrades(
      limit: {count: 10}
      orderBy: {descending: Block_Time}
    ) {
      Block {
        Time
        Slot
      }
      Transaction {
        Hash
      }
      Trade {
        Buy {
          Currency { MintAddress }
          Amount
          PriceInUSD
        }
        Sell {
          Currency { MintAddress }
          Amount
        }
        Dex { ProtocolName }
      }
    }
  }
}
在 GraphQL IDE 中開啟 — 貼上上方查詢即可互動執行，並享受自動補全與 schema 瀏覽。
點選 Play 按鈕（或按 Ctrl+Enter / Cmd+Enter）執行。

​
cURL 等價寫法

你也可以在終端執行相同查詢： 
curl -X POST "https://graphql.chainstream.io/graphql" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -d '{
    "query": "{ Solana { DEXTrades(limit: {count: 10}, orderBy: {descending: Block_Time}) { Block { Time Slot } Transaction { Hash } Trade { Buy { Currency { MintAddress } Amount PriceInUSD } Sell { Currency { MintAddress } Amount } Dex { ProtocolName } } } } }"
  }'

​
響應示例

成功響應大致如下： 
{
  "data": {
    "Solana": {
      "DEXTrades": [
        {
          "Block": {
            "Time": "2025-03-27T10:32:18Z",
            "Slot": 325847291
          },
          "Transaction": {
            "Hash": "4vKzR8g...x9bQ"
          },
          "Trade": {
            "Buy": {
              "Currency": { "MintAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" },
              "Amount": 1523.45,
              "PriceInUSD": 1.0001
            },
            "Sell": {
              "Currency": { "MintAddress": "So11111111111111111111111111111111111111112" },
              "Amount": 10.237
            },
            "Dex": { "ProtocolName": "Raydium" }
          }
        },
        {
          "Block": {
            "Time": "2025-03-27T10:32:17Z",
            "Slot": 325847289
          },
          "Transaction": {
            "Hash": "3mPqW7n...kR2J"
          },
          "Trade": {
            "Buy": {
              "Currency": { "MintAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" },
              "Amount": 48291037.12,
              "PriceInUSD": 0.00003152
            },
            "Sell": {
              "Currency": { "MintAddress": "So11111111111111111111111111111111111111112" },
              "Amount": 10.5
            },
            "Dex": { "ProtocolName": "Orca" }
          }
        }
      ]
    }
  },
  "extensions": {
    "credits": {
      "total": 50,
      "cubes": [
        { "cube": "DEXTrades", "credits": 50, "row_count": 10 }
      ]
    }
  }
}

​
理解響應

響應結構與查詢一一對應：
路徑說明
Block.Time區塊時間戳（ISO 8601）
Block.SlotSolana slot 編號（Solana 特有）
Transaction.Hash鏈上交易雜湊
Trade.Buy.Currency.MintAddress買入資產的代幣地址
Trade.Buy.Amount買入代幣數量
Trade.Buy.PriceInUSD成交時買入代幣的 USD 價格
Trade.Sell.Currency.MintAddress賣出資產的代幣地址
Trade.Sell.Amount賣出代幣數量
Trade.Dex.ProtocolName執行成交的 DEX 協議（如 Raydium、Orca、PancakeSwap）
extensions.credits 物件展示本次查詢消耗的計費額度與餘額。詳見 計費與額度。

​
嘗試修改查詢

查詢跑通後，可以試試這些改法：
將根從 Solana 改為 EVM(network: eth) 並相應調整查詢體，以查詢 Ethereum DEX 成交（Uniswap、SushiSwap 等）。
透過 where 篩選最近一小時的成交：
Solana {
  DEXTrades(
    limit: {count: 10}
    orderBy: {descending: Block_Time}
    where: {Block: {Time: {after: "2025-03-27T09:00:00Z"}}}
  ) { ... }
}
按代幣 mint 地址篩選，檢視該代幣的成交：
Solana {
  DEXTrades(
    limit: {count: 10}
    orderBy: {descending: Block_Time}
    where: {Trade: {Buy: {Currency: {MintAddress: {is: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"}}}}}
  ) { ... }
}
按 DEX 協議統計成交筆數：
Solana {
  DEXTrades(
    where: {Block: {Time: {after: "2025-03-27T00:00:00Z"}}}
  ) {
    count
    Trade { Dex { ProtocolName } }
  }
}

​
下一步

Schema 與資料模型

瀏覽全部 25 個 Cube、欄位型別、篩選運算子與聚合函式。

查詢示例

檢視 DEX 成交、轉賬、OHLC、持有人等實際查詢示例。

GraphQL IDE 指南

掌握 IDE — 查詢模板、儲存查詢、變數面板與程式碼匯出。

計費與額度

瞭解查詢額度如何計算以及如何最佳化成本。