Address Appearances API

An EVM indexer proven to find more address appearances: build on complete data to precisely reconcile balances, track interactions, or unlock detailed insights for research.

This includes appearances found in regular transactions, internal transactions, token transfers, withdrawals, mining rewards, etc. We find up to significantly more appearances than other sources (such as Etherscan, for example, visit key.trueblocks.io for details).

The Address Appearances API uses the index of appearances created by TrueBlocks Core, which publishes the index as a public good through the Unchained Index smart contract.

How to use Address Appearances API

Read this guide to learn more about the Address Appearances API add-on built by TrueBlocks, LLC.

RPC Methods

tb_getAppearances

Returns an array of appearances for the given address (from the latest to the earliest)

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(
  'tb_getAppearances',
  [{"address":"0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f", "perPage":20}]
)
print(resp)

require 'eth'

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

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"tb_getAppearances",
    "params": [{"address":"0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f", "perPage":20}]
}

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(
    "tb_getAppearances",
    [{"address":"0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f", "perPage":20}]
  );
  console.log(network);
})();

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

tb_getBounds

Returns the latest and earliest appearance for the given 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(
  'tb_getBounds',
  [{"address":"0xf503017d7baf7fbc0fff7492b751025c6a78179b"}]
)
print(resp)

require 'eth'

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

payload = {
    "id":1,
    "jsonrpc":"2.0",
    "method":"tb_getBounds",
    "params": [{"address":"0xf503017d7baf7fbc0fff7492b751025c6a78179b"}]
}

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(
    "tb_getBounds",
    [{"address":"0xf503017d7baf7fbc0fff7492b751025c6a78179b"}]
  );
  console.log(network);
})();

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

tb_status

Returns the index status, including block number of the last indexed block in the index (approximately six minutes behind the chain's head).

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

require 'eth'

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

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

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

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

Plans & features

Standard - $35/month

Standard - $35/month

Enterprise Sales

Get Started

Standard

$34.95/month

Enterprise

This add-on is currently in Beta

Supported Chains

How to use Address Appearances API

RPC Methods

Supported Chains

Plans & features

Address Appearances API

This add-on is currently in Beta

Supported Chains

How to use Address Appearances API

RPC Methods

Supported Chains

Plans & features

Contact our sales team

Contact our sales team