EVM Blockbook JSON-RPC: Get access to balances, transacti...

Get access to balances, transactions, and address balance history for addresses via JSON-RPC. Also allows fetching currency rate for the specified currency and date.

We've taken the Blockbook REST API and made it available via JSON-RPC. This is the best way to get indexed data for Ethereum.

This add-on uses 20 credits per method call, 10 credit for the bb_* namespaced call, and another for an underlying REST API call to the server.

RPC Methods

bb_getTxSpecific

bb_getTxSpecific(txHash) Returns transaction data in the exact format as returned by backend.

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'bb_getTxSpecific',
  ["0xbca93210308a3a3e75ac4dd98645ebe8ebecaa3778fa77b7cb408bad23991923"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"bb_getTxSpecific",
    "params": ["0xbca93210308a3a3e75ac4dd98645ebe8ebecaa3778fa77b7cb408bad23991923"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "bb_getTxSpecific",
    ["0xbca93210308a3a3e75ac4dd98645ebe8ebecaa3778fa77b7cb408bad23991923"]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"bb_getTxSpecific","params": ["0xbca93210308a3a3e75ac4dd98645ebe8ebecaa3778fa77b7cb408bad23991923"],"id":1,"jsonrpc":"2.0"}'

bb_getTickersList

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

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'bb_getTickersList',
  [{"timestamp":1574346615}]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"bb_getTickersList",
    "params": [{"timestamp":1574346615}]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "bb_getTickersList",
    [{"timestamp":1574346615}]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"bb_getTickersList","params": [{"timestamp":1574346615}],"id":1,"jsonrpc":"2.0"}'

bb_getTickers

bb_getTickers(option) 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.

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'bb_getTickers',
  [{"timestamp":1574346615}]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"bb_getTickers",
    "params": [{"timestamp":1574346615}]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "bb_getTickers",
    [{"timestamp":1574346615}]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"bb_getTickers","params": [{"timestamp":1574346615}],"id":1,"jsonrpc":"2.0"}'

bb_getBalanceHistory

bb_getBalanceHistory(address,options) Returns a balance history for the specified address.

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'bb_getBalanceHistory',
  ["0x91b51c173a4bDAa1A60e234fC3f705A16D228740", {"from":"1683684000", "to":"1700042400", "fiatcurrency":"usd", "groupBy":3600}]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"bb_getBalanceHistory",
    "params": ["0x91b51c173a4bDAa1A60e234fC3f705A16D228740", {"from":"1683684000", "to":"1700042400", "fiatcurrency":"usd", "groupBy":3600}]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "bb_getBalanceHistory",
    ["0x91b51c173a4bDAa1A60e234fC3f705A16D228740", {"from":"1683684000", "to":"1700042400", "fiatcurrency":"usd", "groupBy":3600}]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"bb_getBalanceHistory","params": ["0x91b51c173a4bDAa1A60e234fC3f705A16D228740", {"from":"1683684000", "to":"1700042400", "fiatcurrency":"usd", "groupBy":3600}],"id":1,"jsonrpc":"2.0"}'

bb_getBlock

bb_getBlock(block_hash_or_height) Returns the block data with transaction objects.

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'bb_getBlock',
  ["0x043976bc1e8efaf2f4b0e241dfa3ba9f42aa5a1df8ae6548e1f9a9cd256ca9d7", {"page":1}]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"bb_getBlock",
    "params": ["0x043976bc1e8efaf2f4b0e241dfa3ba9f42aa5a1df8ae6548e1f9a9cd256ca9d7", {"page":1}]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "bb_getBlock",
    ["0x043976bc1e8efaf2f4b0e241dfa3ba9f42aa5a1df8ae6548e1f9a9cd256ca9d7", {"page":1}]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"bb_getBlock","params": ["0x043976bc1e8efaf2f4b0e241dfa3ba9f42aa5a1df8ae6548e1f9a9cd256ca9d7", {"page":1}],"id":1,"jsonrpc":"2.0"}'

bb_getAddress

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

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'bb_getAddress',
  ["0x91b51c173a4bDAa1A60e234fC3f705A16D228740", {"page":1, "size":1000, "fromHeight":0, "details":"txids"}]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"bb_getAddress",
    "params": ["0x91b51c173a4bDAa1A60e234fC3f705A16D228740", {"page":1, "size":1000, "fromHeight":0, "details":"txids"}]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "bb_getAddress",
    ["0x91b51c173a4bDAa1A60e234fC3f705A16D228740", {"page":1, "size":1000, "fromHeight":0, "details":"txids"}]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"bb_getAddress","params": ["0x91b51c173a4bDAa1A60e234fC3f705A16D228740", {"page":1, "size":1000, "fromHeight":0, "details":"txids"}],"id":1,"jsonrpc":"2.0"}'

bb_getTx

bb_getTx(txHash) Returns transaction object for txHash.

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'bb_getTx',
  ["0xbca93210308a3a3e75ac4dd98645ebe8ebecaa3778fa77b7cb408bad23991923"]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"bb_getTx",
    "params": ["0xbca93210308a3a3e75ac4dd98645ebe8ebecaa3778fa77b7cb408bad23991923"]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "bb_getTx",
    ["0xbca93210308a3a3e75ac4dd98645ebe8ebecaa3778fa77b7cb408bad23991923"]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"bb_getTx","params": ["0xbca93210308a3a3e75ac4dd98645ebe8ebecaa3778fa77b7cb408bad23991923"],"id":1,"jsonrpc":"2.0"}'

bb_getBlockHash

bb_getBlockHash(blockHeight) Returns the hash of the block at the given height.

Sample code

Web3

Web3
Eth
Ether
Curl

Copy

00
01
02
03
04
05
06
07

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com"))
resp = w3.provider.make_request(
  'bb_getBlockHash',
  [19441691]
)
print(resp)

require 'eth'

client = Eth::Client.create "https://YOUR_QUICKNODE_ENDPOINT_HERE.com"

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"bb_getBlockHash",
    "params": [19441691]
}

response = client.send(payload.to_json)
puts response

const ethers = require("ethers");
(async () : {
  const provider = new ethers.providers.JsonRpcProvider("https://YOUR_QUICKNODE_ENDPOINT_HERE.com");
  const network = await provider.send(
    "bb_getBlockHash",
    [19441691]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"bb_getBlockHash","params": [19441691],"id":1,"jsonrpc":"2.0"}'

EVM Blockbook JSON-RPC

Supported Chains

RPC Methods

Supported Chains

Plans & features

EVM Blockbook JSON-RPC

Supported Chains

RPC Methods

Supported Chains

Plans & features

Contact our sales team

Contact our sales team