| Getting Started | Create your account, explore plans & features, and make your first API call | /files/xWUoQfpc0XaLni2YLMgb | /pages/mVgnRqAFZCAbhLhEnSZG | |
| Guides | Set up endpoints, manage access tokens, and integrate GetBlock APIs step-by-step | /files/zlQhfk77YmHREgWyPMp6 | /pages/R4pUHuTKY14ectSvd4TO | |
| API Reference | View supported networks, available endpoints, and full API specifications | /files/YxptuIB6Qew9b78pWSJX | /pages/411OdmnFkdjqCUVWSdSO |
GetBlock's Sign-Up page, where users can register to access blockchain services
GetBlock user Dashboard
| Action | Owner | Admin | Member |
|---|---|---|---|
| Create & manage access tokens | ✅ | ✅ | 🔓 |
| Manage subscriptions & payments | ✅ | ✅ | 🔓 |
| Add & remove team members | ✅ | ✅ | ❌ |
| Edit access levels | ✅ | ✅ | ❌ |
| Promote to Admin | ✅ | ❌ | ❌ |
Regenerate or delete your access token
| Title | Target | |
|---|---|---|
| Choosing Your Plan | Compare Shared Nodes, Limitless Node, and Dedicated Nodes. | /spaces/FOeg95CadVyFvyLi70Bh/pages/iHxZiz8nc1UlFhebQA9e |
| CU and Rate Limits | GetBlock's Compute Unit (CU) and requests-per-second (RPS) limits across plans. | /pages/CnDqqWS3NzCn3BWzJiIS |
| Limitless Node | Explore the Limitless plan without CU and request limits. | /pages/zJqkw6KQGW6thdvSyseW |
| What counts as a CU? | Compute Units (CUs) explained. | /pages/djR6qJbFewD6N5talLM7 |
| Top up CUs | Add more CUs to your active plan. | /pages/Ns7FI1xrutAYq3FHIB30 |
| Dedicated Nodes | Manage & extend Dedicated Node subscriptions. | /pages/udr2z6pv940urtNu3CCK |
| Payment Methods | Set up billing with fiat or crypto. | /pages/Pl2Bvmz2D7cotv2tDrqD |
| Status | Dashboard View | Manage Plans View |
|---|---|---|
(Recurring Payment) | ||
(One-Time Payment) | ||
(One-Time Payment) | ||
(Recurring /One-Time) |
| Plan | Price (monthly) | CU Allocation | RPS Limit | Access Tokens (Endpoints) | CU Top-ups |
|---|---|---|---|---|---|
| Free | $0 | 50,000 / day | 20 RPS | 2 | false |
| Starter | $49 | 90M / mo | 250 RPS | 30 | true |
| Growth | $99 | 185M / mo | 300 RPS | 45 | true |
| Advanced | $199 | 385M / mo | 450 RPS | 75 | true |
| Scale | $349 | 700M / mo | 600 RPS | 105 | true |
| Pro | $499 | 1B / mo | 800 RPS | 150 | true |
| Premium | $699 | 1.6B / mo | 800 RPS | 225 | true |
| Enterprise | from $999 | Custom | Custom | Custom | true |
| Chains | Multiplier |
|---|---|
| Algorand, Bitcoin, Bitcoin Cash, Dash, Dogecoin, Ethereum Classic, Litecoin, Near, Rootstock, Sonic,Telos, Zcash, others | 10 |
| Aptos, Arbitrum, Avalanche, BNB Smart Chain, Base, Blast, Cosmos, Cronos, Ethereum, Flow, Gnosis, Harmony, Kaia, Linea, OKT, Optimism, Polygon, Polygon zkEVM, Tezos, Tron, XRP, opBNB | 20 |
| Allora, Avail, Bahamut, Chiliz, Zilliqa, Xphere | 30 |
| 0g, Akash, Atleta, Berachain, Bitlayer, Botanix, Cardano, Core, Cronos zkEVM, Etherlink, Flare, Goat, Gravity, IOTA, IOTA EVM, Immutable zkEVM, Matchain, Metis, Midnight, Monad, Movement, Nervos, Oasis, Rollux, Siacoin, Solana, Somnia, Soneium, Stacks, Stellar, Swellchain, TON, Taiko, Tenet, XDC, Xai, Zora | 50 |
| Kusama, Polkadot | 60 |
| ZKsync | 80 |
| Arbitrum Nova, Celo, Corn, Ink, Lens, Scroll, Shiba Inu, StarkNet, Sui, TAC, Unichain | 100 |
| Filecoin | 140 |
| Ronin | 180 |
| B3, Electroneum, Incentiv | 200 |
| Moonbeam, Sei | 300 |
| Ethereum RPC Method | Method Multiplier | Base Chain Multiplier | Total CU |
|---|---|---|---|
eth_blockNumber | 1 | 20 | 20 |
eth_getTransactionByHash | 1 | 20 | 20 |
debug_traceTransaction | 2 | 20 | 40 |
debug_traceBlock | 2 | 20 | 40 |
trace_call | 2 | 20 | 40 |
trace_transaction | 2 | 20 | 40 |
txpool_status | 2 | 20 | 40 |
trace_replayTransaction | 4 | 20 | 80 |
| Ethereum RPC Method | Method Multiplier | Base Chain Multiplier | Archive Modifier | Total CU (Archive Endpoint) |
|---|---|---|---|---|
eth_blockNumber | 1 | 20 | 2 | 40 |
eth_getTransactionByHash | 1 | 20 | 2 | 40 |
debug_traceTransaction | 2 | 20 | 2 | 80 |
debug_traceBlock | 2 | 20 | 2 | 80 |
trace_call | 2 | 20 | 2 | 80 |
trace_transaction | 2 | 20 | 2 | 80 |
txpool_status | 2 | 20 | 2 | 80 |
trace_replayTransaction | 4 | 20 | 2 | 160 |
Selecting fiat as a payment method
Crypto payments
| Feature | High Performance | Standard Performance |
|---|---|---|
| Resource allocation | Maximum hardware and bandwidth | Balanced hardware profile |
| Throughput | Highest supported | High |
| Uptime SLA | 99.95% | 99.9% |
| Recommended for | Applications with high transaction volumes & large user bases, mission-critical systems, and any workflow where latency and throughput are the top priority | Most production dApps, wallets, and enterprise tools or projects that need guaranteed resources but do not require the maximum performance tier |
Dedicated Node pricing in the GetBlock Dashboard
Using Postman to send a JSON-RPC request to an Ethereum node via GetBlock
| Code | Error message | Solution |
|---|---|---|
| 401 | Access denied | Double-check that <ACCESS_TOKEN> is correctly replaced with your actual token. Ensure there are no trailing spaces. |
| 404 | Could not resolve host | Verify that the URL https://go.getblock.io/<ACCESS_TOKEN>/ is correct. |
| 429 | Too many requests | Check your GetBlock account for usage limits. Upgrade your plan if necessary. |
| Code | Error message | Solution |
|---|---|---|
| 32601 | The method does not exist/is not available | Verify the method name (eth_blockNumber, eth_getBalance, etc.) against the blockchain's JSON-RPC specifications. |
| 32602 | Invalid argument | Ensure the parameters in the params array match the expected format for the method. |
| 32700 | Parse error | Double-check your JSON syntax. Ensure your request is properly formatted. |
The Statistics tab shows more in-depth and customizable data analysis for your endpoints
Generate an RPC URL for MetaMask
| Field | Description | Example |
|---|---|---|
| RPC URL | The network's JSON-RPC URL from your GetBlock account | https://go.getblock.io/<ACCESS_TOKEN>/ |
| Chain ID | The ID of the network | 1101 |
| Network name | Fetched automatically based on Chain ID | Polygon zkEVM |
| Currency symbol | Suggested automatically based on Chain ID | ETH |
| Block explorer URL | Optional field | https://zkevm.polygonscan.com/ |
| Overview | Learn how Yellowstone gRPC works and why it's essential for real-time Solana applications | /pages/fzc2q4ipTlaoOG6NspDZ |
| Quickstart Guide | Enable the add-on and start streaming data with code examples in TypeScript, Python, Go, and Rust | /pages/dNGDBl1qjPbE6crdV7nN |
| Extra services | It solves | Price/mo |
|---|---|---|
| Advanced Analytics | You cannot see how your node is used | $199 |
| Automatic RPC Failover | Your app breaks when the node degrades | $199 |
| Custom Endpoint URL | Your endpoint URL exposes a random hash | $199 |
| Dedicated Ingress Proxy | Other traffic shares your routing layer | $199 |
| IP Allowlist | Anyone with the key can call the node | $199 |
| Nonstandard Client Support | You need a namespace or client we do not run by default | $500 |
| Solana Shreds Streaming | Standard feeds report Solana activity too late | On request |
| Unified Multichain Endpoint | You manage one URL per chain | $199 |
| Zero-Hop Node Access | The proxy layer adds latency you cannot afford | $199 |
import WebSocket from "ws";
import { ethers } from "ethers";
import "dotenv/config";
const PANCAKE_ROUTER = "0x10ED43C718714eb63d5aA57B78B54704E256024E";
const SWAP_METHODS = {
"0x38ed1739": "swapExactTokensForTokens",
"0x7ff36ab5": "swapExactETHForTokens",
"0x18cbafe5": "swapExactTokensForETH",
"0xfb3bdb41": "swapETHForExactTokens",
"0x5c11d795": "swapExactTokensForTokensSupportingFeeOnTransferTokens",
"0xb6f9de95": "swapExactETHForTokensSupportingFeeOnTransferTokens",
};
function monitorPancakeSwap() {
const ws = new WebSocket(`wss://go.getblock.io/${process.env.ACCESS_TOKEN}`);
ws.on("open", () => {
console.log("🔌 Connected to BSC stream");
console.log("📊 Monitoring PancakeSwap...\n");
ws.send(
JSON.stringify({
jsonrpc: "2.0",
id: 1,
method: "subscribe",
params: [
"pendingTxs",
{
include: ["tx_hash", "from", "to", "value", "input", "gas_price"],
filters: {
to: [PANCAKE_ROUTER],
},
},
],
}),
);
});
ws.on("message", (data) => {
const msg = JSON.parse(data);
// Subscription confirmed
if (msg.id === 1) {
console.log("✅ Subscribed to PancakeSwap transactions\n");
return;
}
// New transaction
if (msg.params?.result) {
const tx = msg.params.result;
const methodId = tx.input?.slice(0, 10);
const methodName = SWAP_METHODS[methodId] || "unknown";
if (SWAP_METHODS[methodId]) {
const value = ethers.formatEther(tx.value || "0");
const gasPrice = ethers.formatUnits(tx.gas_price || "0", "gwei");
console.log("🔄 Swap detected:");
console.log(` Hash: ${tx.tx_hash.slice(0, 18)}...`);
console.log(` Method: ${methodName}`);
console.log(` From: ${tx.from.slice(0, 10)}...`);
console.log(` Value: ${value} BNB`);
console.log(` Gas: ${gasPrice} gwei`);
console.log("");
}
}
});
ws.on("close", () => {
console.log("Disconnected, reconnecting in 5s...");
setTimeout(monitorPancakeSwap, 5000);
});
ws.on("error", (err) => {
console.error("WebSocket error:", err.message);
});
}
monitorPancakeSwap();
import WebSocket from 'ws';
import 'dotenv/config';
const PANCAKE_ROUTER = '0x10ED43C718714eb63d5aA57B78B54704E256024E';
const SWAP_METHODS = {
'0x38ed1739': 'swapExactTokensForTokens',
'0x7ff36ab5': 'swapExactETHForTokens',
'0x18cbafe5': 'swapExactTokensForETH',
'0xfb3bdb41': 'swapETHForExactTokens',
};
function monitorNewTxs() {
const ws = new WebSocket(`wss://go.getblock.io/${process.env.ACCESS_TOKEN}`);
ws.on('open', () => {
console.log('Connected to BSC stream');
console.log('Monitoring confirmed PancakeSwap swaps...\n');
ws.send(JSON.stringify({
jsonrpc: '2.0',
id: 1,
method: 'subscribe',
params: ['newTxs', {
include: ['tx_hash', 'from', 'to', 'value', 'input'],
filters: {
to: [PANCAKE_ROUTER],
method_id: Object.keys(SWAP_METHODS)
}
}]
}));
});
ws.on('message', (data) => {
const msg = JSON.parse(data);
if (msg.id === 1) {
console.log('Subscribed to confirmed PancakeSwap transactions\n');
return;
}
if (msg.params?.result) {
const tx = msg.params.result;
const methodId = tx.input?.slice(0, 10);
const methodName = SWAP_METHODS[methodId] || 'unknown';
console.log('Confirmed swap:');
console.log(` Hash: ${tx.tx_hash}`);
console.log(` Method: ${methodName}`);
console.log(` From: ${tx.from}`);
console.log(` To: ${tx.to}`);
console.log(` Value: ${tx.value}`);
console.log('');
}
});
ws.on('close', () => {
console.log('Disconnected, reconnecting in 5s...');
setTimeout(monitorNewTxs, 5000);
});
ws.on('error', (err) => {
console.error('WebSocket error:', err.message);
});
}
monitorNewTxs();
import WebSocket from 'ws';
import 'dotenv/config';
const ws = new WebSocket(`wss://go.getblock.io/${process.env.ACCESS_TOKEN}`);
ws.on("open", () => {
console.log("Connected");
// Subscribe to new blocks
ws.send(JSON.stringify({
jsonrpc: '2.0',
id: 1,
method: 'subscribe',
params: ['txReceipts', {
include: ['receipt', 'logs']
}]
}));
});
ws.on("message", (data) => {
const message = JSON.parse(data);
console.log(message)})
include fields| Problem | Solution |
|---|---|
| Transaction not included | Without a priority tip, private transactions compete based on gas fees alone. If your transaction isn't being included:
|
| "Invalid transaction" |
|
| Connection issues |
|
mev\_builders: \["48club", "bloxroute"]If your bundle is not included after the specified block count:
This error indicates a formatting or validation issue:
transactions parameter must be an array; mev\_builders must be an objectBundles execute atomically, so partial execution should not occur. If you observe partial execution:
| API category | Public label | Group | Customer-facing meaning |
|---|---|---|---|
cyberThreatActivity | Cyber threat activity | Risk | Activity linked to hacking, phishing, malicious software, stolen credentials, compromised wallets or accounts, and attacks against blockchain protocols or digital services. |
extortionActivity | Extortion activity | Risk | Activity involving ransomware-related extortion, ransom demands, blackmail, or other coercive attempts to obtain assets. |
fraudulentSchemes | Fraudulent schemes | Risk | Deceptive schemes intended to obtain funds or assets, including scams and fraudulent investment structures. |
stolenAssets | Stolen assets | Risk | Funds or other digital assets reported as stolen, misappropriated, or connected to theft. |
darknetActivity | Darknet activity | Risk | Activity associated with darknet marketplaces or services used for illegal purposes. |
illegalGoodsTrafficking | Illegal goods trafficking | Risk | Activity associated with the production, sale, or distribution of prohibited goods, including controlled drugs or weapons. |
childAbuse | Child abuse | Risk | Activity associated with the abuse or exploitation of children. |
humanExploitation | Human exploitation | Risk | Activity associated with human trafficking, forced exploitation, or the unlawful trade of people. |
terrorismAndExtremism | Terrorism and extremism | Risk | Activity associated with terrorist or extremist organizations, their operations, support, or financing. |
proliferationFinancing | Proliferation financing | Risk | Activity associated with financing the proliferation of weapons of mass destruction. |
transactionObfuscation | Transaction obfuscation | Risk | Use of services or techniques intended to conceal transaction origins, destinations, ownership, or movement of funds. |
gambling | Gambling | Risk | Activity associated with gambling services. |
otherCriminalActivity | Other criminal activity | Risk | Criminal activity that cannot be represented by a more specific public risk category. |
sanctions | Sanctions | Compliance | A reported connection to an official sanctions designation or a jurisdiction subject to sanctions restrictions. |
jurisdictionRisk | Jurisdiction risk | Compliance | Exposure associated with a jurisdiction identified as presenting elevated AML or counter-terrorist-financing risk. |
limitedComplianceControls | Limited compliance controls | Compliance | Exposure to a service with weak, missing, or insufficient identity verification and compliance controls. |
legalAndRegulatoryAttention | Legal and regulatory attention | Compliance | A signal requiring enhanced review because of regulatory, legal, enforcement, political-exposure, litigation, or asset-seizure context. |
otherComplianceRisk | Other compliance risk | Compliance | A compliance-related concern that does not fit a more specific public category. |
insufficientInformation | Insufficient information | Compliance | Available information is not sufficient to assign a meaningful risk or entity category. |
assetRestriction | Asset restriction | Compliance | A specific asset associated with the address has been restricted or blocked by its issuer or another responsible authority. |
assetTradingService | Asset trading service | Entity / service | A service used to buy, sell, or exchange digital assets, including direct and brokered trading models. |
decentralizedFinance | Decentralized finance | Entity / service | A decentralized protocol or application providing trading, lending, staking, or other financial functionality. |
walletAndCustody | Wallet and custody | Entity / service | A wallet or custody service that stores, manages, or safeguards digital assets. |
paymentsAndCommerce | Payments and commerce | Entity / service | A service facilitating cryptocurrency payments, purchases, or commercial transactions. |
fundraisingAndInvestment | Fundraising and investment | Entity / service | Activity involving investment products, fundraising, donations, crowdfunding, or charitable funding. |
miningActivity | Mining activity | Entity / service | Activity associated with cryptocurrency mining, mining pools, or remotely provided mining services. |
onchainApplication | On-chain application | Entity / service | A blockchain application or smart-contract-based service, including games and digital-asset applications. |
technologyInfrastructure | Technology infrastructure | Entity / service | Technical infrastructure or hosting used to support blockchain or digital-asset services. |
institutionalEntity | Institutional entity | Entity / service | A government, political, educational, cultural, or media organization. |
personalWallet | Personal wallet | Entity / service | An address attributed to an individual rather than an identified service or organization. |
adultContentService | Adult content service | Entity / service | A service associated with adult content or related commercial activity. |
| Axis | What it measures |
|---|---|
| Historical exposure | Aggregated risk across the wallet's entire on-chain history. |
| Current exposure | Risk weighted to the current balance and recent activity from about 90 days. |
| Direct interaction risk | Exposure from counterparties one hop away — scored separately for incoming and outgoing flow. |
| Token-level breakdown | Each token on the wallet is scored independently — a clean ETH balance does not mask a risky USDT flow. |
| Step | Action |
|---|---|
| 01 | Pick a network — ETH, TRX , BTC, LTC, BCH |
| 02 | Paste a wallet or transaction — an address or a transaction hash. |
| 03 | Read the report — a risk score, exposure breakdown, and FATF flags in seconds. |
| Method | Usage |
|---|---|
eth_getTransactionCount | Pass "pending" for a nonce that accounts for Flashblock transactions |
eth_getStorageAt | Pass "pending" for storage at preconfirmed state |
eth_getBalance | Pass "pending" for the balance at the latest Flashblock state |
eth_getBlockByNumber | Pass "pending" to retrieve the current Flashblock |
eth_getBlockReceipt | Pass "pending" to get receipts for all pre-confirmed transactions in the current Flashblock. |
eth_getBlockTransactionCountByNumber | Pass "pending" to get the count of pre-confirmed transactions in the current Flashblock. |
eth_estimateGas | Pass "pending" to estimate gas against preconfirmed state |
eth_call | Pass "pending" to execute against preconfirmed state |
eth_simulateV1 | Simulates against the latest preconfirmed state |
eth_getLogs | Pass "fromBlock": "pending" and "toBlock": "pending" to query logs from pre-confirmed transactions, updated every ~200ms. |
eth_getCode | Pass "pending" for contract code at preconfirmed state |
base_transactionStatus | Reports whether a transaction hash is present in the mempool |
eth_subscribe | Opens a Flashblocks WebSocket subscription |
eth_unsubscribe | Cancels an active Flashblocks subscription |
| Method | Usage |
|---|---|
eth_getTransactionCount | Pass "pending" for a nonce that accounts for Flashblock transactions |
eth_getStorageAt | Pass "pending" for storage at preconfirmed state |
eth_getBalance | Pass "pending" for the balance at the latest Flashblock state |
eth_getBlockByNumber | Pass "pending" to retrieve the current Flashblock |
eth_getBlockReceipt | Pass "pending" to get receipts for all pre-confirmed transactions in the current Flashblock. |
eth_getBlockTransactionCountByNumber | Pass "pending" to get the count of pre-confirmed transactions in the current Flashblock. |
eth_estimateGas | Pass "pending" to estimate gas against preconfirmed state |
eth_call | Pass "pending" to execute against preconfirmed state |
eth_simulateV1 | Simulates against the latest preconfirmed state |
eth_getLogs | Pass "fromBlock": "pending" and "toBlock": "pending" to query logs from pre-confirmed transactions, updated every ~200ms. |
eth_getCode | Pass "pending" for contract code at preconfirmed state |
eth_subscribe | Opens a Flashblocks WebSocket subscription |
eth_unsubscribe | Cancels an active Flashblocks subscription |