For the full documentation of available parameters and descriptions, please visit the official BNB JSON-RPC docs.
For compatibility with Parity, please prefix all hex strings with " 0x ".
eth_blockNumber
Returns the number of most recent block
https://api-opbnb.bscscan.com/api
?module=proxy
&action=eth_blockNumber
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Sample response
{
"jsonrpc":"2.0",
"id":83,
"result":"0x87a05a"
}
eth_getBlockByNumber
Returns information about a block by block number.
https://api-opbnb.bscscan.com/api
?module=proxy
&action=eth_getBlockByNumber
&tag=0x10d4f
&boolean=true
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the block number, in hex eg. 0xC36B3C
the boolean value to show full transaction objects.
when true, returns full transaction objects and their information, when false only returns a list of transactions.
Sample response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"baseFeePerGas": "0x8",
"difficulty": "0x0",
"extraData": "0x",
"gasLimit": "0x5f5e100",
"gasUsed": "0xb741",
"hash": "0x5c21788289f1a6c7ed45fb39123cce2a0ada0bdd07a706f782cb7151c3bf9933",
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"miner": "0x4200000000000000000000000000000000000011",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"nonce": "0x0000000000000000",
"number": "0x10d4f",
"parentHash": "0x0350db613563d132a6e36833540e4c05443d0063b8be877cb7fe019f83f0564a",
"receiptsRoot": "0x3f71ebd8822765e8146170b0f930f55f753dbb867f55e4e605894016cd32f1e2",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"size": "0x365",
"stateRoot": "0x73bf95fdae388455940e2da9077fe7d6a1546d73dd9dfd1b5edaf48ec97e57b3",
"timestamp": "0x64d72a4a",
"totalDifficulty": "0x0",
"transactions": [
{
"blockHash": "0x5c21788289f1a6c7ed45fb39123cce2a0ada0bdd07a706f782cb7151c3bf9933",
"blockNumber": "0x10d4f",
"from": "0xdeaddeaddeaddeaddeaddeaddeaddeaddead0001",
"gas": "0xf4240",
"gasPrice": "0x0",
"hash": "0x8b614dd87d222d30cc90d268534243fad3144a68a944e7d4430e06bb3912d8dd",
"input": "0x015d8eb90000000000000000000000000000000000000000000000000000000001d5af4c0000000000000000000000000000000000000000000000000000000064d72a1600000000000000000000000000000000000000000000000000000000cabf2e61202b6e493993c9f26027b605debba3aa2b678fb6b4d1decdf0f34ddb984e08690000000000000000000000000000000000000000000000000000000000000004000000000000000000000000ef8783382ef80ec23b66c43575a6103deca909c3000000000000000000000000000000000000000000000000000000000000083400000000000000000000000000000000000000000000000000000000000f4240",
"nonce": "0x10d4e",
"to": "0x4200000000000000000000000000000000000015",
"transactionIndex": "0x0",
"value": "0x0",
"type": "0x7e",
"v": "0x0",
"r": "0x0",
"s": "0x0",
"sourceHash": "0xc7c6af6707c768f3acf595872908401f325abede72768e96839c2d49f270b010",
"mint": "0x0"
}
],
"transactionsRoot": "0xa9d77cd4cd9b7561247d73d8871310deff06a2a952984307f7cf9640234f3cbf",
"uncles": []
}
}
eth_getBlockTransactionCountByNumber
Returns the number of transactions in a block.
https://api-opbnb.bscscan.com/api
?module=proxy
&action=eth_getBlockTransactionCountByNumber
&tag=0x10FB78
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the block number, in hex eg. 0x10FB78
Sample response
{
"jsonrpc":"2.0",
"id":1,
"result":"0x1"
}
eth_getTransactionByHash
Returns the information about a transaction requested by transaction hash.
https://api-opbnb.bscscan.com/api
?module=proxy
&action=eth_getTransactionByHash
&txhash=0x83f2e96f85dda79bde184adb5fb16fee208c39c28d36b067b5492ce7417aa4ed
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the string representing the hash of the transaction
Sample Response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0x40037c75d3c28ab5e59f15db9f6112f29f82a25cf240c742634914ee2320a7d6",
"blockNumber": "0x8706e3",
"from": "0x461db62a9f6e2fd38421f70bcab178b7fa521191",
"gas": "0x346e9",
"gasPrice": "0x2718",
"maxFeePerGas": "0x2728",
"maxPriorityFeePerGas": "0x2710",
"hash": "0x83f2e96f85dda79bde184adb5fb16fee208c39c28d36b067b5492ce7417aa4ed",
"input": "0xf305d719000000000000000000000000196ad5a70279fc112db4f8baf6f5022c9b1cf0a500000000000000000000000000000000000000000000071be4b5eef606d8de5700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000461db62a9f6e2fd38421f70bcab178b7fa52119100000000000000000000000000000000000000000000000000000000655d2880",
"nonce": "0xc",
"to": "0xc4f975d858056912131f89567a949c30495e2972",
"transactionIndex": "0x6",
"value": "0xd40b6b2c9494000",
"type": "0x2",
"accessList": [],
"chainId": "0xcc",
"v": "0x0",
"r": "0x6b417a55f41d662510723c2de687f5c003c591e107d77e29bcb71c5409f23f64",
"s": "0x5c5ec7d15c45183fd5dfc2ebfc72812cf80b1990a79c1b8a3f8f2d9b90e0650a"
}
}
eth_getTransactionByBlockNumberAndIndex
Returns information about a transaction by block number and transaction index position.
https://api-opbnb.bscscan.com/api
?module=proxy
&action=eth_getTransactionByBlockNumberAndIndex
&tag=0x10FB78
&index=0x0
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the block number, in hex eg. 0x10FB78
the position of the uncle's index in the block, in hex eg. 0x0
Sample Response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0xcbf6eb91d0b8c0315efd25e025f8ddad6396b0a47c002f245d5069e68f19d908",
"blockNumber": "0x10fb78",
"from": "0xdeaddeaddeaddeaddeaddeaddeaddeaddead0001",
"gas": "0xf4240",
"gasPrice": "0x0",
"hash": "0xa2da08d907f0d0d4496d51be5454c3a9e82fb76aadc17f537fbb97e0a381248c",
"input": "0x015d8eb90000000000000000000000000000000000000000000000000000000001daf9ec0000000000000000000000000000000000000000000000000000000064e71841000000000000000000000000000000000000000000000000000000008a7c50153900974efbb88191075dc916a005eef18deee721b2b14807957a178a7a4e5aff0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000ef8783382ef80ec23b66c43575a6103deca909c3000000000000000000000000000000000000000000000000000000000000083400000000000000000000000000000000000000000000000000000000000f4240",
"nonce": "0x10fb77",
"to": "0x4200000000000000000000000000000000000015",
"transactionIndex": "0x0",
"value": "0x0",
"type": "0x7e",
"v": "0x0",
"r": "0x0",
"s": "0x0",
"sourceHash": "0xfb3b9b7a7924c6ffefec1a241b5d593d9305ae2638dddf88025b3f83b8323e4a",
"mint": "0x0"
}
}
eth_getTransactionCount
Returns the number of transactions performed by an address.
https://api-opbnb.bscscan.com/api
?module=proxy
&action=eth_getTransactionCount
&address=0x966c8BB0f00A59f1150e39bdd1deb6B399fcECb1
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the string representing the address to get transaction count
the string pre-defined block parameter, either earliest, pending or latest
Sample Response
{
"jsonrpc":"2.0",
"id":1,
"result":"0x36"
}
eth_sendRawTransaction
Submits a pre-signed transaction for broadcast to the BNB network.
https://api-opbnb.bscscan.com/api
?module=proxy
&action=eth_sendRawTransaction
&hex=0xb6f9de950000000000000000000000000000000000000000000060e4a7c84b0a882100000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000d5b12178161244cd1ac9ee4857b53f0b6e7c5a46000000000000000000000000000000000000000000000000000000277bd8ac6400000000000000000000000000000000000000000000000000000000000000020000000000000000000000004200000000000000000000000000000000000006000000000000000000000000196ad5a70279fc112db4f8baf6f5022c9b1cf0a5
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the string representing the signed raw transaction data to broadcast.
💡 Tip: Send a POST request if your hex string is particularly long.
🖋️ For more information on creating a signed raw transaction, visit this page.
Sample Response
{
"id":1,
"jsonrpc": "2.0",
"result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}
⛏️ Note: The result represents the transaction hash of the submitted raw transaction.
Use eth_getTransactionReceipt to retrieve full details.
eth_getTransactionReceipt
Returns the receipt of a transaction by transaction hash.
https://api-opbnb.bscscan.com/api
?module=proxy
&action=eth_getTransactionReceipt
&txhash=0xd193fe81e3fac69b6e4a42c373782e6e0e2cc6da7524acfe3328d06d90c0d7b9
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the string representing the hash of the transaction
Sample Response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"blockHash": "0xc745cd1340be23e379f20f4cf8444e52f4571aa8a6c1b05e33d91b681a6434fa",
"blockNumber": "0x5ad400",
"contractAddress": null,
"cumulativeGasUsed": "0x6bc7d",
"effectiveGasPrice": "0x2718",
"from": "0x1f574b62c93497185d6ad90be4f1ee2c4a348ee7",
"gasUsed": "0x28ef0",
"l1Fee": "0x1478ad4f2ce0",
"l1FeeScalar": "1",
"l1GasPrice": "0xf787b6a8",
"l1GasUsed": "0x152c",
"logs": [
{
"address": "0x8be663ecd492b956fa0d7c054d77a97695b7ec48",
"topics": [
"0xc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62",
"0x000000000000000000000000cf42ac2207e0daa36a3cd87d23f56cc1dc24bace",
"0x0000000000000000000000001f574b62c93497185d6ad90be4f1ee2c4a348ee7",
"0x000000000000000000000000cf42ac2207e0daa36a3cd87d23f56cc1dc24bace"
],
"data": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001",
"blockNumber": "0x5ad400",
"transactionHash": "0xd193fe81e3fac69b6e4a42c373782e6e0e2cc6da7524acfe3328d06d90c0d7b9",
"transactionIndex": "0x3",
"blockHash": "0xc745cd1340be23e379f20f4cf8444e52f4571aa8a6c1b05e33d91b681a6434fa",
"logIndex": "0x5",
"removed": false
},
{
"address": "0x07e57ce31045f284773cd1d20328d238c1f868bd",
"topics": [
"0x9027756f10fb7f0e1221e193e4d606f166e47b4c9805d4bccd23f113d7d3bafd"
],
"data": "0x619207f47fafdad529e1b5e7510c208c871756070eab64f11f383fba674d7ff6000000000000000000000000cf42ac2207e0daa36a3cd87d23f56cc1dc24bace",
"blockNumber": "0x5ad400",
"transactionHash": "0xd193fe81e3fac69b6e4a42c373782e6e0e2cc6da7524acfe3328d06d90c0d7b9",
"transactionIndex": "0x3",
"blockHash": "0xc745cd1340be23e379f20f4cf8444e52f4571aa8a6c1b05e33d91b681a6434fa",
"logIndex": "0x6",
"removed": false
},
{
"address": "0xcf42ac2207e0daa36a3cd87d23f56cc1dc24bace",
"topics": [
"0x2fa3299839422fce25eaba11e9ae23923abcbb02aae4abfca2ca4e61aa823d18",
"0x000000000000000000000000000000000000000000000000000000000001faf0"
],
"data": "0x0000000000000000000000001f574b62c93497185d6ad90be4f1ee2c4a348ee70000000000000000000000008be663ecd492b956fa0d7c054d77a97695b7ec480000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000001619207f47fafdad529e1b5e7510c208c871756070eab64f11f383fba674d7ff6",
"blockNumber": "0x5ad400",
"transactionHash": "0xd193fe81e3fac69b6e4a42c373782e6e0e2cc6da7524acfe3328d06d90c0d7b9",
"transactionIndex": "0x3",
"blockHash": "0xc745cd1340be23e379f20f4cf8444e52f4571aa8a6c1b05e33d91b681a6434fa",
"logIndex": "0x7",
"removed": false
}
],
"logsBloom": "0x00002000000000000000000000000000004000000000000002000000000000000000000000000000000000000000000000000100000000000000004000002000000000000000000000040000000000400000000000010000000000000000000000000000000020000000004000000000001000000000000001000040000000000000800000002000000000000000200000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000001000000000400000000000000000000000000000008000000000000000400000000000000000400000000000000000000800000000000000400080000004000",
"status": "0x1",
"to": "0xcf42ac2207e0daa36a3cd87d23f56cc1dc24bace",
"transactionHash": "0xd193fe81e3fac69b6e4a42c373782e6e0e2cc6da7524acfe3328d06d90c0d7b9",
"transactionIndex": "0x3",
"type": "0x2"
}
}
eth_call
Executes a new message call immediately without creating a transaction on the block chain.
https://api-opbnb.bscscan.com/api
?module=proxy
&action=eth_call
&to=0xc4f975d858056912131f89567a949c30495e2972
&data=0x
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the string representing the address to interact with
the hash of the method signature and encoded parameters
the string pre-defined block parameter, either earliest, pending or latest
⛽ Note: The gas parameter is capped at 2x the current block gas limit.
Sample Response
{
"jsonrpc":"2.0",
"id":1,
"result":"0x00000000000000000000000000000000000000000000000000601d8888141c00"
}
eth_getCode
Returns code at a given address.
https://api-opbnb.bscscan.com/api
?module=proxy
&action=eth_getCode
&address=0xa02d433868c7ad58c8a2a820d6c3ff8a15536acc
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the string representing the address to get code
the string pre-defined block parameter, either earliest, pending or latest
Sample Response
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x60806040526004361061004e5760003560e01c80633659cfe6146100655780634f1ef286146100855780635c60da1b146100985780638f283970146100c9578063f851a440146100e95761005d565b3661005d5761005b6100fe565b005b61005b6100fe565b34801561007157600080fd5b5061005b6100803660046106ca565b610118565b61005b6100933660046106e5565b61015f565b3480156100a457600080fd5b506100ad6101d0565b6040516001600160a01b03909116815260200160405180910390f35b3480156100d557600080fd5b5061005b6100e43660046106ca565b61020b565b3480156100f557600080fd5b506100ad610235565b610106610292565b610116610111610331565b61033b565b565b61012061035f565b6001600160a01b0316336001600160a01b031614156101575761015481604051806020016040528060008152506000610392565b50565b6101546100fe565b61016761035f565b6001600160a01b0316336001600160a01b031614156101c8576101c38383838080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525060019250610392915050565b505050565b6101c36100fe565b60006101da61035f565b6001600160a01b0316336001600160a01b03161415610200576101fb610331565b905090565b6102086100fe565b90565b61021361035f565b6001600160a01b0316336001600160a01b0316141561015757610154816103f1565b600061023f61035f565b6001600160a01b0316336001600160a01b03161415610200576101fb61035f565b606061028583836040518060600160405280602781526020016107e460279139610445565b9392505050565b3b151590565b61029a61035f565b6001600160a01b0316336001600160a01b031614156101165760405162461bcd60e51b815260206004820152604260248201527f5472616e73706172656e745570677261646561626c6550726f78793a2061646d60448201527f696e2063616e6e6f742066616c6c6261636b20746f2070726f78792074617267606482015261195d60f21b608482015260a4015b60405180910390fd5b60006101fb610519565b3660008037600080366000845af43d6000803e80801561035a573d6000f35b3d6000fd5b60007fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61035b546001600160a01b0316919050565b61039b83610541565b6040516001600160a01b038416907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a26000825111806103dc5750805b156101c3576103eb8383610260565b50505050565b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f61041a61035f565b604080516001600160a01b03928316815291841660208301520160405180910390a1610154816105e9565b6060833b6104a45760405162461bcd60e51b815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f6044820152651b9d1c9858dd60d21b6064820152608401610328565b600080856001600160a01b0316856040516104bf9190610794565b600060405180830381855af49150503d80600081146104fa576040519150601f19603f3d011682016040523d82523d6000602084013e6104ff565b606091505b509150915061050f828286610675565b9695505050505050565b60007f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc610383565b803b6105a55760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b6064820152608401610328565b807f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc5b80546001600160a01b0319166001600160a01b039290921691909117905550565b6001600160a01b03811661064e5760405162461bcd60e51b815260206004820152602660248201527f455243313936373a206e65772061646d696e20697320746865207a65726f206160448201526564647265737360d01b6064820152608401610328565b807fb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d61036105c8565b60608315610684575081610285565b8251156106945782518084602001fd5b8160405162461bcd60e51b815260040161032891906107b0565b80356001600160a01b03811681146106c557600080fd5b919050565b6000602082840312156106dc57600080fd5b610285826106ae565b6000806000604084860312156106fa57600080fd5b610703846106ae565b9250602084013567ffffffffffffffff8082111561072057600080fd5b818601915086601f83011261073457600080fd5b81358181111561074357600080fd5b87602082850101111561075557600080fd5b6020830194508093505050509250925092565b60005b8381101561078357818101518382015260200161076b565b838111156103eb5750506000910152565b600082516107a6818460208701610768565b9190910192915050565b60208152600082518060208401526107cf816040850160208701610768565b601f01601f1916919091016040019291505056fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a26469706673582212204675187caf3a43285d9a2c1844a981e977bd52a85ff073e7fc649f73847d70a464736f6c63430008090033"
}
eth_getStorageAt
Returns the value from a storage position at a given address.
This endpoint is still experimental and may have potential issues
https://api-opbnb.bscscan.com/api
?module=proxy
&action=eth_getStorageAt
&address=0xa02d433868c7ad58c8a2a820d6c3ff8a15536acc
&position=0x0
&tag=latest
&apikey=YourApiKeyToken
Try this endpoint in your browser
Query Parameters
the string representing the address to get code
the hex code of the position in storage, eg 0x0
the string pre-defined block parameter, either earliest, pending or latest
Sample Response
{
"jsonrpc":"2.0",
"id":1,
"result":"0x000000000000000000001d568fc08a1d3978985bc3e896a22abd1222abcf0001"
}
eth_gasPrice
Returns the current price per gas in wei.
https://api-opbnb.bscscan.com/api
?module=proxy
&action=eth_gasPrice
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Sample Response
{
"jsonrpc":"2.0",
"id":73,
"result":"0x430e23400"
}
📖 Tip: The result is returned in wei.
Easily convert BNB units using our unit converter.
eth_estimateGas
Makes a call or transaction, which won't be added to the blockchain and returns the used gas.
https://api-opbnb.bscscan.com/api
?module=proxy
&action=eth_estimateGas
&data=0x4e71d92d
&to=0xf0160428a8552ac9bb7e050d90eeade4ddd52843
&value=0xff22
&gasPrice=0x51da038cc
&gas=0x5f5e0ff
&apikey=YourApiKeyToken
Try this endpoint in your browser 🔗
Query Parameters
the hash of the method signature and encoded parameters
the string representing the address to interact with
the value sent in this transaction, in hex eg. 0xff22
the amount of gas provided for the transaction, in hex eg. 0x5f5e0ff
the gas price paid for each unit of gas, in wei
post EIP-1559, the gasPrice has to be higher than the block's baseFeePerGas
⛽ Note: The gas parameter is capped at 2x the current block gas limit.
Sample Response
{
"jsonrpc":"2.0",
"id":1,
"result":"0x5248"
}
