Quick Start Guide

This guide will help you quickly integrate TheRPC into your project. Follow these steps to start making blockchain API calls.

Step 1: Get an API Key

To use TheRPC, you'll need an API key:

Sign up at TheRPC.io
Navigate to the dashboard
Create or retrieve your API key

Step 2: Choose Your Network

TheRPC supports multiple networks. Configure your environment with your API endpoint and key:

1API_ENDPOINT="YOUR_API_ENDPOINT"
2API_KEY="YOUR_API_KEY"

Step 3: Make Your First Call

Here are basic examples for different programming languages. For more comprehensive examples and language-specific features, check out our Tools & SDKs Overview.

Using Curl

1curl --request POST ${API_ENDPOINT} \
2  --header 'Content-Type: application/json' \
3  --header 'Authorization: Bearer ${API_KEY}' \
4  --data '{
5    "jsonrpc": "2.0",
6    "method": "eth_blockNumber",
7    "params": [],
8    "id": 1
9  }'

Using JavaScript

1const axios = require('axios');
2 
3const config = {
4	url: 'YOUR_API_ENDPOINT',
5	apiKey: 'YOUR_API_KEY',
6};
7 
8async function getBlockNumber() {
9	const response = await axios.post(
10		config.url,
11		{
12			jsonrpc: '2.0',
13			method: 'eth_blockNumber',
14			params: [],
15			id: 1,
16		},
17		{
18			headers: {
19				'Content-Type': 'application/json',
20				Authorization: `Bearer ${config.apiKey}`,
21			},
22		},
23	);
24 
25	console.log('Latest Block Number:', response.data.result);
26}

Using Python

1import requests
2 
3config = {
4    'url': 'YOUR_API_ENDPOINT',
5    'api_key': 'YOUR_API_KEY'
6}
7 
8def get_block_number():
9    response = requests.post(
10        config['url'],
11        headers={
12            'Content-Type': 'application/json',
13            'Authorization': f"Bearer {config['api_key']}"
14        },
15        json={
16            'jsonrpc': '2.0',
17            'method': 'eth_blockNumber',
18            'params': [],
19            'id': 1
20        }
21    )
22    return response.json()['result']

Step 4: Using Web3 Libraries

For more complex interactions, we recommend using Web3 libraries. You can find detailed examples for all supported languages and frameworks in our Tools & SDKs documentation.

Web3.js (JavaScript)

1const Web3 = require('web3');
2const web3 = new Web3('YOUR_API_ENDPOINT');
3 
4// Add API key to requests
5web3.setHeader('Authorization', 'Bearer YOUR_API_KEY');
6 
7async function getBalance(address) {
8	const balance = await web3.eth.getBalance(address);
9	return web3.utils.fromWei(balance, 'ether');
10}

Web3.py (Python)

1from web3 import Web3
2from web3.middleware import http_retry_request_middleware
3 
4w3 = Web3(Web3.HTTPProvider(
5    'YOUR_API_ENDPOINT',
6    request_kwargs={
7        'headers': {'Authorization': 'Bearer YOUR_API_KEY'}
8    }
9))
10 
11# Add retry middleware
12w3.middleware_onion.add(http_retry_request_middleware)

Available Methods

All supported API methods with examples in different programming languages can be found in our Ethereum Methods documentation. This includes:

Detailed method descriptions
Request and response formats
Language-specific code examples
Common use cases

Network Selection

When using TheRPC, you'll receive specific API endpoints for each network you want to access. Simply replace YOUR_API_ENDPOINT with the appropriate endpoint for your chosen network.

Next Steps

Browse our Ethereum Methods documentation for all available API methods
Check out Tools & SDKs for language-specific guides
Learn about Authentication
Review Rate Limits
Explore Basic Operations