TrueBlocks API (3.5.0-release)

Download OpenAPI specification:Download

A REST layer over the TrueBlocks chifra command line. With chifra daemon, you can run this on your own machine, and make calls to localhost.

How to use this API effectively

The endpoints in this API are exact translations of the commands used by the chifra CLI application, and the query parameters mirror the commands' options and flags. If you want details, the commands have their own documentation page. For detailed descriptions of data returned by each command, see the data model reference.

Before you begin

  1. Install the trueblocks-core application on your machine, change your configs as needed.
  2. Run chifra daemon

Example queries

By default, all calls are to localhost:8080. All options and flags are passed through query parameters.

For example, to get block 100, make a call to /blocks and specify the block you want in the query parameter:

curl "http://localhost:8080/blocks?blocks=100"

Some parameters support ranges:

curl "http://localhost:8080/blocks?blocks=100-120"

Other parameters let you filter your responses. For example, to get only the unique addresses from that block range:

curl "http://localhost:8080/blocks?blocks=100-110&uniq=true"

You might want to cache queries on your local machine.

"http://localhost:8080/blocks?blocks=100-110&cache=true"

Caching speeds up repeat queries significantly. The cache options are particularly useful for calls to data-rich endpoints, like most endpoints in the "Accounts" collection.

Of course, caches occupy local storage. So cache wisely.

Accounts

Access and cache transactional data

List transactions

List every appearance of an address anywhere on the chain. Corresponds to the chifra list command line.

query Parameters
addrs
required
Array of strings <address> [ items <address > ]

one or more addresses (0x...) to list

count
boolean

display only the count of records for each monitor

noZero
boolean

for the --count option only, suppress the display of zero appearance accounts

bounds
boolean

report first and last block this address appears

unripe
boolean

list transactions labeled unripe (i.e. less than 28 blocks old)

silent
boolean

freshen the monitor only (no reporting)

firstRecord
number <uint64>

the first record to process

maxRecords
number <uint64>

the maximum number of records to process

reversed
boolean

produce results in reverse chronological order

firstBlock
number <blknum>

first block to export (inclusive, ignored when freshening)

lastBlock
number <blknum>

last block to export (inclusive, ignored when freshening)

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "address": "0xff9387a9aae1f5daab1cd8eb0e92113ea9d19ca3",
  • "blockNumber": 4037786,
  • "transactionIndex": 47
}

Export details

Export full details of transactions for one or more addresses. Corresponds to the chifra export command line.

query Parameters
addrs
required
Array of strings <address> [ items <address > ]

one or more addresses (0x...) to export

topics
Array of strings <topic> [ items <topic > ]

filter by one or more log topics (only for --logs option)

fourbytes
Array of strings <fourbyte> [ items <fourbyte > ]

filter by one or more fourbytes (only for transactions and trace options)

appearances
boolean

export a list of appearances

receipts
boolean

export receipts instead of transactional data

logs
boolean

export logs instead of transactional data

traces
boolean

export traces instead of transactional data

neighbors
boolean

export the neighbors of the given address

accounting
boolean

attach accounting records to the exported data (applies to transactions export only)

statements
boolean

for the accounting options only, export only statements

balances
boolean

traverse the transaction history and show each change in ETH balances

withdrawals
boolean

export withdrawals for the given address

articulate
boolean

articulate transactions, traces, logs, and outputs

cacheTraces
boolean

force the transaction's traces into the cache

count
boolean

for --appearances mode only, display only the count of records

firstRecord
number <uint64>

the first record to process

maxRecords
number <uint64>

the maximum number of records to process

relevant
boolean

for log and accounting export only, export only logs relevant to one of the given export addresses

emitter
Array of strings <address> [ items <address > ]

for the --logs option only, filter logs to show only those logs emitted by the given address(es)

topic
Array of strings <topic> [ items <topic > ]

for the --logs option only, filter logs to show only those with this topic(s)

reverted
boolean

export only transactions that were reverted

asset
Array of strings <address> [ items <address > ]

for the accounting options only, export statements only for this asset

flow
string
Enum: "in" "out" "zero"

for the accounting options only, export statements with incoming, outgoing, or zero value

factory
boolean

for --traces only, report addresses created by (or self-destructed by) the given address(es)

unripe
boolean

export transactions labeled unripe (i.e. less than 28 blocks old)

reversed
boolean

produce results in reverse chronological order

noZero
boolean

for the --count option only, suppress the display of zero appearance accounts

firstBlock
number <blknum>

first block to process (inclusive)

lastBlock
number <blknum>

last block to process (inclusive)

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

cache
boolean

force the results of the query into the cache

decache
boolean

removes related items from the cache

ether
boolean

export values in ether

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "hash": "0x78a17b79e638190d72a3030a79645c32cf3420a133ea2835206778e5ab63fdc7",
  • "blockHash": "0xdf551eb24dd5275c22d497b9076f1111f483b71ca37002bee51d5db55d20d2fa",
  • "blockNumber": 4037786,
  • "transactionIndex": 47,
  • "timestamp": 1500352888,
  • "from": "0x29205869522cc9d1f84b0ad5279a8e74a7c66c15",
  • "to": "0xff9387a9aae1f5daab1cd8eb0e92113ea9d19ca3",
  • "value": 84353870000000000,
  • "gas": 90000,
  • "gasPrice": 20000000000,
  • "maxFeePerGas": 0,
  • "maxPriorityFeePerGas": 0,
  • "isError": 0,
  • "hasToken": 0,
  • "receipt": {
    },
  • "compressedTx": "0x()",
  • "gasCost": 420000000000000,
  • "gasUsed": 21000,
  • "date": "2017-07-18 04:41:28 UTC",
  • "ether": 0.08435387
}

Manage monitors

Add, remove, clean, and list address monitors. Corresponds to the chifra monitors command line.

query Parameters
addrs
Array of strings <address> [ items <address > ]

one or more addresses (0x...) to process

delete
boolean

delete a monitor, but do not remove it

undelete
boolean

undelete a previously deleted monitor

remove
boolean

remove a previously deleted monitor

clean
boolean

clean (i.e. remove duplicate appearances) from monitors, optionally clear stage

list
boolean

list monitors in the cache (--verbose for more detail)

count
boolean

show the number of active monitors (included deleted but not removed monitors)

staged
boolean

for --clean, --list, and --count options only, include staged monitors

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

cache
boolean

force the results of the query into the cache

decache
boolean

removes related items from the cache

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Manage names

Query addresses or names of well-known accounts. Corresponds to the chifra names command line.

query Parameters
terms
required
Array of strings <string> [ items <string > ]

a space separated list of one or more search terms

expand
boolean

expand search to include all fields (search name, address, and symbol otherwise)

matchCase
boolean

do case-sensitive search

all
boolean

include all (including custom) names in the search

custom
boolean

include only custom named accounts in the search

prefund
boolean

include prefund accounts in the search

addr
boolean

display only addresses in the results (useful for scripting, assumes --no_header)

tags
boolean

export the list of tags and subtags only

clean
boolean

clean the data (addrs to lower case, sort by addr)

regular
boolean

only available with --clean, cleans regular names database

dryRun
boolean

only available with --clean or --autoname, outputs changes to stdout instead of updating databases

autoname
string <address>

an address assumed to be a token, added automatically to names database if true

create
string

create a new item

update
string

update an existing item

delete
string

delete the item, but do not remove it

undelete
string

undelete a previously deleted item

remove
string

remove a previously deleted item

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "tags": "50-Tokens:ERC20",
  • "address": "0xfe5f141bf94fe84bc28ded0ab966c16b17490657",
  • "name": "LibraToken",
  • "symbol": "LBA",
  • "source": "On chain",
  • "decimals": 18
}

Manage Abi files

Fetches the ABI for a smart contract. Corresponds to the chifra abis command line.

query Parameters
addrs
required
Array of strings <address> [ items <address > ]

a list of one or more smart contracts whose ABIs to display

known
boolean

load common 'known' ABIs from cache

proxyFor
string <address>

redirects the query to this implementation

list
boolean

a list of downloaded abi files

count
boolean

show the number of abis downloaded

find
Array of strings <string> [ items <string > ]

search for function or event declarations given a four- or 32-byte code(s)

hint
Array of strings <string> [ items <string > ]

for the --find option only, provide hints to speed up the search

encode
string

generate the 32-byte encoding for a given cannonical function or event signature

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

cache
boolean

force the results of the query into the cache

decache
boolean

removes related items from the cache

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "name": "PairCreated",
  • "type": "event",
  • "stateMutability": "nonpayable",
  • "signature": "PairCreated(address,address,address,uint256)",
  • "encoding": "0x0d3648bd0f6ba80134a33ba9275ac585d9d315f0ad8355cddefde31afa28d0e9",
  • "inputs": [
    ]
}

Chain Data

Access and cache blockchain-related data

Get blocks

Retrieve one or more blocks from the chain or local cache. Corresponds to the chifra blocks command line.

query Parameters
blocks
required
Array of strings <blknum> [ items <blknum > ]

a space-separated list of one or more block identifiers

hashes
boolean

display only transaction hashes, default is to display full transaction detail

uncles
boolean

display uncle blocks (if any) instead of the requested block

traces
boolean

export the traces from the block as opposed to the block data

uniq
boolean

display a list of uniq address appearances per transaction

flow
string
Enum: "from" "to" "reward"

for the --uniq option only, export only from or to (including trace from or to)

logs
boolean

display only the logs found in the block(s)

emitter
Array of strings <address> [ items <address > ]

for the --logs option only, filter logs to show only those logs emitted by the given address(es)

topic
Array of strings <topic> [ items <topic > ]

for the --logs option only, filter logs to show only those with this topic(s)

withdrawals
boolean

export the withdrawals from the block as opposed to the block data

articulate
boolean

for the --logs option only, articulate the retrieved data if ABIs can be found

count
boolean

display only the count of appearances for --addrs or --uniq

cacheTxs
boolean

force a write of the block's transactions to the cache (slow)

cacheTraces
boolean

force a write of the block's traces to the cache (slower)

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

cache
boolean

force the results of the query into the cache

decache
boolean

removes related items from the cache

ether
boolean

export values in ether

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "blockNumber": 3141592,
  • "hash": "0x0b4c6fb75ded4b90218cf0346b0885e442878f104e1b60bf75d5b6860eeacd53",
  • "...": "...",
  • "transactions": [ ]
}

Get transactions

Retrieve one or more transactions from the chain or local cache. Corresponds to the chifra transactions command line.

query Parameters
transactions
required
Array of strings <tx_id> [ items <tx_id > ]

a space-separated list of one or more transaction identifiers

articulate
boolean

articulate the retrieved data if ABIs can be found

traces
boolean

include the transaction's traces in the results

uniq
boolean

display a list of uniq addresses found in the transaction

flow
string
Enum: "from" "to"

for the uniq option only, export only from or to (including trace from or to)

logs
boolean

display only the logs found in the transaction(s)

emitter
Array of strings <address> [ items <address > ]

for the --logs option only, filter logs to show only those logs emitted by the given address(es)

topic
Array of strings <topic> [ items <topic > ]

for the --logs option only, filter logs to show only those with this topic(s)

cacheTraces
boolean

force the transaction's traces into the cache

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

cache
boolean

force the results of the query into the cache

decache
boolean

removes related items from the cache

ether
boolean

export values in ether

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "blockHash": "0x3a1fba5abd9d41457944e91ed097e039b7b12d3d7ba324a3f422db2277a48e28",
  • "blockNumber": 52029,
  • "date": "2015-08-08 06:22:55 UTC",
  • "ether": "0",
  • "from": "0x3d0768da09ce77d25e2d998e6a7b6ed4b9116c2d",
  • "gas": 90000,
  • "gasCost": 2516291173295740,
  • "gasPrice": 57380137580,
  • "gasUsed": 43853,
  • "hash": "0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e",
  • "input": "0x432ced044d794669727374436f696e000000000000000000000000000000000000000000",
  • "nonce": 31,
  • "receipt": {
    },
  • "timestamp": 1439014975,
  • "to": "0x5564886ca2c518d1964e5fcea4f423b41db9f561",
  • "traces": [ ],
  • "transactionIndex": 0,
  • "value": "0"
}

Get receipts

Retrieve receipts for the given transaction(s). Corresponds to the chifra receipts command line.

query Parameters
transactions
required
Array of strings <tx_id> [ items <tx_id > ]

a space-separated list of one or more transaction identifiers

articulate
boolean

articulate the retrieved data if ABIs can be found

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

cache
boolean

force the results of the query into the cache

decache
boolean

removes related items from the cache

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "blockNumber": 52029,
  • "from": "0x3d0768da09ce77d25e2d998e6a7b6ed4b9116c2d",
  • "gasUsed": 43853,
  • "logs": [
    ],
  • "status": 1,
  • "to": "0x5564886ca2c518d1964e5fcea4f423b41db9f561",
  • "transactionHash": "0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e",
  • "transactionIndex": 0
}

Get logs

Retrieve logs for the given transaction(s). Corresponds to the chifra logs command line.

query Parameters
transactions
required
Array of strings <tx_id> [ items <tx_id > ]

a space-separated list of one or more transaction identifiers

emitter
Array of strings <address> [ items <address > ]

filter logs to show only those logs emitted by the given address(es)

topic
Array of strings <topic> [ items <topic > ]

filter logs to show only those with this topic(s)

articulate
boolean

articulate the retrieved data if ABIs can be found

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

cache
boolean

force the results of the query into the cache

decache
boolean

removes related items from the cache

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "address": "0x5564886ca2c518d1964e5fcea4f423b41db9f561",
  • "blockHash": "0x3a1fba5abd9d41457944e91ed097e039b7b12d3d7ba324a3f422db2277a48e28",
  • "blockNumber": 52029,
  • "date": "2015-08-08 06:22:55 UTC",
  • "logIndex": 0,
  • "timestamp": 1439014975,
  • "topics": [
    ],
  • "transactionHash": "0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e",
  • "transactionIndex": 0
}

Get traces

Retrieve traces for the given transaction(s). Corresponds to the chifra traces command line.

query Parameters
transactions
required
Array of strings <tx_id> [ items <tx_id > ]

a space-separated list of one or more transaction identifiers

articulate
boolean

articulate the retrieved data if ABIs can be found

filter
string

call the node's trace_filter routine with bang-separated filter

count
boolean

display only the number of traces for the transaction (fast)

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

cache
boolean

force the results of the query into the cache

decache
boolean

removes related items from the cache

ether
boolean

export values in ether

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "action": {
    },
  • "blockHash": "0x3a1fba5abd9d41457944e91ed097e039b7b12d3d7ba324a3f422db2277a48e28",
  • "blockNumber": 52029,
  • "date": "2015-08-08 06:22:55 UTC",
  • "result": {
    },
  • "subtraces": 0,
  • "timestamp": 1439014975,
  • "traceAddress": [ ],
  • "transactionHash": "0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e",
  • "transactionIndex": 0,
  • "type": "call"
}

Get block dates

Find block(s) based on date, blockNum, timestamp, or 'special'. Corresponds to the chifra when command line.

query Parameters
blocks
Array of strings <string> [ items <string > ]

one or more dates, block numbers, hashes, or special named blocks (see notes)

list
boolean

export a list of the 'special' blocks

timestamps
boolean

display or process timestamps

count
boolean

with --timestamps only, returns the number of timestamps in the cache

repair
boolean

with --timestamps only, repairs block(s) in the block range by re-querying from the chain

check
boolean

with --timestamps only, checks the validity of the timestamp data

update
boolean

with --timestamps only, bring the timestamp database forward to the latest block

deep
boolean

with --timestamps --check only, verifies timestamps from on chain (slow)

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

cache
boolean

force the results of the query into the cache

decache
boolean

removes related items from the cache

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "blockNumber": 52029,
  • "date": "2015-08-08 06:22:55 UTC",
  • "name": "firstLog",
  • "timestamp": 1439014975
}

Chain State

Access to account and token state

Get balance(s)

Retrieve account balance(s) for one or more addresses at given block(s). Corresponds to the chifra state command line.

query Parameters
addrs
required
Array of strings <address> [ items <address > ]

one or more addresses (0x...) from which to retrieve balances

blocks
Array of strings <blknum> [ items <blknum > ]

an optional list of one or more blocks at which to report balances, defaults to 'latest'

parts
Array of strings
Items Enum: "balance" "nonce" "code" "proxy" "deployed" "accttype" "some" "all"

control which state to export

changes
boolean

only report a balance when it changes from one block to the next

noZero
boolean

suppress the display of zero balance accounts

call
string

call a smart contract with one or more solidity calls, four-byte plus parameters, or encoded call data strings

articulate
boolean

for the --call option only, articulate the retrieved data if ABIs can be found

proxyFor
string <address>

for the --call option only, redirects calls to this implementation

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

cache
boolean

force the results of the query into the cache

decache
boolean

removes related items from the cache

ether
boolean

export values in ether

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "blockNumber": 13176226,
  • "balance": 258843698360318500,
  • "nonce": 115,
  • "code": "0x",
  • "proxy": "0xd9db270c1b5e3bd161e8c8503c55ceabee709552",
  • "address": "0xa1e4380a3b1f749673e270229993ee55f35663b4",
  • "deployed": 0,
  • "accttype": "EOA",
  • "ether": 0.2588436983603185
}

Get token balance(s)

Retrieve token balance(s) for one or more addresses at given block(s). Corresponds to the chifra tokens command line.

query Parameters
addrs
required
Array of strings <address> [ items <address > ]

two or more addresses (0x...), the first is an ERC20 token, balances for the rest are reported

blocks
Array of strings <blknum> [ items <blknum > ]

an optional list of one or more blocks at which to report balances, defaults to 'latest'

parts
Array of strings
Items Enum: "name" "symbol" "decimals" "totalSupply" "version" "some" "all"

which parts of the token information to retrieve

byAcct
boolean

consider each address an ERC20 token except the last, whose balance is reported for each token

changes
boolean

only report a balance when it changes from one block to the next

noZero
boolean

suppress the display of zero balance accounts

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

cache
boolean

force the results of the query into the cache

decache
boolean

removes related items from the cache

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "holder": "0x2910543af39aba0cd09dbb2d50200b3e800a63d2",
  • "balance": "624980000000000000",
  • "address": "0xbb9bc244d798123fde783fcc1c72d3bb8c189413",
  • "name": "The DAO Original",
  • "decimals": 1,
  • "isContract": true,
  • "isErc20": true,
  • "isErc721": true
}

Admin

Control the scraper and build the index

Manage config

Report on and edit the configuration of the TrueBlocks system. Corresponds to the chifra config command line.

query Parameters
mode
string
Enum: "show" "edit"

either show or edit the configuration

paths
boolean

show the configuration paths for the system

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "clientVersion": "erigon/2021.09.2/linux-amd64/go1.16.3",
  • "trueblocksVersion": "GHC-TrueBlocks//0.12.1-alpha-7ac3196d7-20210903",
  • "rpcProvider": "http://localhost:23456",
  • "configPath": "~/Library/Application Support/TrueBlocks/",
  • "cachePath": "~/Library/Application Support/TrueBlocks/cache/",
  • "indexPath": "~/Library/Application Support/TrueBlocks/unchained/",
  • "isTesting": false,
  • "isArchive": true,
  • "isTracing": true,
  • "hasEskey": true,
  • "hasPinkey": true,
  • "date": "2021-09-03 19:38:19 UTC"
}

Get status on caches

Report on the state of the internal binary caches. Corresponds to the chifra status command line.

query Parameters
modes
Array of strings
Items Enum: "index" "blooms" "blocks" "transactions" "traces" "logs" "statements" "results" "state" "tokens" "monitors" "names" "abis" "slurps" "staging" "unripe" "maps" "some" "all"

the (optional) name of the binary cache to report on, terse otherwise

diagnose
boolean

same as the default but with additional diagnostics

firstRecord
number <uint64>

the first record to process

maxRecords
number <uint64>

the maximum number of records to process

chains
boolean

include a list of chain configurations in the output

healthcheck
boolean

an alias for the diagnose endpoint

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Manage chunks

Manage, investigate, and display the Unchained Index. Corresponds to the chifra chunks command line.

query Parameters
mode
required
string
Enum: "manifest" "index" "blooms" "pins" "addresses" "appearances" "stats"

the type of data to process

blocks
Array of strings <blknum> [ items <blknum > ]

an optional list of blocks to intersect with chunk ranges

check
boolean

check the manifest, index, or blooms for internal consistency

belongs
Array of strings <address> [ items <address > ]

in index mode only, checks the address(es) for inclusion in the given index chunk

firstBlock
number <blknum>

first block to process (inclusive)

lastBlock
number <blknum>

last block to process (inclusive)

maxAddrs
number <uint64>

the max number of addresses to process in a given chunk

deep
boolean

if true, dig more deeply during checking (manifest only)

rewrite
boolean

for the --pin --deep mode only, writes the manifest back to the index folder (see notes)

count
boolean

for certain modes only, display the count of records

sleep
number <float64>

for --remote pinning only, seconds to sleep between API calls

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "fileName": "000000000-000000000",
  • "bloomHash": "QmbCQaYmfTR3sGNAvASoVjPynaY9UD31Hfxv7dGtzsptkb",
  • "indexHash": "QmPmfSrYT5HDpfjj4uYSycaFECo9EqPSuADQ3YPbVp3yu4"
}

Initialize index

Initialize the TrueBlocks system by downloading the Unchained Index from IPFS. Corresponds to the chifra init command line.

query Parameters
all
boolean

in addition to Bloom filters, download full index chunks (recommended)

example
string

create an example for the SDK with the given name

dryRun
boolean

display the results of the download without actually downloading

firstBlock
number <blknum>

do not download any chunks earlier than this block

sleep
number <float64>

seconds to sleep between downloads

chain
string

the chain to use

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Other

Access to other and external data

Slurp Api services

Fetch data from Etherscan and other APIs for any address. Corresponds to the chifra slurp command line.

query Parameters
addrs
required
Array of strings <address> [ items <address > ]

one or more addresses to slurp from Etherscan

blocks
Array of strings <blknum> [ items <blknum > ]

an optional range of blocks to slurp

parts
Array of strings
Items Enum: "ext" "int" "token" "nfts" "1155" "miner" "uncles" "withdrawals" "some" "all"

which types of transactions to request

appearances
boolean

show only the blocknumber.tx_id appearances of the exported transactions

articulate
boolean

articulate the retrieved data if ABIs can be found

source
string
Enum: "etherscan" "key" "covalent" "alchemy"

the source of the slurped data

count
boolean

for --appearances mode only, display only the count of records

page
number <uint64>

the page to retrieve (page number)

pageId
string

the page to retrieve (page ID)

perPage
number <uint64>

the number of records to request on each page

sleep
number <float64>

seconds to sleep between requests

chain
string

the chain to use

noHeader
boolean

suppress the header in the output

cache
boolean

force the results of the query into the cache

decache
boolean

removes related items from the cache

ether
boolean

export values in ether

fmt
string

export format, one of [ txt | csv | json ]

Responses

Response samples

Content type
application/json
{
  • "hash": "0x2ec382949ba0b22443aa4cb38267b1fb5e68e188109ac11f7a82f67571a0adf3",
  • "blockHash": "0xeab8fe9da0b41b2c003db620bb9adbedd5fcc7222cc50d53431aa1df47a20dda",
  • "blockNumber": "46217",
  • "transactionIndex": "0",
  • "timestamp": "1438919451",
  • "from": "0xc8ebccc5f5689fa8659d83713341e5ad19349448",
  • "to": "0xc8ebccc5f5689fa8659d83713341e5ad19349448",
  • "value": "0",
  • "gas": "21000",
  • "gasPrice": "65334370444",
  • "maxFeePerGas": "0",
  • "maxPriorityFeePerGas": "0",
  • "input": "0x",
  • "isError": "0",
  • "hasToken": "0",
  • "gasUsed": "21000",
  • "date": "2015-08-07 03:50:51 UTC",
  • "ether": "0.000000000000000000"
}