BASE Blockbook

Status

Status page returns current status of Blockbook and connected backend.

Method: GET

Copy

https://base-blockbook.nownodes.io/api/v2

Example response: 200

Copy

{
    "blockbook": {
        "coin": "Base",
        "network": "ETH",
        "host": "5d8604ea4aff",
        "version": "0.4.0",
        "gitCommit": "1254fad2",
        "buildTime": "2025-02-06T09:34:10+00:00",
        "syncMode": true,
        "initialSync": false,
        "inSync": false,
        "bestHeight": 26241991,
        "lastBlockTime": "2025-02-11T11:28:50.768950223Z",
        "inSyncMempool": false,
        "lastMempoolTime": "2025-02-11T11:28:10.613084507Z",
        "mempoolSize": 0,
        "decimals": 18,
        "dbSize": 251145514857,
        "hasFiatRates": true,
        "hasTokenFiatRates": true,
        "currentFiatRatesTime": "2025-02-11T11:20:06.015975594Z",
        "historicalTokenFiatRatesTime": "2025-02-11T06:49:28.324199393Z",
        "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
    },
    "backend": {
        "error": "GetChainInfo: the method web3_clientVersion does not exist/is not available"
    }
}

Get block hash

Method: GET

Copy

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

Example response: 200

Copy

{
    "blockHash": "0x07eee59d552f482e0f350933b8e96f824aa0bfa28267de53dcb0ddbe868a4bf9"
}

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

Copy

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

Example response: 200

Copy

{
    "txid": "0x01a246edf989e422bfab34f63bfe521aef1cd429058184e88741d94bda3f7760",
    "vin": [
        {
            "n": 0,
            "addresses": [
                "0x7B5FdBf6710006B1e5A8eD86e41e8AAe4810b305"
            ],
            "isAddress": true
        }
    ],
    "vout": [
        {
            "value": "34994645158724335",
            "n": 0,
            "addresses": [
                "0x4945cE2d1B5BD904CAc839b7FDAbAfd19Cab982b"
            ],
            "isAddress": true
        }
    ],
    "blockHash": "0x4e813ffa582fce48793f88842b90b9b5576fde756cc7db778f1d2c50c6544ff0",
    "blockHeight": 26242039,
    "confirmations": 7,
    "blockTime": 1739273425,
    "value": "34994645158724335",
    "fees": "711487757040",
    "ethereumSpecific": {
        "status": 1,
        "nonce": 4,
        "gasLimit": 21000,
        "gasUsed": 21000,
        "gasPrice": "19911149",
        "l1Fee": 293353628040,
        "l1GasPrice": "2690999992",
        "l1GasUsed": 1600,
        "data": "0x",
        "parsedData": {
            "methodId": "",
            "name": "Transfer"
        }
    }
}

Get transaction specific

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

Method: GET

Copy

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

Example response: 200

Copy

{
    "tx": {
        "nonce": "0x4",
        "gasPrice": "0x12fd1ed",
        "gas": "0x5208",
        "to": "0x4945cE2d1B5BD904CAc839b7FDAbAfd19Cab982b",
        "value": "0x7c5371c1ba02ef",
        "input": "0x",
        "hash": "0x01a246edf989e422bfab34f63bfe521aef1cd429058184e88741d94bda3f7760",
        "blockNumber": "0x1906bf7",
        "blockHash": "0x4e813ffa582fce48793f88842b90b9b5576fde756cc7db778f1d2c50c6544ff0",
        "from": "0x7B5FdBf6710006B1e5A8eD86e41e8AAe4810b305",
        "transactionIndex": "0x87"
    },
    "receipt": {
        "gasUsed": "0x5208",
        "status": "0x1",
        "logs": [],
        "l1Fee": "0x444d3d2188",
        "l1GasPrice": "0xa06566b8",
        "l1GasUsed": "0x640"
    }
}

Get address

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

Method: GET

Copy

https://base-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

Copy

{
    "page": 1,
    "totalPages": 1,
    "itemsOnPage": 1000,
    "address": "0x7B5FdBf6710006B1e5A8eD86e41e8AAe4810b305",
    "balance": "4811074226960",
    "unconfirmedBalance": "0",
    "unconfirmedTxs": 0,
    "txs": 6,
    "nonTokenTxs": 3,
    "txids": [
        "0x01a246edf989e422bfab34f63bfe521aef1cd429058184e88741d94bda3f7760",
        "0x88b8d31afa61f7456496e2bab7a3905eebe1f304f9359a8112e271e7c6ee9074",
        "0x7aebb7e1d6ddce74e265520ad9bf82d0344ccc5486bf9c13a39ce240e486f4ef",
        "0xd565b50b3219215cefd71f1da48f568eb7f268415c3e23a6789bf91682c70f7e",
        "0xccce110315d5e3165bb2b0bbdd2b8df35445ab6b51093a13cf6c40937480ad0d",
        "0x0cde0dda389ee53fe6f209de038be32a0fcd6d4acf2188fdeae5002853a8ee1f",
        "0x2fab50bd1a2a940759e51e1b1b84ad996e75da1de176e917525efc0c7691dc5c",
        "0xcc49101ad9a1452aaee7e32e64bc01b868b2c339e10b0524ce7866f5987cde93",
        "0xd7bc3a78e5942659cba0bc1c808d28c321f8b0ec9193d93280b9429cd2504c5c",
        "0x167b65bbb92b6969ed395dd4a8abeac6a17e7ef4c24f8980f1062a5f9e8dca18",
        "0x8d8deadf5df64c64e86fe97fc01e50c92879e96c8442944c8c0903663a3b60e5",
        "0xb07fd8b8a154c751cef733ab9c10cde9fc9c2d2fddd1b5dfd6940b24cc15ee5c",
        "0xa367ef945cb2f855f721918bd62213651ee83ad97f9914a13dbf91f9c5fd0861",
        "0x98790e238293ab40cfcc313f15ae0a6e2b0e7c7276855f30a3cc23ec175b7377"
    ],
    "nonce": "5",
    "tokens": [
        {
            "type": "ERC20",
            "standard": "ERC20",
            "name": "$UЅDС REWARD:  t.ly/cpool",
            "contract": "0x3AbA11811726e3df69Abb7b96AEe58175B25E6C0",
            "transfers": 1,
            "symbol": "$UЅDС - Redeem: t.ly/cpool - #15",
            "balance": "1"
        },
        {
            "type": "ERC20",
            "standard": "ERC20",
            "name": "Bsop",
            "contract": "0x9704d2adBc02C085ff526a37ac64872027AC8a50",
            "transfers": 1,
            "symbol": "Bsop",
            "decimals": 18,
            "balance": "5000000000000000000"
        },
        {
            "type": "ERC20",
            "standard": "ERC20",
            "name": "USD Coin",
            "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
            "transfers": 2,
            "symbol": "USDC",
            "decimals": 6,
            "balance": "0"
        }
    ]
}

Get block

Returns information about block with transactions, subject to paging.

Method: GET

Copy

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

Example response: 200

Copy

{
    "page": 1,
    "totalPages": 1,
    "itemsOnPage": 1000,
    "hash": "0x4e813ffa582fce48793f88842b90b9b5576fde756cc7db778f1d2c50c6544ff0",
    "previousBlockHash": "0x45084f4d71fda5430be42400b588045620e2e925747fc403b2e438247ab94d68",
    "nextBlockHash": "0x373c378ce62f5b66651b3e99f5cfbb72d6740bf18697039834b2fb426270f8f0",
    "height": 26242039,
    "confirmations": 301,
    "size": 58510,
    "time": 1739273425,
    "version": 0,
    "merkleRoot": "",
    "nonce": "0x0000000000000000",
    "bits": "",
    "difficulty": "0x0",
    "txCount": 136,
    "txs": [...

Send transaction

Sends new transaction to backend.

Method: GET

Copy

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

Example response: 200

Copy

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

or in case of error

Copy

{
  "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

Copy

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

Example response: 200

Copy

{
    "ts": 1739273645,
    "available_currencies": [
        "aed",
        "ars",
        "aud",
        "bch",
        "bdt",
        "bhd",
        "bits",
        "bmd",
        "bnb",
        "brl",
        "btc",
        "cad",
        "chf",
        "clp",
        "cny",
        "czk",
        "dkk",
        "dot",
        "eos",
        "eth",
        "eur",
        "gbp",
        "gel",
        "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"
    ]
}

Balance history

Returns a balance history for the specified XPUB or address.

Method: GET

Copy

https://base-blockbook.nownodes.io/api/v2/balancehistory/<XPUB|address>?from=<dateFrom>&to=<dateTo>[&fiatcurrency=<currency>&groupBy=<groupBySeconds>]

Example response: 200

Copy

[
    {
        "time": 1736802000,
        "txs": 1,
        "received": "0",
        "sent": "0",
        "sentToSelf": "0",
        "rates": {
            "aed": 11352.998,
            "ars": 3263929.2,
            "aud": 4927.756,
            "bch": 9.129773,
            "bdt": 375879.47,
            "bhd": 1164.9298,
            "bits": 31543.648,
            "bmd": 3090.943,
            "bnb": 4.836708,
...