Binance Smart Chain

/getbalance

Get the balance or number of the given token in the requested public address.

GET https://api.expand.network/chain/getbalance

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
blockNumber	String	Block number for which the balance needs to be retrieved. By default, it will pick the latest block number when not specified.
address*	String	The public address to get the balance of.
tokenAddress	String	The address of token to get the balance of.

Sample Request

https://api.expand.network/chain/getbalance?chainId=56&blockNumber=39314029&address=0x4C5dE1BF2d8e7D86E6473cCDDfC3c9C804983446&tokenAddress=0x3203c9E46cA618C8C1cE5dC67e7e9D75f5da2377

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "balance": "20052861140200948206"
    }
}

/getblock

Get details of a block.

GET https://historicallp.api.expand.network/chain/getblock

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
blockNumber	String	The block number or block hash.
startBlock	String	Starting block of the range. Note: Maximum supported range is 10, meaning the startBlock is determined by endBlock - 9.
endBlock	String	Last block of the range. Note: Maximum supported range is 10, meaning the endBlock is determined by startBlock + 9.

Sample Request

https://historicallp.api.expand.network/chain/getblock?chainId=56

Sample Response

{
  "status": 200,
  "msg": "success",
  "data": {
    "blocks": [
      {
        "difficulty": "2",
        "extraData": "0xd883010002846765746888676f312e31332e34856c696e7578000000000000000f0d5147246b972a70e3f2ac247f6daba4fafaaebfc65d0de82a63851ef92a1d634395b7d2a2ed5c7ffd82c0a41f7bb84156f4ff4d5b7a9a781fb38d4f65faab01",
        "gasLimit": 30000000,
        "gasUsed": 954239,
        "hash": "0xe53f0af352716cc2e7b0f7984f7061991b8fff7261e757c880775ff33ab3488e",
        "logsBloom": "0x08200000000280100004800088002410000000000404000008000000800000101000000000000004000000000400000008000000000000000000000000240400000000000100000204000008000000202010000400440000002c100484000000008000200202001001000800000008000000000000e10480004000100000000000400000000000000000000000008000004404010400000810000840000000000200000000000600180210000000000000000000000023000020000800200000010008220000280200000000000010000101000901000014001000020202e0000010000004000000091000020400002000000000400000400010000000400000",
        "miner": "0xa6f79B60359f141df90A0C745125B131cAAfFD12",
        "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
        "nonce": "0x0000000000000000",
        "number": 1900010,
        "parentHash": "0x9e0b768bf0ba90d9ffff5c15d99b4d6419e9698917674092b5b4e37595d44399",
        "receiptsRoot": "0x163db304696466aa9063e876bb0471a807a6bab90e989e0d517449a8ec5b0bf0",
        "size": 2385,
        "timestamp": 1604372524,
        "totalDifficulty": "3799498",
        "transactions": [
          {
            "chainId": "56",
            "hash": "0xc3d940b3d7b45d6f7977027cb47dbbd05d78cd7c92920ce64fda087790aeade5",
            "transactionStatus": true,
            "blockNumber": "1900010",
            "timestamp": null,
            "from": "0x929648fA0dFC3637d55226CE5e3F75cae1566fCE",
            "to": "0x7aE6E8DDc28D504984CC55180267c375692E381B",
            "value": "188703802094966348",
            "transactionFees": "546000000000000",
            "gas": "21000",
            "gasPrice": "26000000000",
            "input": "0x",
            "nonce": 80,
            "type": null,
            "network": null,
            "v": "0x93",
            "r": "0x768c5454feba7a3dea20106ca4ff4c04731d960bcaf54d8749d3ba1531e01c7b",
            "s": "0x71389db7fc650415eb398aa32fd0998814315254d7a5e753913dd91e18db9db3",
            "yParity": null,
            "transactionIndex": null,
            "accessList": null,
            "maxFeePerGas": null,
            "maxPriorityFeePerGas": null,
            "logs": [
              {
                "address": "0x72dCf845AE36401e82e681B0E063d0703bAC0Bba",
                "topics": [
                  "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                  "0x00000000000000000000000025b827ffc01d92e191905eb70bb1efbfa90320ed",
                  "0x000000000000000000000000c66a3153c63d94d49714ff1bdf15d76081cd5581"
                ],
                "data": "0x00000000000000000000000000000000000000000000000d31c714616069f380",
                "blockNumber": 38800735,
                "transactionHash": "0x2edca61f6423a0445edbe8b4b23875dbf04e100cd3e6e525d50261f203f2a959",
                "transactionIndex": 1,
                "blockHash": "0xeddf553948d9e673bf912c2381db68c1bc7730c161c7edf8c0849fc5b05b5f38",
                "logIndex": 0,
                "removed": false,
                "id": "log_31cb7e18"
              }
            ]
          }
        ],
        "transactionsRoot": "0xf096034684f149dcf71c676d12885a55fec3a95294589db39785285f1caecdee",
        "uncles": []
      }
    ]
  }
}

/getgasprice

Get the current gas price from the network.

GET https://api.expand.network/chain/getgasprice

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.

Sample Request

https://api.expand.network/chain/getgasprice?chainId=56

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "gasPrice": "5000000000"
    }
}

/getstorage

Get data stored in the given slot.

GET https://api.expand.network/chain/getstorage

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
address*	String	Contract address whose storage is needed.
index	String	Slot index on the smart contract. By default, it is taken as 0.

Sample Request

https://api.expand.network/chain/getstorage?chainId=56&address=0xb22069baEf86655460F56CD73d7EC999B5DA6B73

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "data": "0x0000000000000000000000004373275b113f2e45cb45ae9eab1e6d3ef1ca185c"
    }
}

/gettransaction

Get details of a transaction.

GET https://api.expand.network/chain/gettransaction

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
transactionHash*	String	The transaction hash.

Sample Request

https://api.expand.network/chain/gettransaction?chainId=56&transactionHash=0x5834a0ef28b7f58044d183e2ceb140365c5e5329d6364ca8f5ad8d29d7838715

Sample Response

{
  "status": 200,
  "msg": "success",
  "data": {
    "chainId": "56",
    "hash": "0x5834a0ef28b7f58044d183e2ceb140365c5e5329d6364ca8f5ad8d29d7838715",
    "transactionStatus": true,
    "blockNumber": "30265849",
    "timestamp": null,
    "from": "0xca2e63aaC05F6aFFdb6beC468fa2258003c8A450",
    "to": "0x55d398326f99059fF775485246999027B3197955",
    "value": "0",
    "transactionFees": "23200100000000",
    "gas": "65000",
    "gasPrice": "1100000000",
    "input": "0xa9059cbb000000000000000000000000b8c1c3c3a17123b0df178bb2005a2949391bdb3c000000000000000000000000000000000000000000000000000246fc714d1000",
    "nonce": 10,
    "type": null,
    "network": null,
    "v": "0x93",
    "r": "0x3a07d5ae42015756122c3033caae1029292c1bf651763455213d2b82e133ac67",
    "s": "0x50444f7eede576535e3b23dd500a84690f174797216404ed05944feaf165538a",
    "yParity": null,
    "transactionIndex": 139,
    "accessList": null,
    "maxFeePerGas": null,
    "maxPriorityFeePerGas": null,
    "logs": [
      {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          "0x000000000000000000000000ca2e63aac05f6affdb6bec468fa2258003c8a450",
          "0x000000000000000000000000b8c1c3c3a17123b0df178bb2005a2949391bdb3c"
        ],
        "data": "0x000000000000000000000000000000000000000000000000000246fc714d1000",
        "blockNumber": 30265849,
        "transactionHash": "0x5834a0ef28b7f58044d183e2ceb140365c5e5329d6364ca8f5ad8d29d7838715",
        "transactionIndex": 139,
        "blockHash": "0xb4b573a409d29d6d715cd6e51c7161701766badd1bbc956afbe67f6217034bdc",
        "logIndex": 378,
        "removed": false,
        "id": "log_312fdee5"
      }
    ]
  }
}

/portfolio

Get detailed information about the verified assets or tokens currently associated with a user's wallet address.

GET https://api.expand.network/chain/portfolio

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
address*	String	Public addess of the user.
tokens	String	Comma-separated value of ERC-20 tokens to get value of. Maximum 10 at a time.
availableOnly	Boolean	By default, false. If true, tokens with balance > 0 will be listed.
pageToken	String	Present at the end of a lengthy response to fetch the next page.
assetType	String	fungible/nonFungible standard choice. By default, all.

Sample Request

https://api.expand.network/chain/portfolio?chainId=56&address=0x9ef9f4360c606c7AB4db26b016007d3ad0aB86a0&availableOnly=true

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "native": "100000000000000000",
        "evmTokens": [
            {
                "name": "Pelican Trust (Save The Pelicans)",
                "symbol": "PTRST",
                "decimals": "9",
                "address": "0x2a3a5011d4a43e3966ac061762d476bcb54289c2",
                "balance": "1000000015646852",
                "assetType": "ERC20",
                "USDPrice": "566.4003103654223"
            },
            {
                "name": "AI Avail",
                "symbol": "AI-A",
                "decimals": "6",
                "address": "0xd048b4c23af828e5be412505a51a8dd7b37782dd",
                "balance": "23000000000",
                "assetType": "ERC20",
                "USDPrice": "0.7034536653118537"
            },
            {
                "name": "eCash",
                "symbol": "XEC",
                "decimals": "6",
                "address": "0x5f7a1a4dafd0718caee1184caa4862543f75edb1",
                "balance": "29000000000000",
                "assetType": "ERC20",
                "USDPrice": "0.000061525764023246"
            },
            {
                "name": "Minereum BSC",
                "symbol": "MNEB",
                "decimals": "8",
                "address": "0xd22202d23fe7de9e3dbe11a2a88f42f4cb9507cf",
                "balance": "15000000000000",
                "assetType": "ERC20",
                "USDPrice": "0.002957114417754845"
            },
            {
                "name": "Volt Token",
                "symbol": "VLT",
                "decimals": "9",
                "address": "0x3f413df715251814d2ce25dcf74c8e94f3b40b67",
                "balance": "2188732955437000000000",
                "assetType": "ERC20",
                "USDPrice": "9.97635e-13"
            },
            {
                "name": "RGDC Token",
                "symbol": "RGDC",
                "decimals": "18",
                "address": "0x64434605adac8f5441029133fd12c4289fc8b4a8",
                "balance": "1000000000000000000",
                "assetType": "ERC20",
                "USDPrice": "0.03271055525971668"
            },
            {
                "name": "superspreader.info",
                "symbol": "SPRD",
                "decimals": "18",
                "address": "0xd4e4d228eafb1ca8897c7e9cc9992fe3a0b8693c",
                "balance": "8802832521443043712",
                "assetType": "ERC20",
                "USDPrice": "0.000008618710042535"
            },
            {
                "name": "AIR",
                "symbol": "AIR",
                "decimals": "18",
                "address": "0xd8a2ae43fd061d24acd538e3866ffc2c05151b53",
                "balance": "10000000000000000000000",
                "assetType": "ERC20",
                "USDPrice": "7.5981e-14"
            },
            {
                "name": "BLESS",
                "symbol": "GOD",
                "decimals": "0",
                "address": "0x81a7571fabb0e1e3a6a2d815f054d503dc649f42",
                "balance": "255",
                "assetType": "ERC20",
                "USDPrice": null
            },
            {
                "name": "My Get Rich Token",
                "symbol": "MGRT",
                "decimals": "18",
                "address": "0x71753d0586ea6b979dfccbb492a45e611e0e0ad6",
                "balance": "120000576000000000000000",
                "assetType": "ERC20",
                "USDPrice": null
            },
            {
                "name": "!  Kuroro.gg",
                "symbol": "KURO  [www.kuroro.gg]",
                "decimals": "18",
                "address": "0x31217006cb5515f0f5358a00b83847861c0d27c6",
                "balance": "1391842000000000000000000",
                "assetType": "ERC20",
                "USDPrice": null
            },
            {
                "name": "Airdrop at 3000usdc.us 🎁",
                "symbol": "Airdrop at [3000usdc.us]",
                "decimals": "0",
                "address": "0xac08ac192dff5d0865806c3700006849162f5d34",
                "balance": "1",
                "assetType": "ERC1155",
                "tokenId": "1"
            },
            {
                "name": "Airdrop at 3000usdc.us 🎁",
                "symbol": "Airdrop at [3000usdc.us]",
                "decimals": "0",
                "address": "0x3a193b2a0b2eeee6e0c1cdc05c4a75bc4efb8845",
                "balance": "1",
                "assetType": "ERC1155",
                "tokenId": "1"
            },
            {
                "name": "SHA256 Miner",
                "symbol": "SHA256Miner",
                "decimals": "0",
                "address": "0x322d1f74defab8700ddafc3b3369186f03c81a92",
                "balance": "1",
                "assetType": "ERC721",
                "tokenId": "1249"
            },
            {
                "name": "SHA256 Miner",
                "symbol": "SHA256Miner",
                "decimals": "0",
                "address": "0x07e8d4b6f3f849d919f172150108d24ac7e548f2",
                "balance": "1",
                "assetType": "ERC721",
                "tokenId": "1253"
            }
        ]
    }
}

/getusertransactions

Get the historical transaction details for a specific user address.

GET https://historicallp.api.expand.network/chain/getusertransactions

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
address*	String	The public address of the user.
page	String	The page number that the user wants to fetch.
sortOrder	String	The transaction sorting order. asc or desc. By default, desc.

Sample Request

https://historicallp.api.expand.network/chain/getusertransactions?address=0xee226379dB83CfFC681495730c11fDDE79BA4c0C&page=1420&sortOrder=asc&chainId=56

Sample Response

{
  "status": 200,
  "msg": "success",
  "data": {
      "totalPages": "1453",
      "currentPage": "1420",
      "transactions": [
        {
          "block_signed_at": "2023-11-21T05:49:15Z",
          "block_height": 33678471,
          "block_hash": "0xd6cddc805be39b84bef1926f391abfcb51890a119dde01d5508b90a5e8a0b441",
          "tx_hash": "0xe956b223bdf04f977251db110e1b540b6214c5a960eee22e7f9b049d581a4bc9",
          "tx_offset": 130,
          "successful": true,
          "miner_address": "0xee226379db83cffc681495730c11fdde79ba4c0c",
          "from_address": "0xee226379db83cffc681495730c11fdde79ba4c0c",
          "from_address_label": null,
          "to_address": "0x0000000000000000000000000000000000001000",
          "to_address_label": null,
          "value": "55907510455990511",
          "value_quote": 12.715772291108797,
          "pretty_value_quote": "$12.72",
          "gas_metadata": {
              "contract_decimals": 18,
              "contract_name": "Binance Coin",
              "contract_ticker_symbol": "BNB",
              "contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
              "supports_erc": null,
              "logo_url": "https://www.datocms-assets.com/86369/1670003808-binance-smart-chain-icon-white.svg"
          },
          "gas_offered": 9223372036854776000,
          "gas_spent": 34135,
          "gas_price": 0,
          "fees_paid": "0",
          "gas_quote": 0,
          "pretty_gas_quote": "$0.00",
          "gas_quote_rate": 227.4430069841591,
          "explorers": [
              {
                  "label": null,
                  "url": "https://bscscan.com/tx/0xe956b223bdf04f977251db110e1b540b6214c5a960eee22e7f9b049d581a4bc9"
              }
          ]
      }
      ]
  }
}

/sendtransaction

Send transaction on the chain.

POST https://api.expand.network/chain/sendtransaction

Request Body

Name	Type	Description
rpc	String	Remote procedural call URL.
chainId*	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
rawTransaction*	String	The encoded transaction, obtained from the signed transaction.

Sample Request

{
    "chainId" : "56",
    "rawTransaction": "0xf86f048433918fbe830493e0949b79d6dfe4650d70f35dbb80f7d1ec0cf7f823fd87038d7ea4c6800084022794382da0c9bd6b5c7e18a258b04039d524a3e1382ec0f522d160dc027428933f520b6868a07332736f1df297842299230820626f1fc5b8d4cdd602ade55e3ba02c63e756ce"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId" : "56",
        "transactionHash": "0x8375c5eedd17609292cecc051c18e180fa970b32a77011c48d3725e45e46e7b3" 
    }
}

/decodetransaction

Get the decoded transaction for the provided raw transaction.

POST https://api.expand.network/chain/decodetransaction

Request Body

Name	Type	Description
chainId	String	Refer to the Chain ID page for details. By default, Ethereum.
chainSymbol	String	Refer to the Chain ID page for details.
rawTransaction*	String	The raw transaction to be given for decoding.

Sample Request

{
    "chainId": "56",
    "rawTransaction": "0xf86a80843b9aca00830a3d8794a67e9b68c41b0f26184d64c26e0b2b81466e599485e8d4a51000808193a0d10d1098d97c6ee39ef89aeccfce05e5c736da024f5a6d9973fb0cfffd585e95a006117e1c44a882403df404cd8509c5bc7f8bd0f9425d306c46c6642d0ebb3f82"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "parsedTx": {
            "nonce": 0,
            "gasPrice": {
                "type": "BigNumber",
                "hex": "0x3b9aca00"
            },
            "gasLimit": {
                "type": "BigNumber",
                "hex": "0x0a3d87"
            },
            "to": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
            "value": {
                "type": "BigNumber",
                "hex": "0xe8d4a51000"
            },
            "data": "0x",
            "chainId": 56,
            "v": 147,
            "r": "0xd10d1098d97c6ee39ef89aeccfce05e5c736da024f5a6d9973fb0cfffd585e95",
            "s": "0x06117e1c44a882403df404cd8509c5bc7f8bd0f9425d306c46c6642d0ebb3f82",
            "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
            "hash": "0xc646c843f859ad3478ff4ce9d31a17917b474b99d7c5ba81491197af4006dbf6",
            "type": null
        },
        "assetChanges": {
            "from": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
            "to": "0xa67E9B68c41b0f26184D64C26e0b2B81466E5994",
            "value": {
                "type": "BigNumber",
                "hex": "0xe8d4a51000"
            }
        }
    }
}