Basic Operations

This page collects the BNB Smart Chain calls developers reach for on day one: the latest block height, a BNB or BEP-20 balance, a transaction and its receipt, full blocks, a contract view function, and the gas price and nonce you need before sending. Each one is shown as a ready-to-run JSON-RPC payload you can POST to https://bsc.therpc.io/YOUR_API_KEY.

Retrieving Basic Information

Two reads anchor almost every BNB Smart Chain integration. eth_blockNumber returns the latest block height, a quick way to confirm the node is synced and live. eth_getBalance returns an account's holdings, but the value comes back in wei as a hex string; divide it by 10^18 to express it as BNB before showing it to a user.

Get Latest Block Number

1{
2  "jsonrpc": "2.0",
3  "method": "eth_blockNumber",
4  "params": [],
5  "id": 1
6}

Check Account Balance

1{
2  "jsonrpc": "2.0",
3  "method": "eth_getBalance",
4  "params": [
5    "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
6    "latest"
7  ],
8  "id": 1
9}

Transaction Operations

Two calls cover transaction lookups on BNB Smart Chain. eth_getTransactionByHash fetches a transaction by its hash and tells you whether it is still pending or already mined. eth_getTransactionReceipt returns the full receipt once it has been included. The receipt carries the block it landed in, the gas used, the success status, and any emitted logs such as BEP-20 Transfer events.

Get Transaction Status

1{
2  "jsonrpc": "2.0",
3  "method": "eth_getTransactionByHash",
4  "params": [
5    "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"
6  ],
7  "id": 1
8}

Check Transaction Receipt

1{
2  "jsonrpc": "2.0",
3  "method": "eth_getTransactionReceipt",
4  "params": [
5    "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"
6  ],
7  "id": 1
8}

Block Information

You can fetch a BNB Smart Chain block two ways. eth_getBlockByNumber takes a hex height (or a tag like latest), while eth_getBlockByHash takes the block's hash. Both accept a boolean second argument. Pass true to receive every transaction as a full object, or false to get back only the transaction hashes and keep the response light.

Get Block by Number

1{
2  "jsonrpc": "2.0",
3  "method": "eth_getBlockByNumber",
4  "params": [
5    "0xE81224",
6    false
7  ],
8  "id": 1
9}

Get Block by Hash

1{
2  "jsonrpc": "2.0",
3  "method": "eth_getBlockByHash",
4  "params": [
5    "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
6    false
7  ],
8  "id": 1
9}

Smart Contract Interactions

Two methods read contracts without spending gas. eth_call executes a view function locally against the current state (for example calling balanceOf on a BEP-20 token or quoting a price from a PancakeSwap pair) and returns the ABI-encoded result. eth_getCode returns the deployed bytecode at an address, which lets you confirm a contract exists there rather than a plain wallet.

Call Contract Method

1{
2  "jsonrpc": "2.0",
3  "method": "eth_call",
4  "params": [
5    {
6      "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
7      "data": "0x70a08231000000000000000000000000742d35Cc6634C0532925a3b844Bc454e4438f44e"
8    },
9    "latest"
10  ],
11  "id": 1
12}

Get Contract Code

1{
2  "jsonrpc": "2.0",
3  "method": "eth_getCode",
4  "params": [
5    "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
6    "latest"
7  ],
8  "id": 1
9}

Network Status

Two calls report on the network itself. net_version returns the chain ID as a string, 56 for BNB Smart Chain mainnet, which is handy for asserting your client is pointed at the right network. eth_syncing reports whether the backing node is still catching up, returning false when it is fully synced or a progress object while it is not.

Get Network Version

1{
2  "jsonrpc": "2.0",
3  "method": "net_version",
4  "params": [],
5  "id": 1
6}

Check Node Sync Status

1{
2  "jsonrpc": "2.0",
3  "method": "eth_syncing",
4  "params": [],
5  "id": 1
6}

Gas and Nonce

Before broadcasting a BNB Smart Chain transaction you need two values. eth_gasPrice returns the current price in wei, which on BNB Smart Chain stays low thanks to the chain's economics. eth_getTransactionCount returns an address's nonce, the count of transactions it has already sent. That nonce is what orders outgoing transactions, so each new send must use the next value to avoid being rejected or stuck.

Get Gas Price

1{
2  "jsonrpc": "2.0",
3  "method": "eth_gasPrice",
4  "params": [],
5  "id": 1
6}

Get Transaction Count (Nonce)

1{
2  "jsonrpc": "2.0",
3  "method": "eth_getTransactionCount",
4  "params": [
5    "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
6    "latest"
7  ],
8  "id": 1
9}

Implementation Examples

JavaScript / TypeScript: run these operations with web3.js or ethers.js.
Python: call the same BNB Smart Chain methods through web3.py.
Java / Kotlin: use web3j for JVM-based integrations.
All SDKs: find every supported client in the Tools & SDKs reference.