Introduction

The Web3 RPC API provides you with an easy way to maintain a constant, secure connection to the blockchain. These nodes provide reliable, real-time data access and interaction capabilities for executing transactions, monitoring block events, and querying network data efficiently.

Supported features

Supported API Interaction Methods

• JSON-RPC — Standard request–response protocol used for blockchain node interactions.
• WebSockets (Subscriptions) — Persistent, event-driven connections for receiving real-time updates.
• gRPC (Solana only) — High-performance, streaming-capable remote procedure calls for low-latency and real-time interactions on the Solana blockchain.

Getting Started

Select a chain from the navigation to view available JSON-RPC methods for that network. Each chain has its own set of methods that can be called using JSON-RPC requests.

Authentication

For authentication details, see the Authentication documentation.

Base URL

The base URL for all Web3 RPC requests is:https://api.1inch.com/web3/{chainId}

Where {chainId} is the chain ID of the network you want to interact with.

Benefits

• Maximal uptime: we have developed the most advanced internal systems for node health check/load balancing, which enable us to offer the maximum possible uptime.
• High load resistance: thanks to our significant expertise, we can support high network load without sacrificing uptime.
• Support for multiple chains: the Web3 RPC API supports different EVM networks, allowing you to interact with various blockchains through a single provider.
• Seamless integration: easily integrate with your existing web3 projects using standard Web3 libraries.
• Included in all plans: the Web3 RPC API, is included in all plans
• Full and archive node support: choose between low-latency full nodes for real-time execution and archive nodes with complete historical blockchain state for analytics, auditing, and backtesting.

Example

Here's a simple example using viem to make a JSON-RPC call:

         
         

           TypeScript
         
 
         
         

           
           

             
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
           
 
           
           
import { createPublicClient, http } from "viem";
import { mainnet } from "viem/chains";

const client = createPublicClient({
  chain: mainnet,
  transport: http("https://api.1inch.com/web3/1", {
    fetchOptions: {
      headers: {
        Authorization: `Bearer ${process.env.API_KEY}`
      }
    }
  })
});

// Get the current block number
const blockNumber = await client.getBlockNumber();
console.log("Current block number:", blockNumber);
         
       

Potential use cases

• Decentralized applications (dApps): ensure your dApp has a stable and secure connection to the blockchain for tasks like reading smart contract data, sending transactions, and querying blockchain state.
• Decentralized exchanges (DEXes): maintain high uptime and reliable data feeds for trading operations, ensuring users can trade assets seamlessly.
• Trading bots: achieve fast and reliable access to blockchain data to make timely trading decisions and execute trades.
• Wallets: provide users with real-time balance updates, transaction statuses, and other important blockchain data.
• Analytics platforms: collect and analyze blockchain data for insights and trends without worrying about node maintenance.

API Reference

For detailed information about each endpoint, refer to the Web3 RPC API section.