跳转到主要内容

​
Monaco 编辑器

查询编辑器基于 Monaco — 与 VS Code 同源 — 并配有 GraphQL language worker，提供：
  • GraphQL 操作、字段、参数与指令的 语法高亮
  • 基于 schema 的自动补全 — 按 Ctrl+Space 查看当前 live schema 下可用的字段、参数与类型
  • 实时错误检测 — 无效字段名、缺少参数或类型不匹配时显示红色下划线与错误标记
  • 花括号、括号与字符串的 括号匹配 与 自动闭合
  • 便于批量修改的 多光标编辑
自动补全会感知 schema。在某一 Cube（例如 DEXTrades）内输入时，建议列表中只会出现对该 Cube 合法的字段与参数。

​
编辑器面板

编辑器区域在底部分为三个标签页，切换即可配置请求的不同部分。

​
Query 面板

编写 GraphQL 查询的主编辑区。Monaco 的自动补全、高亮与错误检测在此生效。 
query {
  DEXTrades(
    network: sol
    limit: {count: 10}
    orderBy: Block_Time_DESC
  ) {
    Block { Time }
    Transaction { Hash }
    Trade {
      Buy { Currency { MintAddress } Amount PriceInUSD }
      Sell { Currency { MintAddress } Amount }
      Dex { ProtocolName }
    }
  }
}

​
Variables 面板

在 Variables 面板中以 JSON 向带参数的查询传入变量。这样查询可复用 — 只需改变量值而无需改查询正文。 
query LatestTrades($network: Network!, $limit: Int!) {
  DEXTrades(
    network: $network
    limit: {count: $limit}
    orderBy: Block_Time_DESC
  ) {
    Block { Time }
    Trade {
      Buy { Currency { MintAddress } Amount PriceInUSD }
      Sell { Currency { MintAddress } Amount }
    }
  }
}

​
Headers 面板

配置随每次请求发送的 HTTP 请求头。Headers 面板 默认显示，并已预填 X-API-KEY。 
{
  "X-API-KEY": "your_api_key"
}
可按需添加其他自定义请求头。所有请求头会作为 GraphQL 端点 POST 请求的一部分发送。
Content-Type: application/json 会自动附带 — 无需手动设置。

​
工具栏

工具栏位于编辑器顶部，提供快捷操作：
按钮操作说明
Execute（▶）运行查询将当前查询（含 variables 与 headers）发送到 GraphQL 端点
Prettify格式化查询自动整理缩进与换行
Copy复制查询将当前查询文本复制到剪贴板
Merge合并片段将 inline fragments 合并为单一扁平查询
Save Query本地保存以标题与可选标签保存当前查询
Export Code导出片段按所选语言生成当前查询的代码片段

​
执行查询

执行步骤：
  1. 在编辑器中编写或加载查询
  2. 在 Headers 面板设置 X-API-KEY
  3. 点击工具栏中的 Execute（▶），或按 Ctrl/Cmd+Enter
响应显示在编辑器右侧 Results Panel，JSON 带完整语法高亮。若查询有误，会展示错误响应及错误信息与位置。

​
Results 面板

结果面板展示 GraphQL 端点返回的 JSON，并提供：
  • JSON 键、字符串、数字与布尔值的 语法高亮
  • 用于浏览深层嵌套响应的 可折叠节点
  • 通过右键菜单 复制响应
典型成功响应包含与查询结构对应的 data 对象，以及展示计费信息的 extensions.credits 对象。

​
状态栏

IDE 底部状态栏实时反馈查询执行情况：
指示项取值示例说明
StateReady · Executing... · Success · Error当前请求生命周期状态
Latency如 120ms从发出请求到收到响应的往返时间
Size如 2.4 KB响应体大小
Credits如 8 CU本次查询消耗的 Credit Units
Credit Units（CU）反映查询的计算成本。扫描更多数据或返回更大结果集会消耗更多 CU。详见 计费与 Credits。

​
键盘快捷键

快捷键操作
Ctrl/Cmd + Enter执行查询
Ctrl/Cmd + B切换侧边栏
Ctrl + Space触发自动补全
Ctrl/Cmd + Shift + P命令面板
Ctrl/Cmd + /切换行注释
Ctrl/Cmd + D选中下一处相同内容
Ctrl/Cmd + Shift + F格式化 / Prettify
Alt + Up/Down上移/下移当前行
在 macOS 上，将 Ctrl 换为 Cmd。IDE 会检测操作系统并显示对应的修饰键。