SQL Explorer 入门指南

概述

SQL Explorer 让您无需管理基础设施，即可直接通过 SQL 访问数十亿行已建立索引的区块链数据。使用标准 SQL 查询交易、订单、持仓、强制平仓等信息，所有操作均可在您已用于 RPC 和流处理的同一平台上完成。

SQL Explorer 目前处于测试版。我们正在根据用户反馈积极扩展数据集覆盖范围并添加新功能。

在使用人工智能代理吗？

安装Quicknode 技能，让您的客服代表全面掌握 SQL Explorer 以及更广泛的 Quicknode 平台：

npx 技能 添加 quiknode-labs/blockchain-skills

要生成 SQL 查询，请下载机器可读的模式，并将其包含在代理的上下文中。详细信息请参阅《模式参考》。

为什么选择 SQL Explorer

SQL Explorer 支持使用标准 SQL 对已建立索引的区块链数据进行灵活查询。您无需依赖预定义的 API 端点，而是可以直接针对底层数据集编写自定义查询。

主要特点：

无需管理基础设施：无需运行节点、数据库或索引器，即可通过 SQL 查询区块链数据
完全的查询灵活性：使用标准语法编写 SQL 查询，包括函数、子查询、窗口函数和连接
专为大规模处理而设计：利用支持分区感知优化的列式存储，查询可针对数十亿行数据执行
完全集成：可在同一平台上与 RPC、Streams 以及其他 Quicknode 产品一同使用

SQL Explorer 的功能

SQL Explorer 包含用于查询、分析和整合区块链数据的工具：

SQL 编辑器: 支持语法高亮且兼容标准 SQL（包括子查询、窗口函数等）的浏览器内编辑器， GROUP BY，以及 加入
模式浏览器：查看表元数据，包括行数、列名、数据类型、排序键（⚡）和分区策略。完整文档请参阅《模式参考》。
预构建查询：适用于受支持链上常见用例的即用型查询
可视化：生成具有可配置坐标轴、多系列叠加以及悬停提示的图表
REST API 访问: 通过 POST 请求以编程方式执行查询，发送至 https://api.quicknode.com/sql/rest/v1/query 使用 API 密钥认证
查询生成器：通过用户界面为任何查询生成 REST API 调用（cURL）
已保存查询库：保存您常用的查询，以便快速访问
执行指标：查看每个查询的查询时间、返回行数、扫描行数和处理字节数

如何访问 SQL Explorer

可以通过多种方式访问 SQL Explorer：

仪表盘：在浏览器中进行带可视化的交互式查询
REST API：用于程序化访问的直接 HTTP 请求
SDK：适用于 Node.js、Python、Rust 和 Ruby 应用程序的类型化客户端
CLI：用于脚本和快速查询的终端命令

使用仪表盘

Quicknode 仪表盘提供了一个用于构建、测试和可视化 SQL 查询的交互式环境：

在 Quicknode 控制台中打开SQL Explorer
在“表”选项卡中浏览以探索可用数据集、查看模式详细信息，或在“查询”选项卡中选择一个预构建的查询
在编辑器中编写新查询或修改现成的查询
单击“运行”以执行您的查询
在“结果”选项卡中查看结果，或切换到“图表”进行可视化展示
点击“保存”以保存查询，或点击“API”以生成相应的 REST 请求

使用 REST API

REST API 允许您通过编程方式执行 SQL 查询。

SQL 查询是通过 HTTP POST 请求发送到 https://api.quicknode.com/sql/rest/v1/query 使用您的 Quicknode API 密钥。结果将以 JSON 格式返回，其中包含查询执行统计信息。

从仪表盘获取 API 调用：

在SQL Explorer 仪表盘中运行查询后，点击顶部的“API”，即可生成一个包含您查询内容的、可直接使用的 cURL 请求。

请求示例：

curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "query": "SELECT time, validator, reward, block_number FROM hyperliquid_validator_rewards ORDER BY block_number DESC LIMIT 100",
    "clusterId": "hyperliquid-core-mainnet"
  }'

示例回复：

{
    "meta": [
        {
            "name": "time",
            "type": "DateTime64(6, 'UTC')"
        }
    ],
    "data": [
        {
            "time": "2026-03-30 16:24:00.058516",
            "validator": "0xf8efb4cb844a8458114994203d7b0bfe2422a288",
            "reward": 0.18548686,
            "block_number": 940269912
        },
        {
            "time": "2026-03-30 16:24:00.058516",
            "validator": "0xeeee86f718f9da3e7250624a460f6ea710e9c006",
            "reward": 0.50774076,
            "block_number": 940269912
        }
    ],
    "rows": 100,
    "rows_before_limit_at_least": 120,
    "statistics": {
        "elapsed": 0.073805665,
        "rows_read": 71918,
        "bytes_read": 5322148
    }
}

理解该回应：

API 响应包含以下字段：

元数据: 包含以下内容的列元数据数组： 名称 以及 类型 对于结果集中的每一列
数据: 包含实际查询结果的对象数组，其中每个对象代表一行
行: 此响应中返回的行数
至少在限制值之前的行数: 应用 LIMIT 之前与查询条件匹配的行数总和（用于分页）
统计数据: 查询优化的性能指标：
- 已过去: 查询总执行时间（单位：秒）
- rows_read: 执行过程中扫描的行总数（由于过滤操作，该数值可能多于返回的行数）
- bytes_read: 扫描的数据总量（以字节为单位）（有助于理解查询成本和优化机会）

使用 统计数据 字段，以了解查询性能并优化扫描操作。降低 rows_read 以及 bytes_read 通常表明查询效率更高。

有关详细说明、身份验证设置和示例，请参阅《REST API 概述》指南。

使用 SDK

该 Quicknode SDK 提供从 Node.js、Python、Rust 和 Ruby 访问 SQL Explorer 的类型化接口。使用 sql 客户端用于执行查询并检索模式。

示例（Node.js）：

import { QuicknodeSdk } from "@quicknode/sdk";

const qn = new QuicknodeSdk();

// Run a SQL query
const resp = await qn.sql.query(
  "SELECT action_type, user FROM hyperliquid_system_actions LIMIT 3",
  "hyperliquid-core-mainnet"
);
console.log(`${resp.rows} rows, ${resp.credits} credits`);

// Get the schema for a cluster
const schema = await qn.sql.getSchema("hyperliquid-core-mainnet");

有关安装和身份验证设置，请参阅SDK 文档。

使用命令行界面 (CLI)

Quicknode CLI提供了用于执行 SQL 查询和检索模式的终端命令。

运行一条查询：

qn SQL 查询 "SELECT * FROM hyperliquid_trades LIMIT 10" --cluster hyperliquid-core-mainnet

获取模式：

qn SQL 模式 --集群 hyperliquid-core-mainnet

有关安装和身份验证设置，请参阅CLI 文档。

结果限制与分页

查询结果仅限于 每次请求1000行. 对于较大的结果集，请使用 LIMIT 以及 OFFSET 用于对结果进行分页的子句。请参阅分页指南以获取完整的示例和最佳实践。

查询入门

查阅《SQL Explorer 实战指南》，其中收录了 40 多个预构建查询，涵盖钱包活动、验证者奖励、清算等内容。每个示例都包含可自定义的参数，以及可直接使用的 SQL、cURL、TypeScript 和 Python 代码。

账单

SQL Explorer 使用您现有 Quicknode 账户中的 API 配额。配额消耗量由服务器端根据每条查询所消耗的资源进行计算：

查询执行时间：执行时间较长的查询费用更高，对于超过 250 毫秒和 2 秒的查询，将按递增费率计费
已扫描的数据：从磁盘扫描更多字节的查询将按实际使用量计费
基础费用：每次查询都会收取最低信用点费用，用于覆盖固定的基础设施成本

每个 API 响应中都包含信用成本，该成本位于 X-Credits 响应头，以及执行统计信息（已过去, rows_read, bytes_read) 在响应正文中，以便您可以监控和优化查询成本。

降低信用使用率的建议：

按…筛选 用户 在可能的情况下——这利用了预先排序的投影来实现快速查找
使用 LIMIT 限制结果大小
运行 EXPLAIN 在执行耗时较长的查询之前预览查询计划

您可以在Quicknode 仪表盘中查看您的信用额度使用情况。

支持的网络

SQL Explorer 目前支持以下链，更多链即将推出：

链	网络	表格	总行数	报道范围
超流体	主网	查看模式	数十亿+	交易、订单、成交、资金、订单簿差异、永续合约市场、现货市场、大额交易、交易、系统操作、构建器活动、质押、账本、清算所状态、预言机价格、子账户、金库权益、代理、桥接事件、显示名称、资产转账、TWAP状态、推荐、验证者奖励、委托人奖励、摘要、指标等

可用模式

SQL Explorer 全面覆盖了 Hyperliquid HyperCore，包含跨多个表的数十亿行带索引的数据，涵盖交易、订单、成交、资金、市场数据等。

查看完整架构

请查阅完整的模式参考文档，了解列定义、数据类型、排序键和分区详情。该模式会持续更新，并针对查询进行优化。

常见问题解答

什么是 Quicknode SQL Explorer？▼

如何访问 SQL Explorer？▼

支持哪些区块链？▼

有哪些数据表可用？▼

我可以创建自己的查询吗？▼

程序化访问是如何运作的？▼

如何检索超过1000行数据？▼

计费机制是怎样的？▼

SQL Explorer 是否已准备好投入生产环境？▼

如何优化查询？▼

我们 ❤️ 您的反馈！

如果您对本文档有任何反馈或疑问，请告诉我们。我们非常期待您的反馈！

概述​

为什么选择 SQL Explorer​

SQL Explorer 的功能​

如何访问 SQL Explorer​

使用仪表盘​

使用 REST API​

使用 SDK​

使用命令行界面 (CLI)​

账单​

支持的网络​

可用模式​

常见问题解答​

我们 ❤️ 您的反馈！​

概述