Premiers pas avec SQL Explorer

Aperçu

SQL Explorer vous offre un accès SQL direct à des milliards de lignes de données de blockchain indexées, sans avoir à gérer d’infrastructure. Interrogez les transactions, les ordres, les positions, les liquidations et bien plus encore à l’aide du langage SQL standard, le tout au sein de la même plateforme que celle que vous utilisez déjà pour RPC et Streams.

SQL Explorer est actuellement en version bêta. Nous travaillons activement à élargir la couverture des jeux de données et à ajouter de nouvelles fonctionnalités en fonction des commentaires des utilisateurs.

Utilisez-vous des agents IA ?

Installez la compétence Quicknode pour permettre à votre agent de maîtriser parfaitement SQL Explorer et l'ensemble de la plateforme Quicknode :

Compétences npx Ajouter quiknode-labs/compétences-blockchain

Pour générer des requêtes SQL, téléchargez le schéma lisible par machine et intégrez-le dans le contexte de votre agent. Consultez la référence du schéma pour plus de détails.

Pourquoi SQL Explorer ?

SQL Explorer permet d'effectuer des requêtes flexibles sur des données de blockchain indexées à l'aide du langage SQL standard. Au lieu de recourir à des points de terminaison API prédéfinis, vous pouvez rédiger des requêtes personnalisées directement sur les ensembles de données sous-jacents.

Caractéristiques principales :

Aucune infrastructure à gérer: interrogez les données de la blockchain via SQL sans avoir à faire tourner de nœuds, de bases de données ou d'indexeurs
Flexibilité totale en matière de requêtes: rédigez des requêtes SQL en utilisant la syntaxe standard, y compris les fonctions, les sous-requêtes, les fonctions de fenêtre et les jointures
Conçu pour la scalabilité: les requêtes s'exécutent sur des milliards de lignes grâce à un stockage en colonnes et à une optimisation tenant compte des partitions
Entièrement intégré: disponible aux côtés de RPC, Streams et d'autres produits Quicknode sur la même plateforme

Fonctionnalités de SQL Explorer

SQL Explorer comprend des outils permettant d'interroger, d'analyser et d'intégrer des données de blockchain :

Éditeur SQL: Éditeur intégré au navigateur avec mise en évidence de la syntaxe et prise en charge du SQL standard, y compris les sous-requêtes, les fonctions de fenêtre, GROUP BY, et REJOIGNEZ-NOUS
Navigateur de schéma: affichez les métadonnées des tables, notamment le nombre de lignes, les noms de colonnes, les types de données, les clés de tri (⚡) et les stratégies de partitionnement. Consultez la référence du schéma pour obtenir la documentation complète.
Requêtes prédéfinies: requêtes prêtes à l'emploi pour les cas d'utilisation courants sur les chaînes prises en charge
Visualisation: création de graphiques avec des axes configurables, des superpositions de plusieurs séries et des infobulles au survol
Accès à l'API REST: Exécuter des requêtes par programmation via une requête POST vers https://api.quicknode.com/sql/rest/v1/query avec authentification par clé API
Générateur de requêtes: génère des appels API REST (cURL) à partir de l'interface utilisateur pour n'importe quelle requête
Bibliothèque de requêtes enregistrées: enregistrez vos requêtes les plus fréquentes pour y accéder rapidement
Indicateurs d'exécution : afficher la durée d'exécution, le nombre de lignes renvoyées, le nombre de lignes analysées et le nombre d'octets traités pour chaque requête

Comment accéder à SQL Explorer

SQL Explorer est accessible via plusieurs méthodes d'accès :

Tableau de bord: requêtes interactives avec visualisation dans votre navigateur
API REST: requêtes HTTP directes pour un accès programmatique
SDK: client typé pour les applications Node.js, Python, Rust et Ruby
CLI: Commandes du terminal pour les scripts et les requêtes rapides

Utilisation du tableau de bord

Le tableau de bord Quicknode offre un environnement interactif permettant de créer, de tester et de visualiser des requêtes SQL :

Ouvrez SQL Explorer dans votre tableau de bord Quicknode
Accédez à l'onglet « Tables » pour découvrir les ensembles de données disponibles, consulter les détails du schéma ou sélectionner une requête prédéfinie dans l'onglet « Requêtes ».
Rédigez une nouvelle requête ou modifiez une requête prédéfinie dans l'éditeur
Cliquez sur « Exécuter » pour lancer votre requête
Consultez les résultats dans l'onglet « Résultats » ou passez à l'onglet « Graphiques » pour les visualiser
Cliquez sur « Enregistrer » pour enregistrer la requête, ou sur « API » pour générer la requête REST correspondante

Utilisation de l'API REST

L'API REST vous permet d'exécuter des requêtes SQL par programmation.

Les requêtes SQL sont exécutées via une requête HTTP POST vers https://api.quicknode.com/sql/rest/v1/query à l'aide de votre clé API Quicknode. Les résultats sont renvoyés au format JSON, accompagnés des statistiques d'exécution de la requête.

Récupérer l'appel API depuis le tableau de bord :

Après avoir exécuté une requête dans le tableau de bord SQL Explorer, cliquez sur « API » en haut de la page pour générer une requête cURL prête à l'emploi contenant votre requête.

Exemple de requête :

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"
  }'

Exemple de réponse :

{
    "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
    }
}

Comprendre la réponse :

La réponse de l'API contient les champs suivants :

méta: Tableau de métadonnées de colonnes avec nom et type pour chaque colonne de l'ensemble de résultats
données: Tableau d'objets contenant les résultats réels de la requête, chaque objet représentant une ligne
lignes: Nombre de lignes renvoyées dans cette réponse
nombre_de_lignes_avant_la_limite_au_minimum: Nombre total de lignes correspondant à la requête avant l'application de LIMIT (utile pour la pagination)
statistiques: Indicateurs de performance pour l'optimisation des requêtes :
- écoulé: Durée totale d'exécution de la requête en secondes
- nombre_lignes_lues: Nombre total de lignes analysées lors de l'exécution (ce nombre peut être supérieur au nombre de lignes renvoyées en raison du filtrage)
- octets_lus: Volume total de données analysées en octets (utile pour comprendre le coût des requêtes et identifier les possibilités d'optimisation)

Utilisez le statistiques champs permettant de comprendre les performances des requêtes et d'optimiser les analyses. Réduire nombre_lignes_lues et octets_lus indiquent généralement que les requêtes sont plus efficaces.

Consultez le guide « Présentation de l'API REST » pour obtenir des instructions détaillées, des informations sur la configuration de l'authentification et des exemples.

Utilisation du SDK

Le SDK Quicknode permet d'accéder à SQL Explorer de manière typée depuis Node.js, Python, Rust et Ruby. Utilisez la sql client permettant d'exécuter des requêtes et de récupérer des schémas.

Exemple (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");

Consultez la documentation du SDK pour connaître la procédure d'installation et de configuration de l'authentification.

Utilisation de l'interface en ligne de commande

L'interface CLI de Quicknode propose des commandes de terminal permettant d'effectuer des requêtes SQL et de récupérer des schémas.

Exécuter une requête :

Requête SQL qn « SELECT * FROM hyperliquid_trades LIMIT 10 » --cluster hyperliquid-core-mainnet

Récupérer le schéma :

schéma SQL de qn --cluster hyperliquid-core-mainnet

Consultez la documentation relative à l'interface en ligne de commande (CLI) pour connaître la procédure d'installation et de configuration de l'authentification.

Limite du nombre de résultats et pagination

Les résultats de la requête sont limités à 1 000 lignes par requête. Pour les ensembles de résultats plus volumineux, utilisez LIMITE et DÉCALAGE clauses permettant de parcourir les résultats par pages. Voir la Guide de pagination pour découvrir des exemples complets et les bonnes pratiques.

Premiers pas avec les requêtes

Découvrez le « SQL Explorer Cookbook », qui propose plus de 40 requêtes prêtes à l'emploi portant notamment sur l'activité des portefeuilles, les récompenses des validateurs, les liquidations et bien plus encore. Chaque exemple comprend des paramètres personnalisables et du code prêt à l'emploi en SQL, cURL, TypeScript et Python.

Facturation

SQL Explorer utilise les crédits API de votre compte Quicknode existant. La consommation de crédits est calculée côté serveur en fonction des ressources utilisées par chaque requête :

Durée d'exécution des requêtes: les requêtes plus longues sont facturées plus cher, selon un barème progressif pour les requêtes dépassant 250 ms et 2 secondes
Données analysées: les requêtes qui analysent davantage d'octets sur le disque sont facturées en conséquence
Frais de base: chaque requête donne lieu à une facturation minimale de crédits destinée à couvrir les coûts fixes d'infrastructure

Chaque réponse de l'API inclut le coût du crédit dans le X-Crédits en-tête de réponse, ainsi que les statistiques d'exécution (écoulé, nombre_lignes_lues, octets_lus) dans le corps de la réponse afin de pouvoir suivre et optimiser les coûts des requêtes.

Conseils pour réduire l'utilisation du crédit :

Filtrer par utilisateur dans la mesure du possible — cela permet d'exploiter des projections pré-triées pour des recherches rapides
Utilisation LIMITE pour limiter la taille du résultat
Courir EXPLIQUER pour prévisualiser le plan d'exécution avant d'exécuter des requêtes gourmandes en ressources

Vous pouvez consulter l'utilisation de vos crédits dans le tableau de bord Quicknode.

Réseaux pris en charge

SQL Explorer prend actuellement en charge les chaînes suivantes ; d'autres seront bientôt disponibles :

Chaîne	Réseau	Tableaux	Nombre total de lignes	Couverture
Hyperliquid	Mainnet	Afficher le schéma	Plus de milliards	Transactions, ordres, exécutions, financement, écarts du carnet d'ordres, marchés perpétuels, marchés au comptant, blocs, opérations, actions système, activité du générateur, staking, registre, états de la chambre de compensation, cours des oracles, sous-comptes, titres en coffre-fort, agents, événements de pont, noms d'affichage, transferts d'actifs, statuts TWAP, parrainages, récompenses des validateurs, récompenses des délégataires, résumés, indicateurs, et plus encore

Schéma disponible

SQL Explorer offre une couverture complète de la plateforme Hyperliquid HyperCore, avec des milliards de lignes de données indexées réparties sur plusieurs tables, notamment les transactions, les ordres, les exécutions, le financement, les données de marché, etc.

Afficher le schéma complet

Consultez la référence complète du schéma pour connaître les définitions des colonnes, les types de données, les clés de tri et les détails relatifs au partitionnement. Le schéma est mis à jour en permanence et optimisé pour les requêtes.

Foire aux questions

Qu'est-ce que Quicknode SQL Explorer ?▼

Comment puis-je accéder à SQL Explorer ?▼

Quelles chaînes sont prises en charge ?▼

Quels sont les tableaux de données disponibles ?▼

Puis-je créer mes propres requêtes ?▼

Comment fonctionne l'accès programmatique ?▼

Comment récupérer plus de 1 000 lignes ?▼

Comment fonctionne la facturation ?▼

SQL Explorer est-il prêt pour une utilisation en production ?▼

Comment optimiser mes requêtes ?▼

Nous ❤️ les commentaires !

Si vous avez des commentaires ou des questions concernant cette documentation, faites-le nous savoir. Nous serions ravis de vous entendre !

Aperçu​

Pourquoi SQL Explorer ?​

Fonctionnalités de SQL Explorer​

Comment accéder à SQL Explorer​

Utilisation du tableau de bord​

Utilisation de l'API REST​

Utilisation du SDK​

Utilisation de l'interface en ligne de commande​

Facturation​

Réseaux pris en charge​

Schéma disponible​

Foire aux questions​

Nous ❤️ les commentaires !​