Guides

Practical guides and workflows for integrating BlockVectra APIs, managing CU consumption, and building multichain applications.

Practical guides and end-to-end workflows for using BlockVectra JSON-RPC and Data APIs across supported chains.

Robinhood Chain RPC URL: mainnet and testnet

Connect to Robinhood Chain mainnet (chain ID 4663) or testnet (46630). Read blocks without an API key using curl, viem or ethers, or configure an eRPC local proxy with your API key.

HoodFi on Robinhood Chain: read coin type 2147488311 name records

Read a HoodFi name's Robinhood address with viem, select coin type 2147488311, and compare coin type 60 at the same canonical block hash.

Robinhood Chain testnet RPC URL and chain ID: keyless reads, WebSocket logs, faucet

Robinhood Chain testnet RPC URL https://api.blockvectra.com/v1/robinhood_testnet/public, chain ID 46630: keyless reads, WebSocket logs with an API key, faucet access, and switching the same key to mainnet.

Robinhood Chain testnet faucet and RPC: claim test ETH, then connect

Claim Robinhood Chain testnet ETH with your own API key (0.001 per claim). Testnet chain ID 46630, keyless RPC URL https://api.blockvectra.com/v1/robinhood_testnet/public; claim limits and error handling.

Robinhood Chain stock tokens: reading the multiplier, holders and daily activity with one API key

Understand the Robinhood Chain stock token multiplier, convert balances to shares, read uiMultiplier via eth_call, and track holders and daily activity via the Data API.

Stock token holders and transfers API on Robinhood Chain

Stock token holders, transfers and wallet balances on Robinhood Chain with one API key: /tokens/{token}/holders, /transfers, /balances. Not stock quotes.

Free RPC credits: how many free CU and calls you get

Free RPC credits: 30,000,000 CU per 30-day window, about 2,000,000 eth_call requests, 25 calls per second per account, no credit card.

DEX daily prices API: OHLC and VWAP for any token

Get daily DEX OHLC prices and VWAP for a token with one GET /{chain}/dex/prices request, plus exact fractions in TypeScript and Python and backfills.

Base RPC URL: keyless access, curl and viem examples

Connect to Base mainnet with a public RPC URL or API key. Use curl and viem examples, check supported methods and limits, and inspect Data API status.

HyperEVM public RPC rate limit and eth_getLogs block range

HyperEVM public RPC: the official endpoint allows 100 requests per minute per IP and 50 blocks per eth_getLogs; BlockVectra's keyless endpoint allows 3 requests per second per IP, and eth_getLogs with a key covers up to 1,000 blocks. Split longer windows and save a cursor.

Deploy a contract with Foundry or Hardhat

Deploy Hello.sol on an EVM network with Foundry or Hardhat 2, verify the chain ID, and check the transaction receipt and contract response.

One key, many chains: switching an example to another chain

The same API key works on every supported chain. Learn how URLs are structured, how to discover chains programmatically, and how balances and limits pool.

Ink RPC: free chain ID read, keyed pool discovery

Use Ink RPC with no API key to read chain ID 57073 (0xdef1) for free. Pool discovery with hash-pinned eth_call and Multicall3 requires an API key.

How to monitor wallet addresses for transfers and receive webhooks

Create one HTTP subscription with your HTTPS URL, chains and up to 1,000,000 addresses; native, token and log matches are POSTed with a signed body at least once. Verify signatures, deduplicate event IDs and replay retained matches.

What is not billed: error codes and billing rules

A detailed breakdown of billing rules across HTTP status codes, JSON-RPC errors, and the Data API, with recommended actions for developers.

Pay for RPC with USDC / USDT / USDG: programmatic top-up for AI agents

Top up an RPC and Data API account on-chain over HTTP. Developers and AI Agents use an API key to check supported tokens, retrieve a dedicated deposit address and poll credit status.

Gas Station: API and wallet authorization

Gas Station authentication, chain readiness, quote authorization, task recovery, and known or unknown costs.

Blockchain RPC and docs MCP for AI Agents

Connect AI Agents to blockchain RPC and docs MCP: discover capabilities without a key, sign up over HTTP, then call RPC and Data API with an API key.

BlockVectra MCP server: blockchain RPC and docs tools for AI agents

The BlockVectra Model Context Protocol (MCP) server gives developers and AI agents keyless blockchain RPC, chain status, pricing and docs tools, with one-line install for Claude Code, Cursor, VS Code, Codex, Gemini CLI, Antigravity and more.

Blockchain RPC and docs MCP for Agent frameworks

Configure blockchain RPC for LangChain, ElizaOS, viem, wagmi, and Coinbase AgentKit, with a page and runnable code for each, and discover capabilities via docs MCP. Includes AgentOS RPC_ROBINHOOD_URL setup on Robinhood Chain using an API-key URL.

LangChain tool to read Ethereum blockchain data

Build a LangChain tool to read Ethereum blockchain data over BlockVectra's keyless public RPC endpoint, then add the docs MCP server and an API key.

ElizaOS EVM plugin RPC provider: BlockVectra setup

Use BlockVectra as the RPC provider for the ElizaOS EVM plugin (plugin-evm) with two environment variables, keyless on the public endpoint, plus docs MCP.

Coinbase AgentKit Base RPC provider: BlockVectra setup

Use BlockVectra as the Base RPC provider for Coinbase AgentKit: point ViemWalletProvider's viem client at the keyless public endpoint, then add a key.

Get a blockchain API key with a wallet signature (SIWE)

Sign a message locally with your wallet and get an API key plus 30,000,000 free CU, no payment first. 3 BlockVectra HTTP requests and a local wallet signature in 4 steps, no browser, for developers and AI agents.

How to Monitor USDT / USDC Payments with Webhooks and RPC

Build a payment receiver and polling cursor. Verify token contracts, recipients and integer amounts, deduplicate events and reconcile missing or replaced blocks.

How to Verify a LineKey Agent Payment Receipt with RPC

Run a read-only Node.js script that checks one direct Priors LineKey spend receipt on Robinhood Chain mainnet against your invoice: pinned contracts, Paid, Borrowed and USDG Transfer logs, exact integer amounts.

eth_getLogs vs Token Transfers API: ERC-20 transfer history

Choose eth_getLogs for contract event logs or the Token Transfers API for indexed ERC-20 transfer history. Compare block ranges, pagination, coverage and finality.

eth_getLogs block range too large: the block range limit per chain and how to split queries

With an API key, one eth_getLogs request may span 1,000 blocks on HyperEVM; each chain publishes its own max_logs_block_range. On logs_range_too_large, split the inclusive block interval within that limit and advance only after the chunk succeeds.

How Much Do RPC Calls Cost per Million? CU Weights and Price per Million Calls

At current published rates, eth_call costs 15 CU per call, or $1.50 per million calls before available free credits; fetch the current plans API for your workload estimate.

How to choose an RPC provider

Evaluate RPC method costs, log ranges, free credits, rate limits, chain coverage, push and data APIs, authentication and Agent access with workload self-tests.

Wallet token balances API: list ERC-20 assets for an address

List a wallet's non-zero ERC-20 token balances with one GET /addresses/{address}/balances request, then add transfer history and token metadata.

Transaction traces: debug_traceTransaction and the Data API trace endpoints

Reconstruct execution call trees for a transaction: the JSON-RPC debug_traceTransaction method with its allowed tracers and guards, and the Data API getTransactionTrace and getBlockTraces endpoints with their coverage bounds.

Simulate before you send: dry-running transactions with eth_simulateV1

Dry-run multiple transactions and inspect state changes before sending them on-chain using eth_simulateV1. Learn supported chain method policies, execution spec request payloads, CU pricing weights, and AI Agent MCP integration.

MetaMask and Rabby Custom RPC Setup: URL and Chain ID

Add a BlockVectra RPC URL to MetaMask or Rabby. Find chain IDs and native symbols, configure a path API key and manage a dedicated wallet key.

WebSocket Subscriptions

Connect to BlockVectra WebSocket endpoints for eth_subscribe newHeads and logs. Learn connection methods, filter rules, reconnection backoff, and recovery.

Next steps

Browse the datasets directory to see every dataset BlockVectra indexes.
See the free plan and pricing to check what your account includes.
Log in to the console to create an API key.