Visible Magic Inc Base Blockbook JSON-RPC: Get access to ...

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 for Base blockchain. This is the best way to get indexed data for Base with methods to get historical data or current data across different currencies.

RPC Methods

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":1706555990}]
)
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":1706555990}]
}

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":1706555990}]
  );
  console.log(network);
})();

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

bb_getBlock

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',
  ["19082773", {"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": ["19082773", {"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",
    ["19082773", {"page":1}]
  );
  console.log(network);
})();

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

bb_getAddress

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',
  ["0x524965c15376F2a456888dA6AF19c49117D921E8", {"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": ["0x524965c15376F2a456888dA6AF19c49117D921E8", {"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",
    ["0x524965c15376F2a456888dA6AF19c49117D921E8", {"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": ["0x524965c15376F2a456888dA6AF19c49117D921E8", {"page":1, "size":1000, "fromHeight":0, "details":"txids"}],"id":1,"jsonrpc":"2.0"}'

bb_getBlockHash

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',
  ["19082773"]
)
print(resp)

require 'eth'

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

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

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",
    ["19082773"]
  );
  console.log(network);
})();

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

bb_getBalanceHistory

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',
  ["0x524965c15376F2a456888dA6AF19c49117D921E8", {"from":"1683684000", "to":"1724955083", "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": ["0x524965c15376F2a456888dA6AF19c49117D921E8", {"from":"1683684000", "to":"1724955083", "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",
    ["0x524965c15376F2a456888dA6AF19c49117D921E8", {"from":"1683684000", "to":"1724955083", "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": ["0x524965c15376F2a456888dA6AF19c49117D921E8", {"from":"1683684000", "to":"1724955083", "fiatcurrency":"usd", "groupBy":3600}],"id":1,"jsonrpc":"2.0"}'

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',
  ["0xdea41e0b5287de0a28d235309fdde8ff6bd234b8924ffbd9666fccedbb154139"]
)
print(resp)

require 'eth'

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

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

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",
    ["0xdea41e0b5287de0a28d235309fdde8ff6bd234b8924ffbd9666fccedbb154139"]
  );
  console.log(network);
})();

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

bb_getTx

Returns transaction object for the transaction hash.

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',
  ["0xdea41e0b5287de0a28d235309fdde8ff6bd234b8924ffbd9666fccedbb154139"]
)
print(resp)

require 'eth'

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

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

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",
    ["0xdea41e0b5287de0a28d235309fdde8ff6bd234b8924ffbd9666fccedbb154139"]
  );
  console.log(network);
})();

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"bb_getTx","params": ["0xdea41e0b5287de0a28d235309fdde8ff6bd234b8924ffbd9666fccedbb154139"],"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"}'

Base Blockbook JSON-RPC

This add-on is currently in Beta

Supported Chains

RPC Methods

Supported Chains

Plans & features

Base Blockbook JSON-RPC

This add-on is currently in Beta

Supported Chains

RPC Methods

Supported Chains

Plans & features

Contact our sales team

Contact our sales team