Emre Demir

Posted on Apr 23 • Originally published at apidog.com

Alchemy API nutzen: Umfassender Web3 Entwicklerleitfaden

Der Betrieb einer produktiven Ethereum dApp ohne zuverlässigen Node-Anbieter führt schnell zu Bereitschaftsdiensten und Problemen wie verzögerten oder verpassten Reorgs. Mit selbst gehosteten Geth-Nodes stoßen Sie bei wachsender Nutzung Ihrer App schnell an Skalierungsgrenzen. Die Alchemy API löst diese Probleme durch eine gehärtete Node-Schicht und erweitert die JSON-RPC-Spezifikation um leistungsstarke Endpunkte wie das Abrufen aller NFTs einer Wallet mit nur einem Aufruf.

Probiere Apidog noch heute aus

In diesem Leitfaden erhalten Sie eine Schritt-für-Schritt-Anleitung zur Alchemy API: App erstellen, authentifizieren, Standard-JSON-RPC-Methoden aufrufen, erweiterte Endpunkte nutzen, WebSocket-Abonnements einrichten und Smart Accounts mit Gas-Sponsoring bereitstellen. Für jeden wichtigen Workflow finden Sie praktische curl- und Node.js-Beispiele. Außerdem erfahren Sie, wie sich Compute Units (CU) auf Ihre monatlichen Kosten auswirken.

Für umfassende Tests Ihrer Wallet- und Web3-Infrastruktur empfiehlt sich Apidog als zentrale Plattform für alle Endpunkt-Tests. Einen Marktüberblick bietet unser Leitfaden zur besten Krypto-Wallet-API.

TL;DR

Alchemy unterstützt Ethereum, Polygon, Arbitrum, Optimism, Base, Solana, zkSync, Starknet und mehr über ein zentrales Dashboard.
Jede App erhält HTTPS- und WebSocket-Endpunkte für Standard-JSON-RPC und erweiterte APIs wie alchemy_getAssetTransfers, alchemy_getTokenBalances und getNFTs.
Das Alchemy SDK für JavaScript (alchemy-sdk) basiert auf ethers.js und erweitert es um typisierte Helfer für erweiterte Endpunkte.
Das Account Kit ermöglicht ERC-4337 Smart Accounts mit Gas-Sponsoring, Session Keys und Passkey-Authentifizierung.
Die Nutzung wird in Compute Units (CU) gemessen: Free-Tarif = 300 Mio. CU/Monat, Growth = 400 Mio. CU plus Überschreitung, Scale = individuell.
Ratelimits gelten pro App und Methode. Nutzen Sie Batch-Anfragen und das SDK-Backoff, um Limits einzuhalten.

Was ist die Alchemy API?

Alchemy ist eine Web3-Entwicklerplattform mit verwalteten Blockchain-Nodes und Indizierungs-Engine. Sie erhalten:

Hochverfügbare JSON-RPC-Nodes für 40+ Chains,
Vorindizierte APIs für Transfers und NFT-Metadaten,
Account-Abstraction-Stack (Account Kit) für gaslose UX.

Im Gegensatz zu Infura bietet Alchemy eine Indizierungsebene. Beispielsweise genügt ein alchemy_getAssetTransfers-Aufruf, um alle ERC-20-Übertragungen einer Adresse zu erhalten. Produktive Wallets, DeFi-Dashboards und NFT-Marktplätze setzen für leseintensive Pfade auf Alchemy.

Authentifizierung und Einrichtung

Erstellen Sie ein Konto im Alchemy-Dashboard.
Klicken Sie auf Neue App erstellen.
Wählen Sie Chain (z.B. Ethereum Mainnet, Polygon) und Netzwerk (Mainnet/Sepolia).
Jede App erhält einen eindeutigen API-Schlüssel (letztes URL-Segment).

HTTPS-Endpunkt:

https://eth-mainnet.g.alchemy.com/v2/YOUR_API_KEY

WebSocket-Endpunkt:

wss://eth-mainnet.g.alchemy.com/v2/YOUR_API_KEY

Behandeln Sie den API-Schlüssel wie ein Geheimnis (Umgebungsvariable, nicht im Client-Code). Für Browser-dApps: Whitelists im Dashboard aktivieren, um Missbrauch zu verhindern.

SDK Installation:

npm install alchemy-sdk

Client initialisieren:

import { Alchemy, Network } from "alchemy-sdk";

const alchemy = new Alchemy({
  apiKey: process.env.ALCHEMY_API_KEY,
  network: Network.ETH_MAINNET,
});

const block = await alchemy.core.getBlockNumber();
console.log("Latest block:", block);

Kern-Endpunkte

Standard-JSON-RPC via HTTPS

Alle Standard-Ethereum JSON-RPC-Methoden funktionieren wie gewohnt. Beispiel für eth_getBalance mit curl:

curl https://eth-mainnet.g.alchemy.com/v2/YOUR_API_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "method":"eth_getBalance",
    "params":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","latest"],
    "id":1
  }'

Die Antwort enthält das Guthaben in Wei (hex). Dasselbe gilt für eth_call, eth_sendRawTransaction, eth_getLogs usw.

Erweiterte API: getAssetTransfers

Mit alchemy_getAssetTransfers erhalten Sie sämtliche ETH-, ERC-20-, ERC-721-, ERC-1155-, interne und externe Transfers einer Adresse im Blockbereich – ein Aufruf statt tausender eth_getLogs.

import { Alchemy, Network, AssetTransfersCategory } from "alchemy-sdk";

const alchemy = new Alchemy({
  apiKey: process.env.ALCHEMY_API_KEY,
  network: Network.ETH_MAINNET,
});

const transfers = await alchemy.core.getAssetTransfers({
  fromBlock: "0x0",
  toAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  category: [
    AssetTransfersCategory.EXTERNAL,
    AssetTransfersCategory.ERC20,
    AssetTransfersCategory.ERC721,
  ],
  maxCount: 100,
});

for (const t of transfers.transfers) {
  console.log(`${t.asset} ${t.value} from ${t.from} to ${t.to}`);
}

Erweiterte API: getTokenBalances und getNFTs

Alle Token einer Wallet abfragen:

const balances = await alchemy.core.getTokenBalances(
  "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
);

for (const token of balances.tokenBalances) {
  const meta = await alchemy.core.getTokenMetadata(token.contractAddress);
  console.log(`${meta.symbol}: ${token.tokenBalance}`);
}

Alle NFTs einer Wallet abrufen:

const nfts = await alchemy.nft.getNftsForOwner(
  "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
);
console.log(`Owns ${nfts.totalCount} NFTs`);

Abonnement-API via WebSocket

Setzen Sie auf Push statt Polling: Abonnieren Sie z.B. ausstehende Transaktionen einer Adresse.

import { Alchemy, Network, AlchemySubscription } from "alchemy-sdk";

const alchemy = new Alchemy({
  apiKey: process.env.ALCHEMY_API_KEY,
  network: Network.ETH_MAINNET,
});

alchemy.ws.on(
  {
    method: AlchemySubscription.PENDING_TRANSACTIONS,
    toAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  },
  (tx) => console.log("Pending USDC tx:", tx.hash)
);

Ideal für Mempool-Bots, MEV-Watcher und Echtzeit-UIs – ohne CU für ständiges Polling zu verbrauchen.

Account Kit und Gas Manager

Das Account Kit bietet ein React-SDK, Smart Contract Accounts (Light/Modular Account) und den Gas Manager für gesponserte Transaktionen. Nutzer onboarden sich via Passkey oder E-Mail und erhalten eine Smart Wallet – ganz ohne Seed-Phrase oder Gas-Token.

import { createLightAccountClient } from "@account-kit/smart-contracts";
import { alchemy, sepolia } from "@account-kit/infra";

const client = createLightAccountClient({
  transport: alchemy({ apiKey: process.env.ALCHEMY_API_KEY }),
  chain: sepolia,
  signer: yourSigner,
});

const { hash } = await client.sendUserOperation({
  uo: { target: "0x...", data: "0x", value: 0n },
});

Für ein vollständiges Onboarding per Smart Account und Embedded Wallet siehe unseren Leitfaden zur Privy API.

Häufige Fehler und Ratelimits

Die Nutzung wird in Compute Units (CU) gemessen. Beispiele:

eth_call: 26 CU
eth_getLogs: 75 CU
alchemy_getAssetTransfers: 150 CU
eth_getBlockByNumber: 16 CU

Der Free-Tarif umfasst 300 Mio. CU/Monat. Typische Fehler:

429 Too Many Requests: CU-Limit pro Sekunde erreicht. SDK wartet und wiederholt automatisch.
403 Forbidden: Whitelist stimmt nicht mit Referer überein oder Schlüssel deaktiviert.
-32600 Invalid Request: Ungültiger JSON-RPC-Body; prüfen Sie Methode und Parameter.
-32000 execution reverted: Vertragsaufruf reverted. Grund mit eth_call und Simulationstool dekodieren.

Batch-Anfragen: Bis zu 1000 JSON-RPC-Aufrufe in einem POST sparen Netzwerk-Overhead und senken oft die Gesamt-CU. Für Test-Workflows siehe API-Tests ohne Postman im Jahr 2026.

Alchemy-Preise

Kostenlos: 300 Mio. CU/Monat, 1 App, Community-Support. Für Prototypen und kleine Projekte.
Growth: 49 $/Monat, 400 Mio. CU inkl., Überziehung pro CU, erweiterte Analysen.
Scale: 289 $/Monat, 1,5 Mrd. CU, dedizierter Durchsatz, Prioritäts-Support.
Enterprise: Individuell, SLAs, private Nodes, dediziertes Engineering.

CU werden monatlich zurückgesetzt. Bei Free schlägt Überschreitung mit 429 fehl, Growth/Scale rechnen Überziehung ab. Überwachen Sie Ihre Nutzung im Dashboard.

Testen der Alchemy API mit Apidog

Das Debuggen von JSON-RPC ist komplex: Jede Anfrage ein POST mit verschachtelten Parametern, hex-kodierte Antworten, WebSocket-Abos schwer testbar. Apidog bietet einen zentralen Workspace für REST, GraphQL und WebSockets. Sie können Alchemy-HTTPS-Endpunkte testen, einen WebSocket zu wss://eth-mainnet.g.alchemy.com/v2/... öffnen und Abos nebenbei beobachten.

Speichern Sie Ihren API-Schlüssel als Umgebungsvariable in Apidog, nutzen Sie ihn in Sammlungen für verschiedene Chains und skripten Sie Assertionen für Antwortfelder. Laden Sie Apidog herunter und importieren Sie die Alchemy OpenAPI-Spezifikation, um Ihre Sammlung in unter einer Minute zu erstellen.

Häufig gestellte Fragen

Ist Alchemy kostenlos für den Produktionseinsatz?

Ja, solange Sie unter 300 Mio. CU/Monat bleiben. Viele kleine dApps laufen dauerhaft im Free-Tarif. Bei Überschreitung oder mehr Durchsatz nehmen Sie Growth (49 $).

Unterstützt Alchemy Solana?

Ja. Alchemy unterstützt Solana Mainnet und Devnet mit Standard-RPC und erweiterten Endpunkten für Token- und NFT-Daten. Erstellen Sie eine Solana-App im Dashboard.

Kann ich die Alchemy API ohne SDK verwenden?

Absolut, via HTTPS/curl/fetch/HTTP-Client. Das SDK ist optional und bietet Komfort-Features wie Wiederholungen und typisierte Helfer.

Unterschied zwischen Alchemy und MetaMasks Entwickler-APIs?

MetaMask fokussiert Wallet-UX und Signatur, Alchemy liefert Node-Infrastruktur und Daten. Siehe unseren Leitfaden zur MetaMask API.

Wie rotiere ich einen Alchemy API-Schlüssel?

Neue App im Dashboard erstellen, Umgebung aktualisieren, deployen, alte App löschen. Direkte Rotation gibt es nicht – planen Sie Überlappung ein.

Funktioniert das Account Kit auf jeder EVM-Chain?

Account Kit unterstützt Ethereum, Optimism, Arbitrum, Base, Polygon und deren Testnets. Die Gas-Manager-Richtlinien sind chain-spezifisch und müssen je Netzwerk konfiguriert werden.

DEV Community