查询编辑器

由 Monaco 驱动的 GraphQL 编辑器，支持自动补全、语法高亮、面板与实时查询执行

​

Monaco 编辑器

查询编辑器基于 Monaco — 与 VS Code 同源 — 并配有 GraphQL 语言 worker，提供：

• 语法高亮：GraphQL 操作、字段、参数与指令
• 基于 schema 的自动补全 — 按 Ctrl+Space 查看基于实时 schema 的可用字段、参数与类型
• 实时错误检测 — 无效字段名、缺少参数或类型不匹配时显示红色下划线与错误标记
• 括号匹配 与 自动闭合：大括号、圆括号与字符串
• 多光标编辑：批量修改

自动补全会感知 schema。在某一 Cube（如 DEXTrades）内输入时，建议列表中只会出现该 Cube 合法的字段与参数。

---

​

编辑器面板

编辑区域底部有三个标签页，可在其间切换以配置请求的不同部分。

​

Query 面板

编写 GraphQL 查询的主编辑区。Monaco 的自动补全、高亮与错误检测在此生效。

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

​

Variables 面板

通过 Variables 面板向参数化查询传入 JSON 变量。这样查询可复用 — 修改变量值而无需改动查询正文。

Query

query LatestTrades($limit: Int!) {
  Solana {
    DEXTrades(
      limit: {count: $limit}
      orderBy: {descending: Block_Time}
    ) {
      Block { Time }
      Trade {
        Buy { Currency { MintAddress } Amount PriceInUSD }
        Sell { Currency { MintAddress } Amount }
      }
    }
  }
}

Variables

{
  "limit": 20
}

​

Headers 面板

配置随每次请求发送的 HTTP 请求头。Headers 面板 默认显示，并已预置 X-API-KEY 请求头。

{
  "X-API-KEY": "your_api_key"
}

可按需添加其他自定义请求头。所有请求头会随 POST 请求一并发送到 GraphQL 端点。

Content-Type: application/json 会自动添加 — 无需手动设置。

---

​

工具栏

工具栏位于编辑器顶部，提供快捷操作：

按钮	操作	说明
Execute (▶)	运行查询	将当前查询（含变量与请求头）发送到 GraphQL 端点
Prettify	格式化查询	自动整理缩进与换行
Copy	复制查询	将当前查询文本复制到剪贴板
Merge	合并片段	将内联片段合并为单一扁平查询
Save Query	本地保存	以标题与可选标签保存当前查询
Export Code	导出片段	为当前查询生成所选语言的代码片段

---

​

执行查询

执行查询的步骤：

1. 在编辑器中编写或加载查询
2. 在 Headers 面板设置 X-API-KEY
3. 点击工具栏 Execute (▶)，或按 Ctrl/Cmd+Enter

响应显示在编辑器右侧 Results Panel，JSON 带完整语法高亮。若查询有误，会展示错误响应及错误信息与位置详情。

---

​

结果面板

结果面板展示 GraphQL 端点返回的 JSON，并提供：

• JSON 键、字符串、数字与布尔值的 语法高亮
• 可折叠节点，便于浏览深层嵌套响应
• 右键菜单支持 复制响应

典型成功响应包含与查询结构对应的 data 对象，以及展示计费信息的 extensions.credits 对象。

---

​

状态栏

IDE 底部状态栏实时反馈查询执行状态：

指示项	取值	说明
State	Ready · Executing... · Success · Error	当前请求生命周期状态
Latency	如 120ms	从发出请求到收到响应的往返耗时
Size	如 2.4 KB	响应体大小
Credits	如 8 CU	本查询消耗的 Credit Units（CU）

Credit Units（CU）反映查询的计算成本。扫描数据更多或返回结果更大的查询会消耗更多 CU。详见 计费与额度。

---

​

键盘快捷键

快捷键	操作
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 会自动检测操作系统并显示对应的修饰键。