BNB Smart Chain

• Block
  • postGetBlock
• Transaction
  • postGetPendingTransaction
  • postGetTransaction
  • postGetTransactionReceipt
  • postListInternalTransactions
  • postListLogs
  • postListPendingTransactions
  • postListTransactions

API docs by Redocly

Web3 Cloud API (1.0.0)

Download OpenAPI specification:Download

Block

GetBlock

Get block.

Authorizations:

(x-api-keyx-api-noncex-api-signature)

Request Body schema: application/json

block_number required

integer <int64> Block number.

Responses

https://web3-cloud-testnet-prd.gincoapis.com/gincoinc.web3cloud.bnbsc.node.gateway.v1.GatewayService/GetBlock

Request samples

• Payload

Content type

application/json

{

• "block_number": 17805285

}

Response samples

• 200
• 500

Content type

application/json

{

• "block": {

  • "block_hash": "0xd137257c3c304dede8e73c80a6427edca1aca956be353b3009f796bfe108fded",
  • "block_number": 17307171,
  • "difficulty": 0,
  • "extra_data": "0x496c6c756d696e61746520446d6f63726174697a6520447374726962757465",
  • "gas_limit": 30000000,
  • "gas_used": 3084672,
  • "logs_bloom": "0x807401c2001c10a0800040008083110004042a4021304a00088000495002810004ca044002202106914b006604c80398a30e0021010020c400004e8003245040000158440c20289836000008500080220c4340400284801408150a06842624400a0aa16482040248302830208420481000004854880972a091801010010a00c4101281c819a0240060048c902055013220210c210422902a24010160040080e4420d83540040984821002800c9230022220230880040000162b0400da0000810c41345ba00010841308840c9800a4100464414a00020013928421001000064808014200a60800405080008080491c010e02082c80010265080ea201011100240",
  • "miner": "0xe7cf7C3BA875Dd3884Ed6a9082d342cb4FBb1f1b",
  • "mix_hash": "0x17a1d12cdf74b92f9b87ca06cfbbbc2f3bc38827bd759c9d0cd9dff6cd6a6b90",
  • "nonce": "0x0",
  • "parent_hash": "0x4590fefe9d2dded34bff5f3f392e319d6b51ebf50b9e67ecebc602a118b9e0cf",
  • "receipts_root": "0x8efddd98967cf1dbcbcd1c0d3274bc5e48518a3962f32432e762cd602f1a15d5",
  • "sha3_uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
  • "size": 88734,
  • "state_root": "0xd01f87c077bf3546c65967f8d095cdd2c944b31df15de5bb03918b75063d2734",
  • "timestamp": 1674724908,
  • "transactions_root": "0x944a86a189cd8b2e89a6b48b750947d522b460854d6f2aa56f1adcb3466b44cc",
  • "uncles": [ ]

  }

}

Transaction

GetPendingTransaction

Get pending transaction.

Authorizations:

(x-api-keyx-api-noncex-api-signature)

Request Body schema: application/json

transaction_hash required

string Transaction hash.

Responses

https://web3-cloud-testnet-prd.gincoapis.com/gincoinc.web3cloud.bnbsc.node.gateway.v1.GatewayService/GetPendingTransaction

Request samples

• Payload

Content type

application/json

{

• "transaction_hash": "0xf8651e5eb8b873e70099cd421895b1e5ce6419b57f3c4c9216b0e22449b329c6"

}

Response samples

• 200
• 500

Content type

application/json

{

• "pending_transaction": {

  • "transaction_hash": "0xf8651e5eb8b873e70099cd421895b1e5ce6419b57f3c4c9216b0e22449b329c6",
  • "from": "0x20f4cbedb6dbea97fe6a54d4bccdc6aec712a49e",
  • "to": "0xffe7bfdfa7dc640e756815f9df9cf7cdc8d5c9f0",
  • "gas": 21000,
  • "gas_price": 20000000000,
  • "input": "0x",
  • "nonce": 1,
  • "value": "0x2386f26fc10000",
  • "r": "0x8ad7c88e8f6d6b7e22691f945fc44b3afccf9fbeb9675fe1bdb3380afad9d055",
  • "s": "0x203ff5d253bb711adab37d2d98c0a4b59c3baf938820226ef536f7b628d71524",
  • "v": "0x2d",
  • "record_time": "2019-08-24T14:15:22Z"

  }

}

GetTransaction

Get transaction.

Authorizations:

(x-api-keyx-api-noncex-api-signature)

Request Body schema: application/json

transaction_hash required

string Transaction hash.

Responses

https://web3-cloud-testnet-prd.gincoapis.com/gincoinc.web3cloud.bnbsc.node.gateway.v1.GatewayService/GetTransaction

Request samples

• Payload

Content type

application/json

{

• "transaction_hash": "0xf8651e5eb8b873e70099cd421895b1e5ce6419b57f3c4c9216b0e22449b329c6"

}

Response samples

• 200
• 500

Content type

application/json

{

• "transaction": {

  • "transaction_hash": "0xf8651e5eb8b873e70099cd421895b1e5ce6419b57f3c4c9216b0e22449b329c6",
  • "block_number": 8378339,
  • "block_hash": "0xa03bd7b66005e6735430622e2154f4bdda9f9a93891bd715231a024c6d3a39f8",
  • "from": "0x20f4cbedb6dbea97fe6a54d4bccdc6aec712a49e",
  • "to": "0xffe7bfdfa7dc640e756815f9df9cf7cdc8d5c9f0",
  • "gas": 21000,
  • "gas_price": 20000000000,
  • "input": "0x",
  • "nonce": 1,
  • "transaction_index": 0,
  • "value": "0x2386f26fc10000",
  • "r": "0x8ad7c88e8f6d6b7e22691f945fc44b3afccf9fbeb9675fe1bdb3380afad9d055",
  • "s": "0x203ff5d253bb711adab37d2d98c0a4b59c3baf938820226ef536f7b628d71524",
  • "v": "0x2d"

  }

}

GetTransactionReceipt

Get transaction receipt.

Authorizations:

(x-api-keyx-api-noncex-api-signature)

Request Body schema: application/json

transaction_hash required

string Transaction hash.

Responses

https://web3-cloud-testnet-prd.gincoapis.com/gincoinc.web3cloud.bnbsc.node.gateway.v1.GatewayService/GetTransactionReceipt

Request samples

• Payload

Content type

application/json

{

• "transaction_hash": "0xf8651e5eb8b873e70099cd421895b1e5ce6419b57f3c4c9216b0e22449b329c6"

}

Response samples

• 200
• 500

Content type

application/json

{

• "transaction_receipt": {

  • "transaction_hash": "0xf8651e5eb8b873e70099cd421895b1e5ce6419b57f3c4c9216b0e22449b329c6",
  • "block_number": 8378339,
  • "block_hash": "0xa03bd7b66005e6735430622e2154f4bdda9f9a93891bd715231a024c6d3a39f8",
  • "contract_address": "0xffe7bfdfa7dc640e756815f9df9cf7cdc8d5c9f0",
  • "cumulative_gas_used": 128270,
  • "from": "0x20f4cbedb6dbea97fe6a54d4bccdc6aec712a49e",
  • "to": "0xffe7bfdfa7dc640e756815f9df9cf7cdc8d5c9f0",
  • "gas_used": 128270,
  • "logs_bloom": "0x807401c2001c10a0800040008083110004042a4021304a00088000495002810004ca044002202106914b006604c80398a30e0021010020c400004e8003245040000158440c20289836000008500080220c4340400284801408150a06842624400a0aa16482040248302830208420481000004854880972a091801010010a00c4101281c819a0240060048c902055013220210c210422902a24010160040080e4420d83540040984821002800c9230022220230880040000162b0400da0000810c41345ba00010841308840c9800a4100464414a00020013928421001000064808014200a60800405080008080491c010e02082c80010265080ea201011100240",
  • "status": 1,
  • "transaction_index": 1

  }

}

ListInternalTransactions

List internal transactions.

Authorizations:

(x-api-keyx-api-noncex-api-signature)

Request Body schema: application/json

transaction_hash required

string Transaction hash.

Responses

https://web3-cloud-testnet-prd.gincoapis.com/gincoinc.web3cloud.bnbsc.node.gateway.v1.GatewayService/ListInternalTransactions

Request samples

• Payload

Content type

application/json

{

• "transaction_hash": "0xf8651e5eb8b873e70099cd421895b1e5ce6419b57f3c4c9216b0e22449b329c6"

}

Response samples

• 200
• 500

Content type

application/json

{

• "internal_transactions": [

  • {

    • "transaction_hash": "0xf8651e5eb8b873e70099cd421895b1e5ce6419b57f3c4c9216b0e22449b329c6",
    • "from": "0x20f4cbedb6dbea97fe6a54d4bccdc6aec712a49e",
    • "to": "0xffe7bfdfa7dc640e756815f9df9cf7cdc8d5c9f0",
    • "gas": 198334,
    • "gas_used": 128270,
    • "input": "0x0efe6a8b000000000000000000000000437452bf704d2d25981199dcb7b83e463a54ce9700000000000000000000000000000000000000000000000000000000009896800000000000000000000000000000000000000000000000000000000000000000",
    • "output": "0x",
    • "call_type": "call",
    • "trace_index": 0,
    • "value": "0",
    • "error": "execution reverted"

    }

  ]

}

ListLogs

List transaction logs.

Authorizations:

(x-api-keyx-api-noncex-api-signature)

Request Body schema: application/json

transaction_hash required

string Transaction hash.

Responses

https://web3-cloud-testnet-prd.gincoapis.com/gincoinc.web3cloud.bnbsc.node.gateway.v1.GatewayService/ListLogs

Request samples

• Payload

Content type

application/json

{

• "transaction_hash": "0xf8651e5eb8b873e70099cd421895b1e5ce6419b57f3c4c9216b0e22449b329c6"

}

Response samples

• 200
• 500

Content type

application/json

{

• "logs": [

  • {

    • "transaction_hash": "0xf8651e5eb8b873e70099cd421895b1e5ce6419b57f3c4c9216b0e22449b329c6",
    • "address": "0xee8392d5100a90b39023b29310c80a60a7f2d05d",
    • "data": "0x0000000000000000000000000000000000000000000000000000000000000168",
    • "topics": [

      • "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      • "0x0000000000000000000000000000000000000000000000000000000000000000",
      • "0x0000000000000000000000008c42a2b6c4f261e35f0398cad7e43918d9003e34"

      ],
    • "block_number": 8378339,
    • "block_hash": "0xa03bd7b66005e6735430622e2154f4bdda9f9a93891bd715231a024c6d3a39f8",
    • "transaction_index": 1,
    • "log_index": 0,
    • "removed": false

    }

  ]

}

ListPendingTransactions

List pending transactions.

Authorizations:

(x-api-keyx-api-noncex-api-signature)

Request Body schema: application/json

from required	string^0x[a-f0-9]{40}$ Sender address.
nonce	integer <int64> Sender nonce.

Responses

https://web3-cloud-testnet-prd.gincoapis.com/gincoinc.web3cloud.bnbsc.node.gateway.v1.GatewayService/ListPendingTransactions

Request samples

• Payload

Content type

application/json

{

• "from": "0xb88a7eee158b6f52094cce356f1c138cc3cc678e",
• "nonce": "536"

}

Response samples

• 200
• 500

Content type

application/json

{

• "pending_transactions": [

  • {

    • "transaction_hash": "0xf8651e5eb8b873e70099cd421895b1e5ce6419b57f3c4c9216b0e22449b329c6",
    • "from": "0x20f4cbedb6dbea97fe6a54d4bccdc6aec712a49e",
    • "to": "0xffe7bfdfa7dc640e756815f9df9cf7cdc8d5c9f0",
    • "gas": 21000,
    • "gas_price": 20000000000,
    • "input": "0x",
    • "nonce": 1,
    • "value": "0x2386f26fc10000",
    • "r": "0x8ad7c88e8f6d6b7e22691f945fc44b3afccf9fbeb9675fe1bdb3380afad9d055",
    • "s": "0x203ff5d253bb711adab37d2d98c0a4b59c3baf938820226ef536f7b628d71524",
    • "v": "0x2d",
    • "record_time": "2019-08-24T14:15:22Z"

    }

  ]

}

ListTransactions

List transactions.

Authorizations:

(x-api-keyx-api-noncex-api-signature)

Request Body schema: application/json

transaction_hashes

Array of strings Transaction hashes.

Responses

https://web3-cloud-testnet-prd.gincoapis.com/gincoinc.web3cloud.bnbsc.node.gateway.v1.GatewayService/ListTransactions

Request samples

• Payload

Content type

application/json

{

• "transaction_hashes": [

  • "0xf8651e5eb8b873e70099cd421895b1e5ce6419b57f3c4c9216b0e22449b329c6"

  ]

}

Response samples

• 200
• 500

Content type

application/json

{

• "transactions": [

  • {

    • "transaction_hash": "0xf8651e5eb8b873e70099cd421895b1e5ce6419b57f3c4c9216b0e22449b329c6",
    • "block_number": 8378339,
    • "block_hash": "0xa03bd7b66005e6735430622e2154f4bdda9f9a93891bd715231a024c6d3a39f8",
    • "from": "0x20f4cbedb6dbea97fe6a54d4bccdc6aec712a49e",
    • "to": "0xffe7bfdfa7dc640e756815f9df9cf7cdc8d5c9f0",
    • "gas": 21000,
    • "gas_price": 20000000000,
    • "input": "0x",
    • "nonce": 1,
    • "transaction_index": 0,
    • "value": "0x2386f26fc10000",
    • "r": "0x8ad7c88e8f6d6b7e22691f945fc44b3afccf9fbeb9675fe1bdb3380afad9d055",
    • "s": "0x203ff5d253bb711adab37d2d98c0a4b59c3baf938820226ef536f7b628d71524",
    • "v": "0x2d"

    }

  ]

}