Queries

Query the Blockchain

Usage: ioctl bc info

➜  ioctl bc info
Blockchain Node: api.iotex.one:443
{
  "height": 11283255,
  "numActions": 14393325,
  "tps": 1,
  "epoch": {
    "num": 18194,
    "height": 11282761
  },
  "tpsFloat": 0.29090908
}

Query Block

Usage: ioctl bc block [HEIGHT|HASH]

➜  ioctl bc block
Blockchain Node: api.iotex.one:443
{
  "hash": "b73d48301aa75ab2f6c6e3350abb4b050852eebd89a333f9b2f412c9011f37ba",
  "height": 11283260,
  "timestamp": {
    "seconds": 1621955365
  },
  "numActions": 1,
  "producerAddress": "io1ddjluttkzljqfgdtcz9eu3r3s832umy7ylx0ts",
  "transferAmount": "0",
  "txRoot": "d401ba17a772340f6aa0284357fa65758c9063c755c25721cab86e3b674e096b",
  "receiptRoot": "8205af86ab185619edf8cb2279774bf5c3b322fb1ad7855719f8f29ac50734a4",
  "deltaStateDigest": "835b130e5fe7333da7287b4a61011bf575cfef2386c58e2eedf8c100007aeed0",
  "logsBloom": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
  "previousBlockHash": "ec1d8f515ffc90cc2c549b6d9ae0ff07d6d9681137f4fe40d78e9d8f10228d8d"
}

➜  ioctl bc block 101
Blockchain Node: api.iotex.one:443
{
  "hash": "1930df275ea54c87fcdd3909e0382c26fc14aa970433e6a6302eb393c829634e",
  "height": 101,
  "timestamp": {
    "seconds": 1555899830
  },
  "numActions": 1,
  "producerAddress": "io1vtm2zgn830pn6auc2cvnchgwdaefa9gr4z0s86",
  "transferAmount": "0",
  "txRoot": "5a94b4defdc18cf84e6515f9c125052cc1aedf27c6be2a378acd34a47ab2a286",
  "receiptRoot": "3066ce28bd35faf02e98d2821eb2aa94fff31cca71f93675fea4a58f0963ab66",
  "deltaStateDigest": "a9f953c5b5e71a2dba36e3caa7b2aeb6c1722f5d8d2bbbe08e9af849e40adc40",
  "previousBlockHash": "ac661375315b444ad4feff5e96db11eb01d55af2a850f5504180c8bf8a4d39f4"
}

➜  ioctl bc block 1930df275ea54c87fcdd3909e0382c26fc14aa970433e6a6302eb393c829634e                                      1 ↵
Blockchain Node: api.iotex.one:443
{
  "hash": "1930df275ea54c87fcdd3909e0382c26fc14aa970433e6a6302eb393c829634e",
  "height": 101,
  "timestamp": {
    "seconds": 1555899830
  },
  "numActions": 1,
  "producerAddress": "io1vtm2zgn830pn6auc2cvnchgwdaefa9gr4z0s86",
  "transferAmount": "0",
  "txRoot": "5a94b4defdc18cf84e6515f9c125052cc1aedf27c6be2a378acd34a47ab2a286",
  "receiptRoot": "3066ce28bd35faf02e98d2821eb2aa94fff31cca71f93675fea4a58f0963ab66",
  "deltaStateDigest": "a9f953c5b5e71a2dba36e3caa7b2aeb6c1722f5d8d2bbbe08e9af849e40adc40",
  "previousBlockHash": "ac661375315b444ad4feff5e96db11eb01d55af2a850f5504180c8bf8a4d39f4"
}

Query Staking Bucket Information

Usage: ioctl bc bucketlist [ALIAS|ADDRESS]

➜  ioctl bc bucketlist daddypig
Blockchain Node: api.testnet.iotex.one:443
{
    index: 56
    owner: io1gh439pm67d4cwxt882xpylj75klys6esepml60
    candidate: io1q2whygmmzphr22fh5703l04jz5kh9thj9dgs99
    stakedAmount: 232 IOTX
    stakedDuration: 7 days
    autoStake: false
    createTime: 2020-05-21T13:10:10Z
    stakeStartTime: 2020-05-21T13:28:25Z
    unstakeStartTime: none
}

Query Buckets By Candidate

Usage: ioctl bc bucketlist cand [CANDIDATE_NAME] [OFFSET] [LIMIT]

➜  ioctl bc bucketlist cand longz 0 10
Blockchain Node: api.testnet.iotex.one:443
{
    index: 34
    owner: io120au9ra0nffdle04jx2g5gccn6gq8qd4fy03l4
    candidate: io1t56twy23yjuqscljpjc869hyqw3gpswwj0g228
    stakedAmount: 100 IOTX
    stakedDuration: 7 days
    autoStake: false
    createTime: 2020-05-11T06:41:20Z
    stakeStartTime: 2020-05-11T06:41:20Z
    unstakeStartTime: none
}
{
    index: 43
    owner: io120au9ra0nffdle04jx2g5gccn6gq8qd4fy03l4
    candidate: io1l40dc4q95fsjdprhcga5qrpdsj46q3wpzr27n9
    stakedAmount: 170 IOTX
    stakedDuration: 14 days
    autoStake: false
    createTime: 2020-05-14T02:42:15Z
    stakeStartTime: 2020-05-14T02:42:15Z
    unstakeStartTime: none
}

Query Buckets By Voter

Usage: ioctl bc bucketlist voter [VOTER_ADDRESS] [OFFSET] [LIMIT]

➜  ioctl bc bucketlist voter tmp2 0 10
Blockchain Node: api.testnet.iotex.one:443
{
    index: 34
    owner: io120au9ra0nffdle04jx2g5gccn6gq8qd4fy03l4
    candidate: io1t56twy23yjuqscljpjc869hyqw3gpswwj0g228
    stakedAmount: 100 IOTX
    stakedDuration: 7 days
    autoStake: false
    createTime: 2020-05-11T06:41:20Z
    stakeStartTime: 2020-05-11T06:41:20Z
    unstakeStartTime: none
}
{
    index: 43
    owner: io120au9ra0nffdle04jx2g5gccn6gq8qd4fy03l4
    candidate: io1l40dc4q95fsjdprhcga5qrpdsj46q3wpzr27n9
    stakedAmount: 170 IOTX
    stakedDuration: 14 days
    autoStake: false
    createTime: 2020-05-14T02:42:15Z
    stakeStartTime: 2020-05-14T02:42:15Z
    unstakeStartTime: none
}

Query Bucket By Index

Usage: ioctl bc bucket [BUCKET_INDEX]

➜  ioctl bc bucket 56
Blockchain Node: api.testnet.iotex.one:443
{
	index: 56
	owner: io19n5sqmreq4tk7w7xevnwms9ux8h7kuemjrjlf7
	candidate: io1xrcfzdmujtr9hvmrm58yxvhe5djahdzt30ljs2
	stakedAmount: 100 IOTX
	stakedDuration: 0 days
	autoStake: false
	createTime: 2020-06-01T18:32:35Z
	stakeStartTime: 2020-06-01T18:32:35Z
	unstakeStartTime: none
}

Query Delegates

Usage: ioctl node delegate [ -a | -e epoch-num]

Get the list of block producers:

➜  ioctl node delegate
Epoch: 18194,  Start block height: 11282761,Total blocks produced in epoch: 542

Address                                     Name           Rank   Alias   Status   Blocks   ProbatedStatus    Votes
io1jzteq7gc5sh8tfp5auz8wwj97kvdapr9y8wzne   binancevote       1                    0                        414565318.738108275911974163
io10reczcaelglh5xmkay65h9vw3e5dp82e8vw0rz   metanyx           2                    0                        209094580.94368987269441618
io189zlpedmhs3cg4zhyle2u8f9shkztwd3n3d7zd   satoshimusk       3           active   22                       141597515.304090309742324742
io1tfke5nfwryte6nultpmqefadgm0dsahm2gm63k   iotexlab          4                    0                        104597977.604617043282262392
...                                         ...              ..              ...   ..                            ... 
io1u4pev9u5as7ujpk29wpsrc95m8kuhec3pmuk72   hashquark        35           active   23                       46788920.335452899578834654
io1l42qgv8328h8x7pde35w3szh59elhw8nwmcy6j   cryptozoo        36           active   22                       45750281.527141635145186376

Get the list of block producers in a specific epoch

➜  ioctl node delegate -e 30382
Epoch: 30382,  Start block height: 11282041,Total blocks produced in epoch: 160

Address                                     Name           Rank   Alias   Status   Blocks   ProbatedStatus    Votes
io1jzteq7gc5sh8tfp5auz8wwj97kvdapr9y8wzne   binancenode       1           active   7                        421189313.21951484732369643
io10reczcaelglh5xmkay65h9vw3e5dp82e8vw0rz   metanyx           2           active   6                        214481263.190726384852101376
io1tfke5nfwryte6nultpmqefadgm0dsahm2gm63k   iotexlab          3                    0                        167629088.879462427298828393
io1k4gmu8uha4qgq84zyf7vdesqahm5wnwadx5mwt   unifi             4           active   6                        122598307.156432301321242613
...                                         ...              ..              ...   ..                            ... 
io17cmrextyfeu4gddwd89g5qncedsnc553dhz7xa   infstones        35                    0                        52488623.558764051519720611
io1e5vwdmpkf2hpu2266hx9syu0ursqgqwv0kzrxm   enlightiv        36                    0                        49597439.555716235583198735

Get the full list of delegates:

➜  ioctl node delegate -a
Epoch: 30382,  Start block height: 20058121,Total blocks produced in epoch: 160

Address                                     Name           Rank   Alias   Status   Blocks   ProbatedStatus    Votes
io1jzteq7gc5sh8tfp5auz8wwj97kvdapr9y8wzne   binancenode       1           active   7                        421189313.21951484732369643
io10reczcaelglh5xmkay65h9vw3e5dp82e8vw0rz   metanyx           2           active   6                        214481263.190726384852101376
io1tfke5nfwryte6nultpmqefadgm0dsahm2gm63k   iotexlab          3                    0                        167629088.879462427298828393
io1k4gmu8uha4qgq84zyf7vdesqahm5wnwadx5mwt   unifi             4           active   6                        122598307.156432301321242613
...                                         ...             ...                  ...                        ...
io1cxkxvuu4y8fhqfz8w39fdj9vsn0f0pkkwx7ums   kita             80                    0                        62313.531691564845144901
io1t3vhcc0g0qsj4g90q64aj7gv3h0sg6y7gcp30r   citex2018        81                    0                        59458.175525066955950388

Query Probation List

Usage: ioctl node probationlist [-e epoch-num]

➜  ioctl node probationlist
EpochNumber : 4985, IntensityRate : 90%
ProbationList : [
  "io1gh439pm67d4cwxt882xpylj75klys6esepml60"
]

➜  ioctl node probationlist -e 4500
EpochNumber : 4500, IntensityRate : 90%
ProbationList : [
  "io13n3382cjhaawmqfk4vmvvgllnryw4tf56qdtks",
  "io1gh439pm67d4cwxt882xpylj75klys6esepml60"
]

Query Reward

Usage: ioctl node reward unclaimed|pool [ALIAS|DELEGATE_ADDRESS]

➜  ioctl node reward unclaimed whale
io1t54nfdnpldaxkpm35f2gzh3rx6cakypmp5xfz5: 45819 IOTX

➜  ioctl node reward pool
Total Unclaimed:	 26567469.425867808134990226 IOTX
Total Available:	 720630085.427229243274397982 IOTX
Total Balance:		 747197554.853097051409388208 IOTX