Quicknode : Accès aux données blockchain pour les agents

Quicknode propose des endpoints RPC haute performance sur 77+ réseaux blockchain, incluant toutes les chaînes que Bankr supporte : Base, Ethereum, Polygon, Solana et Unichain.

Deux façons d'accéder :

Clé API : Créez un compte Quicknode, obtenez une URL d'endpoint avec l'authentification intégrée. Accès complet à tous les produits et paramètres.
x402 (aucun compte requis) : N'importe quel wallet avec USDC peut s'authentifier et payer par requête. Installez @quicknode/x402 et commencez à interroger immédiatement.

Accès x402 (recommandé pour les agents)

x402 est idéal pour les agents autonomes. Pas d'inscription, pas de clés API. Payez avec USDC sur Base, Polygon ou Solana.

import { createQuicknodeX402Client } from "@quicknode/x402";

const client = await createQuicknodeX402Client({
  baseUrl: 'https://x402.quicknode.com',
  network: "eip155:84532",   // pay on Base Sepolia (testnet)
  evmPrivateKey: process.env.PRIVATE_KEY,
  preAuth: true,             // pre-authenticates via SIWX for faster payment flow
});

// Pay on Base, query any chain
const res = await client.fetch("https://x402.quicknode.com/ethereum-mainnet", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ jsonrpc: "2.0", method: "eth_blockNumber", params: [], id: 1 }),
});

Installation : npm install @quicknode/x402

Tarification du crédit :

Testnet : 100 crédits pour 0,01 USDC
Mainnet : 1 000 000 crédits pour 10 USDC
1 crédit par réponse JSON-RPC réussie

Documentation x402 complète : https://x402.quicknode.com/llms.txt

Accès par clé API

Les endpoints Quicknode incluent l'authentification dans l'URL :

https://{ENDPOINT_NAME}.{NETWORK}.quiknode.pro/{API_KEY}/

import { createPublicClient, http } from "viem";
import { base } from "viem/chains";

const client = createPublicClient({
  chain: base,
  transport: http(process.env.QUICKNODE_RPC_URL),
});

const block = await client.getBlockNumber();

Opérations courantes pour les agents

Vérifier le solde natif (EVM)

const balance = await client.getBalance({ address: "0x..." });

Ou RPC brut :

{ "jsonrpc": "2.0", "method": "eth_getBalance", "params": ["0x...", "latest"], "id": 1 }

Vérifier le solde de token ERC-20 (EVM)

Utilisez eth_call avec le sélecteur balanceOf(address) d'ERC-20 (0x70a08231) :

{
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [{
    "to": "0xTOKEN_CONTRACT",
    "data": "0x70a08231000000000000000000000000WALLET_ADDRESS_NO_0x"
  }, "latest"],
  "id": 1
}

Obtenir une estimation de gas (EVM)

{ "jsonrpc": "2.0", "method": "eth_gasPrice", "params": [], "id": 1 }

Vérifier le statut de la transaction (EVM)

{ "jsonrpc": "2.0", "method": "eth_getTransactionReceipt", "params": ["0xTX_HASH"], "id": 1 }

Solana Balance

{ "jsonrpc": "2.0", "method": "getBalance", "params": ["WALLET_PUBKEY"], "id": 1 }

Comptes de tokens Solana

{
  "jsonrpc": "2.0",
  "method": "getTokenAccountsByOwner",
  "params": [
    "WALLET_PUBKEY",
    { "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" },
    { "encoding": "jsonParsed" }
  ],
  "id": 1
}

Add-ons Quicknode Marketplace

Les endpoints Quicknode peuvent être améliorés avec les add-ons Marketplace. Les pertinents pour les agents de trading :

Token API : qn_getWalletTokenBalance retourne tous les soldes ERC-20 d'un wallet en un seul appel. Pas besoin d'interroger chaque contrat de token individuellement.
NFT API : qn_fetchNFTs retourne les NFTs possédés par une adresse avec les métadonnées.
Solana Priority Fee API : qn_estimatePriorityFees retourne les frais prioritaires recommandés en fonction de l'activité récente du réseau. Utile pour assurer que les transactions arrivent rapidement.
Solana DAS API : Interrogez les NFTs compressés, les tokens fongibles et les actifs numériques via des méthodes comme getAssetsByOwner et searchAssets.
Metis - Solana Trading API : Échanges de tokens alimentés par Jupiter sur Solana. Obtenez des devis et exécutez des swaps via les endpoints quoteGet et swapPost. Documentation : https://www.quicknode.com/docs/solana/metis-overview

Voir tous les add-ons : https://marketplace.quicknode.com/

Ces add-ons sont disponibles sur les endpoints de clé API. Activez-les dans le tableau de bord Quicknode.

Réseaux supportés

Toutes les chaînes supportées par Bankr sont disponibles sur Quicknode :

Chaîne	Slug du réseau x402	Documentation clé API
Base	`base-mainnet`	https://www.quicknode.com/docs/base
Ethereum	`ethereum-mainnet`	https://www.quicknode.com/docs/ethereum
Polygon	`polygon-mainnet`	https://www.quicknode.com/docs/polygon
Solana	`solana-mainnet`	https://www.quicknode.com/docs/solana
Unichain	`unichain-mainnet`	https://www.quicknode.com/docs/unichain

URL de base x402 : https://x402.quicknode.com/{network-slug}

Voir la liste complète des chaînes supportées : https://www.quicknode.com/chains

Gestion des erreurs

429 Too Many Requests : Appliquez un délai et relancez. Utilisez un backoff exponentiel.
402 Payment Required (x402) : Crédits épuisés. @quicknode/x402 gère cela automatiquement en déclenchant un nouveau paiement en USDC.
Erreurs JSON-RPC (par ex. -32000) : Erreurs spécifiques à la méthode. Vérifiez les paramètres et relancez.

Ressources

Documentation AI & Agents : https://www.quicknode.com/docs/build-with-ai
Documentation RPC complète (toutes les chaînes) : https://www.quicknode.com/docs/llms.txt
Détails techniques x402 : https://x402.quicknode.com/llms.txt
Exemples de code (x402) : https://github.com/quiknode-labs/qn-x402-examples
Add-ons Marketplace : https://marketplace.quicknode.com
Skill Quicknode complète avec références étendues : https://github.com/quiknode-labs/blockchain-skills/tree/main/skills/quicknode-skill