Skip to main content

Getting Started with NodeTrace

Welcome to NodeTrace - your gateway to Ethereum Archive node access. This documentation will help you get started with our RPC service.

What is NodeTrace?​

NodeTrace provides public access to Ethereum Archive nodes with simple API key authentication. Whether you're building a dApp, running analytics, or need historical blockchain data, NodeTrace offers reliable and affordable access.

Quick Start​

1. Connect Your Wallet​

Visit www.nodetrace.xyz and click "Connect Wallet" to sign in with your Ethereum wallet.

2. Generate an API Key​

Once connected, navigate to your Dashboard to generate your first API key.

3. Make Your First Request​

Use your API key in the URL path to make requests:

curl -X POST https://eth.nodetrace.xyz/rpc/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Features​

  • Free Tier: 1,000 requests per month
  • Pro Tier: 600,000 requests per month ($5/mo)
  • Max Tier: 2,000,000 requests per month ($15/mo)
  • Archive Node: Access to full Ethereum history
  • Debug API: Advanced trace and debug methods
  • Standard JSON-RPC: Compatible with all Web3 libraries
  • Simple Authentication: Just use your API key

API Usage Examples​

Using with Web3 Libraries​

JavaScript (ethers.js)​

const { ethers } = require('ethers');

// Using API key in URL path
const provider = new ethers.JsonRpcProvider(
  'https://eth.nodetrace.xyz/rpc/YOUR_API_KEY'
);

// Get current block number
const blockNumber = await provider.getBlockNumber();
console.log('Current block:', blockNumber);

Python (web3.py)​

from web3 import Web3

# Using API key in URL path
w3 = Web3(Web3.HTTPProvider(
    'https://eth.nodetrace.xyz/rpc/YOUR_API_KEY'
))

# Get current block number
block_number = w3.eth.block_number
print(f'Current block: {block_number}')

Next Steps​