Skip to main content

GraphQL 端點

所有 GraphQL 查詢發往同一端點:
同時支援 POSTGET
生產環境請使用 POST。GET 將查詢編碼在 URL 中,存在長度限制,複雜查詢不便使用。

認證

X-API-KEY 請求頭中傳入 API Key 即可完成認證。與 REST Data API 使用同一 API Key,無需單獨憑證。
ChainStream DashboardApplicationsCreate New App 獲取 API Key。Key 以 cs_live_... 開頭。

必填請求頭


請求格式

GraphQL 請求體為包含兩個欄位的 JSON 物件:

POST 示例

GET 示例


支援的網路

將 Cube 查詢包裹在對應的 Chain Group 中以選擇網路:

響應格式

所有響應均為 JSON,結構如下:
在產生 credits 消耗時,響應會包含 extensions.credits 欄位。Credits 計算方式見 計費與額度

錯誤響應

當查詢格式錯誤或執行失敗時,響應會包含 errors 陣列:
在接入應用前,可使用 GraphQL IDE 互動式校驗查詢。IDE 提供自動補全與行內錯誤高亮。

下一步

執行首次查詢

跟隨分步教程,在 IDE 或 cURL 中執行真實查詢。

探索 Schema

深入瞭解 25 個 Cube、欄位型別、過濾運算子與聚合函式。