Base Blockbook JSON-RPC

🔥

Trending

1Supported chain 8RPC Methods 4Plans

Starting at $100.00

This add-on is currently in Beta

Feel free to test it, we would appreciate feedback to address any errors that may occur

Supported Chains

Published on Aug 29, 2024

Support Website Support Email

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
Eth
Ether
Curl

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
Eth
Ether
Curl

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
Eth
Ether
Curl

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
Eth
Ether
Curl

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
Eth
Ether
Curl

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
Eth
Ether
Curl

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
Eth
Ether
Curl

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
Eth
Ether
Curl

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"}'

Supported Chains

Published on Aug 29, 2024

Support Website Support Email

Plans & features

Starter - $100/month

Starter - $100/month
Basic - $180/month
Pro - $999/month
Business - $3,500/month

Enterprise Sales

Starter

$100.00/month

Basic

$180.00/month

Pro

$999.00/month

Business

$3,500.00/month

Enterprise

Starter

$100.00/month