For AI agents: a documentation index is available at /llms.txt. A markdown version of this page is available at the same URL with .md appended (or via Accept: text/markdown).
Skip to main content

BNB Smart Chain quickstart

This quickstart guide will help you set up and make calls on the BNB Smart Chain network using the Infura endpoints.

Prerequisites

  • Ensure you have an API key with the BNB Smart Chain network enabled.

Make calls

curl

Run the following command in your terminal. Replace <YOUR-API-KEY> with your actual Infura API key.

curl https://bsc-mainnet.infura.io/v3/<YOUR-API-KEY> \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "eth_blockNumber", "params": [], "id": 1}'

Node (JavaScript)

In these examples, you'll use npm as your package manager.

Node Fetch

  1. In your project folder, install the Node Fetch package using npm:

    npm i node-fetch
  2. Create your JavaScript file and copy the following code:

    Replace <YOUR-API-KEY> with your actual Infura API key.

    index.js
    import fetch from 'node-fetch'

    fetch('https://bsc-mainnet.infura.io/v3/<YOUR-API-KEY>', {
    method: 'POST',
    headers: {
    'Content-Type': 'application/json',
    },
    body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'eth_blockNumber',
    params: [],
    id: 1,
    }),
    })
    .then(response => response.json())
    .then(data => {
    console.log(data)
    })
    .catch(error => {
    console.error(error)
    })
  3. Run the code using the following command:

    node index.js

Axios

  1. In your project folder, install the Axios package using npm:

    npm i axios
  2. Create your JavaScript file and copy the following code:

    Replace <YOUR-API-KEY> with your actual Infura API key.

    index.js
    const axios = require('axios')

    axios
    .post('https://bsc-mainnet.infura.io/v3/<YOUR-API-KEY>', {
    jsonrpc: '2.0',
    method: 'eth_blockNumber',
    params: [],
    id: 1,
    })
    .then(response => {
    console.log(response.data)
    })
    .catch(error => {
    console.error(error)
    })
  3. Run the code using the following command:

    node index.js

Ethers

  1. In your project folder, install the ethers package using npm:

    npm install ethers
  2. Create your JavaScript file and copy the following code:

    Replace <YOUR-API-KEY> with your actual Infura API key.

    index.js
    const ethers = require('ethers')

    const provider = new ethers.providers.JsonRpcProvider(
    'https://bsc-mainnet.infura.io/v3/<YOUR-API-KEY>'
    )

    provider
    .getBlockNumber()
    .then(blockNumber => {
    console.log(blockNumber)
    })
    .catch(error => {
    console.error(error)
    })
  3. Run the code using the following command:

    node index.js

Python

  1. In your project folder, install the requests library:

    pip install requests
  2. Create your Python file and copy the following code:

    Replace <YOUR-API-KEY> with your actual Infura API key.

    index.py
    import requests
    import json

    url = "https://bsc-mainnet.infura.io/v3/<YOUR-API-KEY>"

    payload = {
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
    }

    headers = {"content-type": "application/json"}

    response = requests.post(url, data=json.dumps(payload), headers=headers).json()

    print(response)
  3. Run the code using the following command:

    python index.py

Next steps

Now that you have successfully made a call to the BNB Smart Chain network, you can explore more functionalities and APIs. Here are some suggestions:

  • Explore other BNB Smart Chain APIs: Infura supports a wide range of APIs. You can find more information in the JSON-RPC API method documentation.

  • Try out different networks: Infura supports multiple networks including Ethereum, Linea, Polygon, Optimism, and more.

  • Monitor your usage: Monitor your usage on the Infura dashboard to ensure you're not hitting your rate limits.

If you have questions or run into issues, contact Infura.