BSC Blockbook

Status

Status page returns current status of Blockbook and connected backend.

Method: GET

https://bsc-blockbook.nownodes.io/api

Example response: 200

{
    "blockbook": {
        "coin": "BNB Smart Chain",
        "host": "a9c3f3757937",
        "version": "devel",
        "gitCommit": "0277c2a8-dirty",
        "buildTime": "2024-04-03T14:52:21+00:00",
        "syncMode": true,
        "initialSync": false,
        "inSync": true,
        "bestHeight": 37793531,
        "lastBlockTime": "2024-04-12T11:10:23.739555713Z",
        "inSyncMempool": true,
        "lastMempoolTime": "2024-04-12T11:10:24.613855191Z",
        "mempoolSize": 237175,
        "decimals": 18,
        "dbSize": 836151605226,
        "hasFiatRates": true,
        "currentFiatRatesTime": "2024-04-12T11:10:05.251233019Z",
        "historicalFiatRatesTime": "2024-04-11T00:00:00Z",
        "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
    },
    "backend": {
        "chain": "mainnet",
        "blocks": 37793531,
        "bestBlockHash": "0x755efb69402bea4b58604a9341949055abfe989df0c14464394bcf1a7618e68b",
        "difficulty": "2",
        "version": "Geth/v1.3.12-280cad30-20240319/linux-amd64/go1.21.8"
    }
}

Get block hash

Method: GET

https://bsc-blockbook.nownodes.io/api/v2/block-index/<block height>

Example response: 200

{
    "blockHash": "0x7ac33d5c2abfa5c86b688239812db61f36f10dfbfc76e1b977ec6eca7618b247"
}

Get transaction

Get transaction returns "normalized" data about transaction, which has the same general structure for all supported coins. It does not return coin specific fields (for example information about Zcash shielded addresses).

Method: GET

https://bsc-blockbook.nownodes.io/api/v2/tx/<txid>

Example response: 200

{
    "txid": "0xb720d6f672bd2f5236a7808eb106905e193f55660e0b8dab0856e428dae88c09",
    "vin": [
        {
            "n": 0,
            "addresses": [
                "0xe2d3A739EFFCd3A99387d015E260eEFAc72EBea1"
            ],
            "isAddress": true
        }
    ],
    "vout": [
        {
            "value": "35872515233244859",
            "n": 0,
            "addresses": [
                "0x0000000000000000000000000000000000001000"
            ],
            "isAddress": true
        }
    ],
    "blockHash": "0x7ac33d5c2abfa5c86b688239812db61f36f10dfbfc76e1b977ec6eca7618b247",
    "blockHeight": 37793570,
    "confirmations": 32,
    "blockTime": 1712920338,
    "value": "35872515233244859",
    "fees": "0",
    "ethereumSpecific": {
        "status": 1,
        "nonce": 1645004,
        "gasLimit": 9223372036854775807,
        "gasUsed": 51008,
        "gasPrice": "0",
        "data": "0xf340fa01000000000000000000000000e2d3a739effcd3a99387d015e260eefac72ebea1",
        "parsedData": {
            "methodId": "0xf340fa01",
            "name": ""
        }
    }
}

Get transaction specific

Returns transaction data in the exact format as returned by backend, including all coin specific fields:

Method: GET

https://bsc-blockbook.nownodes.io/api/v2/tx-specific/<txid>

Example response: 200

{
    "tx": {
        "nonce": "0x1919cc",
        "gasPrice": "0x0",
        "gas": "0x7fffffffffffffff",
        "to": "0x0000000000000000000000000000000000001000",
        "value": "0x7f71dccfad66bb",
        "input": "0xf340fa01000000000000000000000000e2d3a739effcd3a99387d015e260eefac72ebea1",
        "hash": "0xb720d6f672bd2f5236a7808eb106905e193f55660e0b8dab0856e428dae88c09",
        "blockNumber": "0x240af22",
        "blockHash": "0x7ac33d5c2abfa5c86b688239812db61f36f10dfbfc76e1b977ec6eca7618b247",
        "from": "0xe2d3A739EFFCd3A99387d015E260eEFAc72EBea1",
        "transactionIndex": "0xb4"
    },
    "receipt": {
        "gasUsed": "0xc740",
        "status": "0x1",
        "logs": [
            {
                "address": "0x0000000000000000000000000000000000001002",
                "topics": [
                    "0x6c98249d85d88c3753a04a22230f595e4dc8d3dc86c34af35deeeedc861b89db",
                    "0x0000000000000000000000000000000000000000000000000000000000001000"
                ],
                "data": "0x0000000000000000000000000000000000000000000000000007f71dccfad66b"
            },
            {
                "address": "0x0000000000000000000000000000000000001000",
                "topics": [
                    "0x6ecc855f9440a9282c90913bbc91619fd44f5ec0b462af28d127b116f130aa4d"
                ],
                "data": "0x0000000000000000000000000000000000000000000000000007f71dccfad66b"
            },
            {
                "address": "0x0000000000000000000000000000000000001000",
                "topics": [
                    "0x627059660ea01c4733a328effb2294d2f86905bf806da763a89cee254de8bee5"
                ],
                "data": "0x000000000000000000000000000000000000000000000000000cbe9614c48a45"
            },
            {
                "address": "0x0000000000000000000000000000000000001000",
                "topics": [
                    "0x93a090ecc682c002995fad3c85b30c5651d7fd29b0be5da9d784a3302aedc055",
                    "0x000000000000000000000000e2d3a739effcd3a99387d015e260eefac72ebea1"
                ],
                "data": "0x000000000000000000000000000000000000000000000000006abc28edee060b"
            }
        ]
    }
}

Get address

Returns balances and transactions of an address. The returned transactions are sorted by block height, newest blocks first.

Method: GET

https://bsc-blockbook.nownodes.io/api/v2/address/<address>[?page=<page>&pageSize=<size>&from=<block height>&to=<block height>&details=<basic|tokens|tokenBalances|txids|txs>&contract=<contract address>&secondary=usd]

Example response: 200

{
    "page": 1,
    "totalPages": 1647,
    "itemsOnPage": 1000,
    "address": "0xe2d3A739EFFCd3A99387d015E260eEFAc72EBea1",
    "balance": "2548246364842312646",
    "unconfirmedBalance": "0",
    "unconfirmedTxs": 0,
    "txs": 1646840,
    "nonTokenTxs": 1645026,
    "txids": [
        "0x69d6ae1d4d2209611d3d2b60f3ad58e579dc228b544e3618189577d5c6abc77e",
        "0xb720d6f672bd2f5236a7808eb106905e193f55660e0b8dab0856e428dae88c09",
        "0xbeb091df4603ee25d2ef0b268a3cffedeb8b4748c0ed4d926f48a8d6e5394499",
        "0xbaea23e25dcd6a067a9cf235ece42c76a67473d40584048a794cfc54ff2e3b17",
        "0xa960efc6ffdd7c0794bca0a16b96609c2535b3d758d6f7929f02c0ecdbf066a1",
        "0x519312a4855164ac414e5fa608506ba73430207d67897711ddc46c57ef5f9a78",
        "0xc76084401156abac1e69fa7a147790bfb84d36bec6c1ed876a6e2e1396bac4af",
        "0xef467b88d0d91abb37818548deb1b58478451c47e87da1bbc2eba2f2c5b4bdd4",
        "0xffa67febc284ee17462318bbb2d9b8bed077a612946b3c2402c79eaf354a797f",
        "0x0682ce403313e5a6caa5cb6dc4d5351ddb8ab4a40e350cf5c00039da746ca4f9",
        "0xda690ccdb69fa5ed150c2df6169402434501c3b3040db0434f24ed4657cbd781",
        "0xbf2357185ffec5bf4d75d7c542384d62e2e1f6f15165518d3636f4d70e3fd8aa",
        "0xe7bb67855e744056f2f3974b3a83c810ac433a53f82b3077a349f755bf9497cf",
        "0x47de1017d1c19e1d5e0d8cdcea54dc02a33670eedc441348ed9aa6e573f580bc",
        "0x5498710e392ad2e07917d1919b42db8b95feb3b1893eda871583e18fcc5280ac",
        "0xf3d15bb39b2cd57b945cc41b14b97ef207746c361c0470313728757f722e343b",
        "0x6fe1c3c2d5ef315f8e2422bd104905f4d6307edfe50624bd6cbcfcf7fda8ee54",
        "0x0a15375177154119d19b6451da8d924c2aec8c00dbeb922587b7ea0cd1017aa0",
        "0x23e17448f6350e72385cf64762467f9df5b67aa9e9a8e75d2cf1f059b79e3f54",
        "0x1b1f6f4335365b047035ffc66244b69fc92c05c4bb8a52703eedec133361ce30",
        "0xa1f2984ade3a6048b8c4b4726196301d1e04c07c98563339770e216c357f8a61",
        "0xfb7e514787869a45f0ce3ed01b8598a6cd00d07b53c7047671c65613879cc83b",
        "0xfd77f7e71a8cc50e31fed55c67c6ce38a6c7d3eb3aaea83c332793f9123a731e",
        "0x04d0dcd28ae2c0c17576939972714815e32a37ccdaf7669193377d54ae0c30a7",
        "0x254deaa6738cbcd17206bebd064a6a8e65e23410c2a2a4f4209d94d3ef5cea19",
        "0x6de542bd2752a9befd3c03571a31e3d38721a0c01aa6b8a238cd7c225e10520c",
        "0x00a4cec7505afda28ff532cc41669370218e2f8638be11355281675aa420d471",
        "0x066df4a38425cc7e156ea942762063d4d2978c88676b7daf553df1002041f14c",
        "0x2e74ff189e8bd370a1b51c27b696b116b2879361b2f0fb93ff2e9113e54cd365",
        "0x2a1c3ffa0a0dff669961e11bde81bddc60fe7cc5f075befff2df0e21f68a2b40",
        "0xb3dd9dfd95b9b694eae7551136c9eee60a0c3a05d64b8369b2468464aa354ff0",
        "0x2a0662cf95239957322af69724303d439078493d5a1a5927e9716f57d0a85c63",
        "0x513c25fdc1c671344317ca9c84668cfd80631bde3f5d9e1cb9d16e19d1c9afb5",
        "0x2b1f8180ce8df460293d793406ba8c38455cc5136a70557e1fff81cab30601b8",
        "0x4510bc98e1378174f3a048bb060e28d96ec2b8942618ad5a9d020673d4808cf6",
        "0xd071e517ac6bddb1fc0383be3cb9dc67417cc1f3d341a6083ec4e6d8564fe981",
        "0xf83ecef2b6c5f1897d3d82c5adfb2b53607a057bd56bf98819c7d83e344fbc31",
        "0xa1d039754abc5fc2205fc4174509b25048e07b211a548963af4cd57832cedced",
        "0x43ee0db6c26301b2d6a462e4b2ef7f5d70aef57a4652f57b1c28ccfae24089ef",
...

Get block

Returns information about block with transactions, subject to paging.

Method: GET

https://bsc-blockbook.nownodes.io/api/v2/block/<block height|block hash>

Example response: 200

{
    "page": 1,
    "totalPages": 1,
    "itemsOnPage": 1000,
    "hash": "0x7ac33d5c2abfa5c86b688239812db61f36f10dfbfc76e1b977ec6eca7618b247",
    "previousBlockHash": "0x118142d0ac36c886fed11dcca88dcea997802b6dcac5c97bf0896062865a0a3e",
    "nextBlockHash": "0x648707c4ce8052121f90b9f94a417bb73c1227aa1db9da88bcd866a1c2ca9d29",
    "height": 37793570,
    "confirmations": 206,
    "size": 56646,
    "time": 1712920338,
    "version": 0,
    "merkleRoot": "",
    "nonce": "0x0000000000000000",
    "bits": "",
    "difficulty": "0x2",
    "txCount": 181,
    "txs": [
        {
            "txid": "0x86abf311ce1424de744685578ffbe2c9b78c9a74c0a44f087a4958e467471247",
            "vin": [
                {
                    "n": 0,
                    "addresses": [
                        "0x3149B730b9Df7AeAd3d3e410bc17498298F9bC43"
                    ],
                    "isAddress": true
                }
            ],
            "vout": [
                {
                    "value": "0",
                    "n": 0,
                    "addresses": [
                        "0x0000000000b35Ae47b12B8CCF2f8D51e208760c8"
                    ],
                    "isAddress": true
                }
            ],
            "blockHash": "0x7ac33d5c2abfa5c86b688239812db61f36f10dfbfc76e1b977ec6eca7618b247",
            "blockHeight": 37793570,
            "confirmations": 206,
            "blockTime": 1712920338,
            "value": "0",
            "fees": "5389148686556682",
            "tokenTransfers": [
                {
                    "type": "BEP20",
                    "from": "0x0000000000b35Ae47b12B8CCF2f8D51e208760c8",
                    "to": "0x372fc728F7e9429D8A12d34F022E932510935FA2",
                    "contract": "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c",
                    "name": "Wrapped BNB",
                    "symbol": "WBNB",
                    "decimals": 18,
                    "value": "656224486137344256"
                },
...

Send transaction

Sends new transaction to backend.

Method: GET

https://bsc-blockbook.nownodes.io/api/v2/sendtx/<hex tx data>

Example response: 200

{
  "result": "0xb720d6f672bd2f5236a7808eb106905e193f55660e0b8dab0856e428dae88c09"
}

or in case of error

{
  "error": {
    "message": "error message"
  }
}

Tickers list

Returns a list of available currency rate tickers (secondary currencies) for the specified date, along with an actual data timestamp.

Method: GET

https://bsc-blockbook.nownodes.io/api/v2/tickers-list/?timestamp=<timestamp>

Example response: 200

{
    "ts": 1600732800,
    "available_currencies": [
        "aed",
        "ars",
        "aud",
        "bch",
        "bdt",
        "bhd",
        "bits",
        "bmd",
        "bnb",
        "brl",
        "btc",
        "cad",
        "chf",
        "clp",
        "cny",
        "czk",
        "dkk",
        "dot",
        "eos",
        "eth",
        "eur",
        "gbp",
        "hkd",
        "huf",
        "idr",
        "ils",
        "inr",
        "jpy",
        "krw",
        "kwd",
        "link",
        "lkr",
        "ltc",
        "mmk",
        "mxn",
        "myr",
        "ngn",
        "nok",
        "nzd",
        "php",
        "pkr",
        "pln",
        "rub",
        "sar",
        "sats",
        "sek",
        "sgd",
        "thb",
        "try",
        "twd",
        "uah",
        "usd",
        "vef",
        "vnd",
        "xag",
        "xau",
        "xdr",
        "xlm",
        "xrp",
        "yfi",
        "zar"
    ]
}

Tickers

Returns currency rate for the specified currency and date. If the currency is not available for that specific timestamp, the next closest rate will be returned. All responses contain an actual rate timestamp.

Method: GET

https://bsc-blockbook.nownodes.io/api/v2/tickers/[?currency=<currency>&timestamp=<timestamp>]

Example response (no parameters): 200

{
    "ts": 1712921343,
    "rates": {
        "aed": 12982.32,
        "ars": 3060621,
        "aud": 5445.56,
        "bch": 5.824014,
        "bdt": 387791,
        "bhd": 1332.76,
        "bits": 49913,
        "bmd": 3535.26,
        "bnb": 5.683538,
        "brl": 17991.28,
        "btc": 0.04991298,
        "cad": 4860.8,
        "chf": 3226.81,
        "clp": 3366913,
        "cny": 25586,
        "czk": 84098,
        "dkk": 24757,
        "dot": 418.727,
        "eos": 3133,
        "eth": 1,
        "eur": 3318.38,
        "gbp": 2835.15,
        "gel": 9474.49,
        "hkd": 27704,
        "huf": 1299561,
        "idr": 57034656,
        "ils": 13353.27,
        "inr": 295164,
        "jpy": 541821,
        "krw": 4881910,
        "kwd": 1088.67,
        "link": 199.732,
        "lkr": 1054786,
        "ltc": 36.257072,
        "mmk": 7419958,
        "mxn": 58492,
        "myr": 16854.17,
        "ngn": 4406240,
        "nok": 38479,
        "nzd": 5932.24,
        "php": 200020,
        "pkr": 982200,
        "pln": 14133.49,
        "rub": 330707,
        "sar": 13261.16,
        "sats": 4991298,
        "sek": 38342,
        "sgd": 4805.1,
        "thb": 128965,
        "try": 114269,
        "twd": 114111,
        "uah": 138664,
        "usd": 3535.26,
        "vef": 353.99,
        "vnd": 88458870,
        "xag": 122.06,
        "xau": 1.48,
        "xdr": 2665.03,
        "xlm": 27227,
        "xrp": 5810,
        "yfi": 0.4212426,
        "zar": 66380
    }
}

Example error response (e.g. rate unavailable, incorrect currency...):

{
  "ts":7980386400,
  "rates": {
    "usd": -1
  }
}

Last updated