Getting started
Create an Infura project and send requests to the Ethereum network.
To sign up for an account on the Infura website, enter your email address and password, and click SIGN UP.
Infura sign up
To activate your account, verify your email address by clicking the link sent to your inbox.
Once verified, you’ll be taken to the Infura dashboard where you can create projects, view analytics, select add-ons, or raise support requests.
Infura supports the following projects, based on the networks:
Network | Description |
|---|---|
Web3 API | Access Ethereum, Layer 2, and non-EVM Layer 1 APIs. |
IPFS | Access distributed, peer-to-peer storage APIs. |
Filecoin | Access Filecoin APIs (persistent storage build on IPFS). |
You must create an API key to authenticate your requests for your project. Click CREATE NEW KEY.
From the pop-up, select the network and provide a name, then click CREATE.
Your new project page has all the information you need to connect to the network.
Use the available endpoints to send API requests.
Web3 network endpoints
Configure security settings in the SECURITY tab. This is optional.
The SECURITY tab is only available for Web3 and IPFS projects.
Use an allowlist to prevent unwanted access to your project.
Interact with the project by sending requests. The following examples interact with the Ethereum network by sending requests using HTTP.
All requests are
POST requests.Use a tool such as the Client Uniform Resource Locator (curl) or Postman to make requests. We recommend using Postman if you're a Windows user.
Replace
YOUR-API-KEY with your own unique project API key.Retrieve the current block number.
curl
Postman
curl https://mainnet.infura.io/v3/YOUR-API-KEY \
-X POST \
-H "Content-Type: application/json" \
--data '{"jsonrpc": "2.0", "id": 1, "method": "eth_blockNumber", "params": []}'
URL: https://mainnet.infura.io/v3/YOUR-API-KEY
Request_Type: POST
Body:
{
"jsonrpc":"2.0",
"method":"eth_blockNumber",
"params":[],
"id":1
}
You'll receive a response similar to:
{"jsonrpc":"2.0","id":1,"result":"0xde5fba"}
The data returned is in hexadecimal, prefixed with
0x. If you convert de5fba to decimal, the resulting number is 14573498, representing the current block number at the time the query was made.Check the balance of an Ethereum smart contract.
The example code checks the latest balance of the Ethereum Proof of Stake (PoS) contract.
curl
Postman
curl https://mainnet.infura.io/v3/API-KEY \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_getBalance","params": ["0x00000000219ab540356cBB839Cbe05303d7705Fa", "latest"],"id":1}'
URL: https://mainnet.infura.io/v3/YOUR-PROJECT-ID
Request_Type: POST
Body:
{
"jsonrpc":"2.0",
"method":"eth_getBalance",
"params": [
"0x00000000219ab540356cBB839Cbe05303d7705Fa",
"latest"
],
"id":1
}
You'll receive a result similar to:
{"jsonrpc":"2.0","id":1,"result":"0x96c8e932f1e499c855045"}
This result is the hexadecimal value of the contract in Wei (the smallest denomination of Ether).
The decimal conversion of the result is
11392978000069000000000069 Wei, which equals 11392978.000069000000000069 Ether. The Infura dashboard shows performance and API usage data such as methods called, bandwidth usage, and most active usage times.
Infura stats
You can find additional settings in Profile Settings to manage your account. You can set notifications for daily limits in the Accounts tab. You can update your usage limits and network add-ons in the Manage Plan tab. You can manage shared projects in the Project Sharing tab.
Last modified 9d ago