GET /v0/state/tables/accounts
stable
Fetches a table from a group of contract accounts, at any block height.
Usage
Most parameters are similar to the /v0/state/table
request, except for the accounts
parameter, which accepts a list of account
separated by the pipe character (|
).
The output format is slightly different too.
Sample request:
curl -H "Authorization: Bearer eyJhbGciOiJLTVNFUzI1Ni..." \
"https://eos.dfuse.eosnation.io/v0/state/tables/accounts?accounts=eosio.token|eosadddddddd|tokenbyeocat|ethsidechain|epraofficial|alibabapoole|hirevibeshvt|oo1122334455|irespotokens|publytoken11|parslseed123|trybenetwork|zkstokensr4u&scope=b1&table=accounts&block_num=25000000&json=true"
fetch('https://eos.dfuse.eosnation.io/v0/state/tables/accounts?accounts=eosio.token|eosadddddddd|tokenbyeocat|ethsidechain|epraofficial|alibabapoole|hirevibeshvt|oo1122334455|irespotokens|publytoken11|parslseed123|trybenetwork|zkstokensr4u&scope=b1&table=accounts&block_num=25000000&json=true', {
headers: {
'Authorization': 'Bearer eyJhbGciOiJLTVNFUzI1Ni...'
}
}).then(console.log)
headers = { 'Authorization' : 'Bearer eyJhbGciOiJLTVNFUzI1Ni...' }
r = requests.get('https://eos.dfuse.eosnation.io/v0/state/tables/accounts?accounts=eosio.token|eosadddddddd|tokenbyeocat|ethsidechain|epraofficial|alibabapoole|hirevibeshvt|oo1122334455|irespotokens|publytoken11|parslseed123|trybenetwork|zkstokensr4u&scope=b1&table=accounts&block_num=25000000&json=true', headers=headers, verify=False)
j = json.loads(r.text)
print(json.dumps(j, indent=4))
req, err := http.NewRequest("GET", "https://eos.dfuse.eosnation.io/v0/state/tables/accounts?accounts=eosio.token|eosadddddddd|tokenbyeocat|ethsidechain|epraofficial|alibabapoole|hirevibeshvt|oo1122334455|irespotokens|publytoken11|parslseed123|trybenetwork|zkstokensr4u&scope=b1&table=accounts&block_num=25000000&json=true", nil)
if err != nil {
// handle err
}
req.Header.Set("Authorization", "Bearer eyJhbGciOiJLTVNFUzI1Ni...")
resp, err := http.DefaultClient.Do(req)
if err != nil {
// handle err
}
defer resp.Body.Close()
Requesting past blocks & ABI handling
This request exhibits the same patterns as the simpler /v0/state/table query.
Input Parameters
accounts
required
String
An AccountName list, separated by the pipe character
|
, a maximum of 1500 elements can be present in the list.
scope
required
Name
The name-encoded scope of the table you are requesting. For example, user balances for tokens live in their account name’s scope. This is contract dependent, so inspect the ABI for the contract you are interested in.
table
required
TableName
The name-encoded table name you want to retrieve. For example, user balances for tokens live in the
accounts
table. Refer to the contract’s ABI for a list of available tables. This is contract dependent.
block_num
Optional
Number
Defaults to head block num. The block number for which you want to retrieve the consistent table snapshot.
json
Optional
Boolean
Defaults to
false
. Decode each row from its binary form into JSON. If json: false
, then hexadecimal representation of its binary data is returned instead.
key_type
Optional
String
Defaults to
name
. How to represent the row keys in the returned table.
with_block_num
Optional
Boolean
Defaults to
false
. Will return one block_num
with each row. Represents the block at which that row was last changed.
with_abi
Optional
Boolean
Defaults to
false
. Return the ABI in effect at block block_num
.
Key Type
The key type can be one of the following values:
name
(default) for EOS name-encoded base32 representation of the row keyhex
for hexadecimal encoding, ex:abcdef1234567890
hex_be
for big endian hexadecimal encoding, ex:9078563412efcdab
uint64
for string encoded uint64. Beware: uint64 can be very large numbers and some programming languages need special care to decode them without truncating their value. This is why they are returned as strings.
Response
Returns a MultiStateResponse, same as the multi-scopes endpoint.