Geth/Parity Proxy

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

Request

No parameters required.

Response

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

Request

Query Parameters

Response

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

Request

Query Parameters

Response

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

Request

Query Parameters

Response

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

Request

Query Parameters

Response

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

Request

Query Parameters

Response

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

Request

Query Parameters

Response

Sample Response

{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

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

Request

Query Parameters

Response

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

Request

Query Parameters

Response

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

Request

Query Parameters

Response

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

Request

Query Parameters

Response

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

Request

No parameters required.

Response

Sample Response

{
   "jsonrpc":"2.0",
   "id":73,
   "result":"0x430e23400"
}

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

Request

Query Parameters

Response

Sample Response

{
   "jsonrpc":"2.0",
   "id":1,
   "result":"0x5248"
}