JSON-RPC
Unterstützte JSON-RPC-Methoden, CU-Gewichte und Fehlercodes. Endpunkt einrichten, Chain auswählen und Methodenverfügbarkeit, Preise und Abrechnungsregeln prüfen.
Übersicht
Alle Anfragen werden in Compute Units (CU) erfasst und unterliegen Ratenlimits pro API-Schlüssel.
- Endpunkt:
POST /v1/{chain}/{api_key}(Schlüssel im Pfad) oderPOST /v1/{chain}(Schlüssel im Header). Für Robinhood Chain lautet{chain}robinhood_mainnet:https://api.blockvectra.com/v1/robinhood_mainnet. Derselbe API-Schlüssel funktioniert auf jeder unterstützten Chain - Protokoll: HTTP
POST, Einzelaufruf oder Batch - Messung: Die gesamten CU-Kosten einer Anfrage werden unmittelbar nach deren Eintreffen auf die Burst-Kapazität Ihres Schlüssels angerechnet. Jeder angenommene Aufruf, der eine Antwort erhält, wird mit dem veröffentlichten CU-Gewicht der Methode abgerechnet; die Fehlerreferenz führt die Fälle auf, die nicht in Rechnung gestellt werden. Die Abrechnung erfolgt stündlich (abgerundet auf ganze Einheiten, der Restbetrag wird übertragen, Verrechnung ca. 15 Minuten nach Ende des Zeitraums)
- Ethereum: Eigene Methodenliste und ein durch
state_window_blocksbestimmtes Statusfenster — siehe Unterstützte Chains → Ethereum.
Vollständige Parameterschemata, Methodensignaturen und interaktive Anfragetests für alle Methoden finden Sie in der Vollständigen Referenz. Informationen zur Pfadversionierung, Abwärtskompatibilitätsregeln und SDK-Empfehlungen finden Sie unter API-Versionierung und Kompatibilität.
Um einen API-Schlüssel zu erhalten und eine erste Anfrage zu senden, lesen Sie den Schnellstart; dieser behandelt auch die Schlüsselübergabe und Batch-Anfragen.
Häufige Aufrufe
Ausführliche Beispiele für häufige Aufrufe.
Logs abfragen (eth_getLogs)
Filtern Sie die Logs eines Vertrages über einen aktuellen Blockbereich — hier das ERC-20-Ereignis Transfer (Topic 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef). Siehe die Tabelle CU-Abrechnungsregeln unten für das aktuelle CU-Gewicht von eth_getLogs; ein Bereich, der größer als max_logs_block_range der Chain ist (aus GET /v1/chains), wird mit -32602 abgelehnt.
export BLOCKVECTRA_API_KEY=rgw_your_api_key
curl -X POST "https://api.blockvectra.com/v1/robinhood_mainnet" \
-H 'Content-Type: application/json' \
-H "x-api-key: $BLOCKVECTRA_API_KEY" \
-d '{
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [{
"fromBlock": "0x45a2409",
"toBlock": "0x45a2609",
"address": "0x1111111111111111111111111111111111111111",
"topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]
}],
"id": 1
}'Eine Transaktion nachverfolgen (debug_traceTransaction)
Verfolgen Sie die internen Aufrufe einer Transaktion mit dem callTracer. Siehe die Tabelle CU-Abrechnungsregeln unten für das aktuelle CU-Gewicht von debug_traceTransaction. Wie die anderen Status-Lese-Methoden wird sie abgelehnt, sobald der Zielblock außerhalb des aktuellen Statusfensters dieser Chain liegt (-32011). Die Fenstergröße entspricht state_window_blocks der Chain (aus GET /v1/chains). Auf Chains, die Traces bereitstellen, nutzen Sie die Data API für historische Traces.
export BLOCKVECTRA_API_KEY=rgw_your_api_key
curl -X POST "https://api.blockvectra.com/v1/robinhood_mainnet" \
-H 'Content-Type: application/json' \
-H "x-api-key: $BLOCKVECTRA_API_KEY" \
-d '{
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": ["0xYOUR_TRANSACTION_HASH", {"tracer": "callTracer"}],
"id": 1
}'CU-Abrechnungsregeln
Compute-Unit-Gewichtung (CU) für jede JSON-RPC-Methode.
| Methode | Gewichtung (CU) |
|---|---|
eth_blockNumber | 1 |
eth_chainId | 1 |
eth_getBlockByNumber | 5 |
eth_blobBaseFee | 10 |
eth_feeHistory | 10 |
eth_gasPrice | 10 |
eth_getBalance | 10 |
eth_getBlockByHash | 10 |
eth_getBlockReceipts | 10 |
eth_getBlockTransactionCountByHash | 10 |
eth_getBlockTransactionCountByNumber | 10 |
eth_getCode | 10 |
eth_getHeaderByHash | 10 |
eth_getHeaderByNumber | 10 |
eth_getProof | 10 |
eth_getRawTransactionByBlockHashAndIndex | 10 |
eth_getRawTransactionByBlockNumberAndIndex | 10 |
eth_getRawTransactionByHash | 10 |
eth_getStorageAt | 10 |
eth_getTransactionByBlockHashAndIndex | 10 |
eth_getTransactionByBlockNumberAndIndex | 10 |
eth_getTransactionByHash | 10 |
eth_getTransactionCount | 10 |
eth_getTransactionReceipt | 10 |
eth_getUncleByBlockHashAndIndex | 10 |
eth_getUncleByBlockNumberAndIndex | 10 |
eth_getUncleCountByBlockHash | 10 |
eth_getUncleCountByBlockNumber | 10 |
eth_maxPriorityFeePerGas | 10 |
eth_syncing | 10 |
net_version | 10 |
web3_clientVersion | 10 |
web3_sha3 | 10 |
eth_call | 15 |
eth_createAccessList | 20 |
eth_estimateGas | 20 |
eth_simulateV1 | 20 |
eth_getLogs | 30 |
eth_sendRawTransaction | 30 |
debug_traceBlockByHash | 100 |
debug_traceBlockByNumber | 100 |
debug_traceCall | 100 |
debug_traceTransaction | 100 |
trace_block | 100 |
trace_call | 100 |
trace_get | 100 |
trace_replayTransaction | 100 |
trace_transaction | 100 |
Methodenrichtlinie
Verfügbare Methoden variieren je nach Chain; die Liste jeder Chain ist unten dargestellt, und Unterstützte Chains deckt den Rest ab. Nur Methoden, die einem erlaubten Namen oder Muster entsprechen, sind erreichbar; jede andere Methode gibt -32601 method not available zurück.
Auf jeder der folgenden Chains zulässig
eth_blockNumbereth_calleth_chainIdeth_estimateGaseth_feeHistoryeth_gasPriceeth_getBalanceeth_getBlockByHasheth_getBlockByNumbereth_getBlockReceiptseth_getBlockTransactionCountByHasheth_getBlockTransactionCountByNumbereth_getCodeeth_getLogseth_getStorageAteth_getTransactionByBlockHashAndIndexeth_getTransactionByBlockNumberAndIndexeth_getTransactionByHasheth_getTransactionCounteth_getTransactionReceipteth_maxPriorityFeePerGaseth_syncingnet_versionweb3_clientVersion
Arbitrum One
eth_getLogs maximaler Blockbereich: 1,000 Blöcke; Statusfenster: 6,000 Blöcke
Ebenfalls zulässig
debug_traceBlockByHashdebug_traceBlockByNumberdebug_traceCalldebug_traceTransactioneth_blobBaseFeeeth_createAccessListeth_getHeaderByHasheth_getHeaderByNumbereth_getProofeth_getRawTransactionByBlockHashAndIndexeth_getRawTransactionByBlockNumberAndIndexeth_getRawTransactionByHasheth_getUncleByBlockHashAndIndexeth_getUncleByBlockNumberAndIndexeth_getUncleCountByBlockHasheth_getUncleCountByBlockNumbereth_sendRawTransactioneth_simulateV1web3_sha3
Base
eth_getLogs maximaler Blockbereich: 1,000 Blöcke; Statusfenster: 10,000 Blöcke
Ebenfalls zulässig
eth_blobBaseFeeeth_createAccessListeth_getProofeth_simulateV1eth_getRawTransactionByHasheth_getRawTransactionByBlockHashAndIndexeth_getRawTransactionByBlockNumberAndIndexeth_getUncleCountByBlockNumbereth_getUncleCountByBlockHasheth_getUncleByBlockNumberAndIndexeth_getUncleByBlockHashAndIndexeth_getHeaderByNumbereth_getHeaderByHasheth_sendRawTransactionweb3_sha3
BNB Smart Chain
eth_getLogs maximaler Blockbereich: 1,000 Blöcke; Statusfenster: 100 Blöcke
Ebenfalls zulässig
eth_sendRawTransaction
Ethereum
eth_getLogs maximaler Blockbereich: 1,000 Blöcke; Statusfenster: 250,000 Blöcke
Ebenfalls zulässig
debug_traceBlockByHashdebug_traceBlockByNumberdebug_traceCalldebug_traceTransactioneth_blobBaseFeeeth_createAccessListeth_getProofeth_sendRawTransactiontrace_blocktrace_calltrace_gettrace_replayTransactiontrace_transactionweb3_sha3
Ethereum Sepolia
eth_getLogs maximaler Blockbereich: 1,000 Blöcke; Statusfenster: —
Ebenfalls zulässig
eth_blobBaseFeeeth_createAccessListeth_getProofeth_sendRawTransactionweb3_sha3
HyperEVM
Das Senden von Transaktionen wird auf dieser Chain noch nicht unterstützt (eth_sendRawTransaction gibt -32601 method_not_allowed zurück); Lesemethoden funktionieren normal.
eth_getLogs maximaler Blockbereich: 1,000 Blöcke; Statusfenster: —
Polygon
eth_getLogs maximaler Blockbereich: 1,000 Blöcke; Statusfenster: 126 Blöcke
Ebenfalls zulässig
debug_traceBlockByHashdebug_traceBlockByNumberdebug_traceCalldebug_traceTransactioneth_blobBaseFeeeth_createAccessListeth_getHeaderByHasheth_getHeaderByNumbereth_getProofeth_getRawTransactionByBlockHashAndIndexeth_getRawTransactionByBlockNumberAndIndexeth_getRawTransactionByHasheth_getUncleByBlockHashAndIndexeth_getUncleByBlockNumberAndIndexeth_getUncleCountByBlockHasheth_getUncleCountByBlockNumbereth_sendRawTransactioneth_simulateV1web3_sha3
Robinhood Chain
eth_getLogs maximaler Blockbereich: 1,000 Blöcke; Statusfenster: 900 Blöcke
Ebenfalls zulässig
eth_blobBaseFeeeth_createAccessListeth_getProofeth_simulateV1eth_getRawTransactionByHasheth_getRawTransactionByBlockHashAndIndexeth_getRawTransactionByBlockNumberAndIndexeth_getUncleCountByBlockNumbereth_getUncleCountByBlockHasheth_getUncleByBlockNumberAndIndexeth_getUncleByBlockHashAndIndexeth_getHeaderByNumbereth_getHeaderByHasheth_sendRawTransactionweb3_sha3debug_traceTransactiondebug_traceCalldebug_traceBlockByNumberdebug_traceBlockByHash
Robinhood Chain Testnet
eth_getLogs maximaler Blockbereich: 1,000 Blöcke; Statusfenster: 1,023 Blöcke
Ebenfalls zulässig
debug_traceBlockByHashdebug_traceBlockByNumberdebug_traceCalldebug_traceTransactioneth_blobBaseFeeeth_createAccessListeth_getHeaderByHasheth_getHeaderByNumbereth_getProofeth_getRawTransactionByBlockHashAndIndexeth_getRawTransactionByBlockNumberAndIndexeth_getRawTransactionByHasheth_getUncleByBlockHashAndIndexeth_getUncleByBlockNumberAndIndexeth_getUncleCountByBlockHasheth_getUncleCountByBlockNumbereth_sendRawTransactioneth_simulateV1web3_sha3
Limits:
- Batch: maximal 100 Aufrufe pro Anfrage; zudem durch den CU-Burst des API-Schlüssels begrenzt, siehe unten.
- Request-Body: maximal 2 MiB
- CU-Burst: Jeder API-Schlüssel verfügt über einen CU-Bucket (
cu_per_secWiederauffüllung,burst_cuKapazität — Standardwerte sind 400 CU/s und Burst 1,600 CU; pro API-Schlüssel in der Konsole in der Tabelle Keys aufgeführt). Eine einzelne Anfrage — einschließlich eines gesamten JSON-RPC-Batches —, deren gesamte CU die Burst-Kapazität des API-Schlüssels überschreitet, wird mit-32022 request_exceeds_burst(request cost <N> CU exceeds burst capacity <M> CU) abgelehnt; teilen Sie diese in kleinere Batches auf.
Fehlercodes
Siehe die Fehlerreferenz für alle Fehlercodes, ob sie abgerechnet werden und was zu tun ist.
Vollständige OpenAPI-Referenz
Siehe die Vollständige OpenAPI-Referenz für die vollständige maschinenlesbare Spezifikation mit allen Methodensignaturen, Anfrage- und Antwortschemata sowie interaktiv gerenderten Parameterdetails.
Zuletzt aktualisiert:
Data API
Blockchain Data API-Anfragereferenz: REST-Endpunkte, API-Schlüssel-Authentifizierung, Parameter, Antwortschemata, Fehler und CU-Gewichte für indizierte Chain-Daten.
Vollständige Referenz
Vollständige JSON-RPC 2.0 API-Spezifikation und Endpunkt-Index. Durchsuchen Sie alle unterstützten Methoden, Anfrage- und Antwortstrukturen, Schematypen und Fehlercodes.