Explorer API - BytomDAO/bytom-classic GitHub Wiki
The API provides you with a convenient, powerful and simple way to read data from the bytom network and build your own services with it. The API allows to use the real-time analytical data about bytom blockchain transactions, addresses and assets. Below is the list of APIs, 1 request per second. Please do not exceed the limits or you'll be banned. If you have specific needs, please let us know, we are ready to help you.
API Host
Default api host:
| Network | URL |
|---|---|
| mainnet | https://blockmeta.com/api/v2 |
| testnet | https://blockmeta.com/api/wisdom |
A complete request example via curl:
// curl -X GET url/method
curl -X GET https://blockmeta.com/api/v2/blocks
API Methods
address
Get address asset balance,receive asset amount,sent asset amount and recent transactions.
Method
- /address/<string:address>
- /address/<string:address>/asset/<string:asset_id>
Parameters
String- address, address of account
optional:
String- asset_id, asset_idInteger- page, page number of address transactionsInteger- limit, transaction number per page
Example
// Request
curl -X GET https://blockmeta.com/api/v2/address/bm1qsk6dj6pym7yng0ev7wne7tm3d54ea2sjz5tyxk?limit=1&page=1
// Response
{
"address": "bm1qsk6dj6pym7yng0ev7wne7tm3d54ea2sjz5tyxk",
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"balance": 154263689273022,
"receive": 382483033706493,
"sent": 228219344433471,
"join_timestamp": 1525523171,
"miner": 0,
"transactions": [
{
"id": "7cce3bcf4fc261fd7693fffc4c71d092e97624e24529a386a49cbfdc222bbe76",
"version": 1,
"size": 81,
"time_range": 0,
"status_fail": false,
"mux_id": "08514648d1ef7643f19db5f1ca4b456a6237d410001e8c75c03c6e9eb9efbc85",
"height": 66586,
"chain_status": "mainnet",
"coinbase": 1,
"detail": [
{
"type": "coinbase",
"asset_id": "0000000000000000000000000000000000000000000000000000000000000000",
"amount": 0,
"arbitrary": "003636353836",
"transaction_id": "7cce3bcf4fc261fd7693fffc4c71d092e97624e24529a386a49cbfdc222bbe76",
"io": 0
},
{
"type": "control",
"id": "f23771e954386c7c86d5a41e5bbaa03c61d8e1c4397c762143a9176b9a432ae4",
"position": 0,
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"amount": 41250000000,
"control_program": "001485b4d96824df89343f2cf3a79f2f716d2b9eaa12",
"address": "bm1qsk6dj6pym7yng0ev7wne7tm3d54ea2sjz5tyxk",
"transaction_id": "7cce3bcf4fc261fd7693fffc4c71d092e97624e24529a386a49cbfdc222bbe76",
"io": 1
}
]
}
],
"pagination": {
"current": 1,
"limit": 1,
"total": 9532
}
}
asset
Get asset details by asset id.
Method
/asset/<string:asset_id>
Parameters
String- asset_id, asset_id
optional:
Integer- page, page number of asset transactionsInteger- limit, transaction number per page
Example
// Request
curl -X GET https://blockmeta.com/api/v2/asset/04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141?page=1&limit=1
// Response
{
"issuance_program": "ae20dd98f21845f4e7c76224fd870a47ab9425210075ed4281ecd6ed1085f25b4c7a5151ad",
"total_amount": 1000000000000,
"decimals": 8,
"description": "",
"name": "",
"symbol": "",
"issue_timestamp": 1527315522,
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"transactions": [
{
"id": "7f706976ca9f85bdf9dabdfa1f9e2cfb3364795f90f58b8f644deb8b00246399",
"version": 1,
"size": 595,
"time_range": 0,
"status_fail": false,
"mux_id": "8e495d3b10756fccf37d3107f148ad18b4ecaa42a1410b3183c3d4360cace985",
"height": 37425,
"chain_status": "mainnet",
"coinbase": 0,
"detail": [
{
"type": "spend",
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"amount": 668600000,
"control_program": "0014242b44609cb269ac51c9cb00913b3107b382ded9",
"address": "bm1qys45gcyukf56c5wfevqfzwe3q7ec9hkej65lfd",
"spent_output_id": "b8ff07e2e174ae3f94537604a64ad9b98b5fa61de4e476c7230aacbf75ebb7b5",
"transaction_id": "7f706976ca9f85bdf9dabdfa1f9e2cfb3364795f90f58b8f644deb8b00246399",
"io": 0
},
{
"type": "spend",
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"amount": 997700000000,
"control_program": "0014b276cf1001cbb171d63620915d9f558348db6dad",
"address": "bm1qkfmv7yqpewchr43kyzg4m864sdydkmddp5mfxf",
"spent_output_id": "839719c68fbe8a7f780663e713805a2c581b4943ba24b8653b7d35a00a273d55",
"transaction_id": "7f706976ca9f85bdf9dabdfa1f9e2cfb3364795f90f58b8f644deb8b00246399",
"io": 0
},
{
"type": "control",
"id": "8a55da87a17f0fa5c132a53e5c11e62c3254b7dfa09deed71c5b579b62ba20e5",
"position": 0,
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"amount": 667700000,
"control_program": "001410d780309dfb4aefda4e49bbf1a01881c465fe9e",
"address": "bm1qzrtcqvyald9wlkjwfxalrgqcs8zxtl57tea5cw",
"transaction_id": "7f706976ca9f85bdf9dabdfa1f9e2cfb3364795f90f58b8f644deb8b00246399",
"io": 1
},
{
"type": "control",
"id": "7264906e06e4709817c230955bc8786be2a6e5a69cc223780e70681f7ea96fd3",
"position": 1,
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"amount": 997200000000,
"control_program": "0014b8b64446c452d3e377ba62ab3f0c8650002a20eb",
"address": "bm1qhzmyg3ky2tf7xaa6v24n7ryx2qqz5g8ty4jcrc",
"transaction_id": "7f706976ca9f85bdf9dabdfa1f9e2cfb3364795f90f58b8f644deb8b00246399",
"io": 1
},
{
"type": "control",
"id": "049c4fb1367f6675645f523cc943a6a6c41b069072d60711f088b92061f2fa4b",
"position": 2,
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"amount": 500000000,
"control_program": "0014c1dcaedc48e0b3c029485d509a0fca157e987f31",
"address": "bm1qc8w2ahzguzeuq22gt4gf5r72z4lfsle3ltk8d2",
"transaction_id": "7f706976ca9f85bdf9dabdfa1f9e2cfb3364795f90f58b8f644deb8b00246399",
"io": 1
}
]
}
],
"pagination": {
"current": 1,
"limit": 1,
"total": 9
}
}
assets
Get assets issued on bytom network
Method
/assets
Parameters
optional:
Integer- page, page number of assetsInteger- limit, asset number per page
Example
// Request
curl -X GET https://blockmeta.com/api/v2/assets?page=3&limit=10
// Response
{
"assets": [
{
"issuance_program": "ae2067efe306cb96f7f481bd88c6325a77900d32b276e64a8a576c06f5f7bf6988e95151ad",
"total_amount": 210000000000000000,
"decimals": 8,
"description": "Bytom Official Issue",
"name": "BTM",
"symbol": "BTM",
"s_timestamp": 1533010776.991276,
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff"
},
{
"issuance_program": "ae20237e66a9ef0b181c5b15ef6fc74e2f331c83aa6cb5606315f34eb81817c489c45151ad",
"total_amount": 8400000000000000,
"decimals": 8,
"description": "",
"name": "",
"symbol": "",
"issue_timestamp": 1533021975,
"s_timestamp": 1533022247.9164958,
"asset_id": "ce0ba852a65dfa445548e3a66f78aec1fd3011f74b7268ed0e0598928706ae80"
},
{
"issuance_program": "ae204f92fc3eb7c82cd27471966a098187583ce6d6bd02264c04e5d148df35fe8eed5151ad",
"total_amount": 1000000000000000000,
"decimals": 8,
"description": "",
"name": "",
"symbol": "",
"issue_timestamp": 1533092470,
"s_timestamp": 1533092546.611149,
"asset_id": "d5e348366a1c341dc60759e0de102bded16a3565c6038ffbe846a54073750e68"
}
],
"pagination": {
"current": 3,
"limit": 10,
"total": 3
}
}
block
Get block by block height or block hash
Method
- /block/<int:height>
- /block/<string:hash>
Parameters
Integer- height, block heightString- hash, block hash
Example
// Request
curl -X GET https://blockmeta.com/api/v2/block/58680
curl -X GET https://blockmeta.com/api/v2/block/844e8d97fa66980f603f5a8f626dc610d3891058e056e0aa13797196fe704754
// Response
{
"hash": "844e8d97fa66980f603f5a8f626dc610d3891058e056e0aa13797196fe704754",
"size": 414,
"version": 1,
"height": 58680,
"previous_block_hash": "359912beb873c9526ff223393e2b84ce0100d7a47d90463fa036e0e73177d0d8",
"timestamp": 1531984680,
"nonce": 229687365138347316,
"bits": 2017612633070008956,
"difficulty": "8977184039",
"transaction_merkle_root": "1f3f8260d63899be7e92fa33e6e4a60eb0acca08885abc3672c993c29cd9ed56",
"transaction_status_hash": "c9c377e5192668bc0a367e4a4764f11e7c725ecced1d7b6a492974fab1b6d5bc",
"hash_rate": 280537001,
"transaction_count": 1,
"chain_status": "mainnet",
"transactions": [
{
"id": "a641f07626381617303dedc3fa17a797982f30fc2e49a9abe98193b5aa5d743a",
"version": 1,
"size": 81,
"time_range": 0,
"status_fail": false,
"mux_id": "3ea24fade77a8dee0110bfc8a90397344d31aa7de67d88e60641294c29e4c4bc",
"height": 58680,
"chain_status": "mainnet",
"coinbase": 1,
"detail": [
{
"type": "coinbase",
"asset_id": "0000000000000000000000000000000000000000000000000000000000000000",
"amount": 0,
"arbitrary": "003538363830",
"transaction_id": "a641f07626381617303dedc3fa17a797982f30fc2e49a9abe98193b5aa5d743a",
"io": 0
},
{
"type": "control",
"id": "f0937105fa1b60527d9ca475a2780e57e4e9708342ff2dcc963be52cd7ce08e8",
"position": 0,
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"amount": 41250000000,
"control_program": "0014c190f77b1e7adadae97e69a6a7d7762649c6e04f",
"address": "bm1qcxg0w7c70tdd46t7dxn204mkyeyudcz063s49e",
"transaction_id": "a641f07626381617303dedc3fa17a797982f30fc2e49a9abe98193b5aa5d743a",
"io": 1
}
]
}
]
}
blocks
Get latest blocks
Method
/blocks
Parameters
optional:
Integer- page, page number of blocksInteger- limit, block number per page
Example
// Request
curl -X GET https://blockmeta.com/api/v2/blocks?page=1&limit=10
// Response
{
"blocks": [
{
"hash": "3715fc97b05258e95fa94020c76a827c901b8837fb16b86f3468781e70ca9d62",
"size": 30552,
"version": 1,
"height": 66692,
"previous_block_hash": "3350cd6f58095d1745d8e95588cab3157652bdcbe1d0c38ab5138b07b7aa07e1",
"timestamp": 1533123349,
"nonce": 4613934258141154516,
"bits": 2017612633068329013,
"difficulty": "11353365045",
"transaction_merkle_root": "4e21072695092af28edfeedd96599e00999eddcb640b264f8d448e3289612a08",
"transaction_status_hash": "cc25f1c0862b2b31d43d4dfb8e2a6b4e4c7e4a3ec18127494e349747e327d336",
"hash_rate": 241560958,
"transaction_count": 46,
"chain_status": "mainnet"
},
{
"hash": "3350cd6f58095d1745d8e95588cab3157652bdcbe1d0c38ab5138b07b7aa07e1",
"size": 3090,
"version": 1,
"height": 66691,
"previous_block_hash": "ba46306d4a6b5d1fe9054d034fb65756b9ef3e89c6bbfa6917c670d6f47d42bd",
"timestamp": 1533123302,
"nonce": 89640530873195,
"bits": 2017612633068329013,
"difficulty": "11353365045",
"transaction_merkle_root": "137ee94fe7a30cd0882e1b2e7172f4ad7f7722f7c4cf90be647702e897b79c1d",
"transaction_status_hash": "ca8e7c022f80a5d5dbc02b8a73234c9ab9069fa0db0f235b2fb8ccd1d6036069",
"hash_rate": 55113422,
"transaction_count": 5,
"chain_status": "mainnet"
},
{
"hash": "ba46306d4a6b5d1fe9054d034fb65756b9ef3e89c6bbfa6917c670d6f47d42bd",
"size": 14476,
"version": 1,
"height": 66690,
"previous_block_hash": "f49f8eb7c99a6450f58d151cd925fa98fd999783a21019e2df94c85e25dac8f1",
"timestamp": 1533123096,
"nonce": 3602968342337572314,
"bits": 2017612633068329013,
"difficulty": "11353365045",
"transaction_merkle_root": "8b25a36e78568c326d5eb4d2e867e2469da4479fa5ea31ab83c3e57abcd4cb6e",
"transaction_status_hash": "aa210fec0e249e9121e51546c9c9c3e3e3515ceb8e065511a64b218a442dc34e",
"hash_rate": 103212409,
"transaction_count": 22,
"chain_status": "mainnet"
},
{
"hash": "f49f8eb7c99a6450f58d151cd925fa98fd999783a21019e2df94c85e25dac8f1",
"size": 1754,
"version": 1,
"height": 66689,
"previous_block_hash": "40b0f92cfeb3399bf0bc1f2ca2928251cb45448cf55bf7491952442dca276db7",
"timestamp": 1533122986,
"nonce": 4323828896408748377,
"bits": 2017612633068329013,
"difficulty": "11353365045",
"transaction_merkle_root": "58b875a9273d86b233ce1312a7cbbc81db3f801127ef2a14936917fe06e022e2",
"transaction_status_hash": "a4489d66751139d2d3f120b2dacf4a8c52e6cadd7de603dc8ef1c66c350cba74",
"hash_rate": 810954646,
"transaction_count": 3,
"chain_status": "mainnet"
},
{
"hash": "40b0f92cfeb3399bf0bc1f2ca2928251cb45448cf55bf7491952442dca276db7",
"size": 32558,
"version": 1,
"height": 66688,
"previous_block_hash": "3ff5d46b3534c38cc70728143565ae921826446d4194c6fd50e0e517a3af6eb0",
"timestamp": 1533122972,
"nonce": 91358249423491,
"bits": 2017612633068329013,
"difficulty": "11353365045",
"transaction_merkle_root": "b676607fd5b141bc1bbd23ee08eace3c54278aad20845af95ac0f2e469455b4b",
"transaction_status_hash": "7f8b345fd77260927f389ecb461255d7aa0b16a92bb943f6575b6406cff28051",
"hash_rate": 33003968,
"transaction_count": 49,
"chain_status": "mainnet"
},
{
"hash": "3ff5d46b3534c38cc70728143565ae921826446d4194c6fd50e0e517a3af6eb0",
"size": 9124,
"version": 1,
"height": 66687,
"previous_block_hash": "42c6d38a72136b818e08b5e4ac67224028c873526d4dd81ac132dc0caae372e4",
"timestamp": 1533122628,
"nonce": 74031462222925425,
"bits": 2017612633068329013,
"difficulty": "11353365045",
"transaction_merkle_root": "35acfb92df484b57a4e362486c0bb241c95ad9e8880ee4dff96ed86bf7405d84",
"transaction_status_hash": "06208aecbc8ebbba0fe1c6c8ecaed7898d4e9fc567af6289c242cf34dae958af",
"hash_rate": 157685625,
"transaction_count": 14,
"chain_status": "mainnet"
},
{
"hash": "42c6d38a72136b818e08b5e4ac67224028c873526d4dd81ac132dc0caae372e4",
"size": 1754,
"version": 1,
"height": 66686,
"previous_block_hash": "d6a78e1f6b5ce84b042922e12efec2a827928735cbb9b3536154a7ac8104a5ed",
"timestamp": 1533122556,
"nonce": 91083873957844322,
"bits": 2017612633068329013,
"difficulty": "11353365045",
"transaction_merkle_root": "7d075cbb8b797313ac90dc4aea9be649dc6504a5d3406c9b81806c455b2a55b2",
"transaction_status_hash": "a4489d66751139d2d3f120b2dacf4a8c52e6cadd7de603dc8ef1c66c350cba74",
"hash_rate": 202738661,
"transaction_count": 3,
"chain_status": "mainnet"
},
{
"hash": "d6a78e1f6b5ce84b042922e12efec2a827928735cbb9b3536154a7ac8104a5ed",
"size": 39932,
"version": 1,
"height": 66685,
"previous_block_hash": "c0b1eb3ef3e90e15acfaba57b6250c30bd5b1f564b7f9765787b670378a35bdc",
"timestamp": 1533122500,
"nonce": 4194339850092046483,
"bits": 2017612633068329013,
"difficulty": "11353365045",
"transaction_merkle_root": "651a0b0ca5dd4a1ebe56324f953ef0ecb99a63e08f526ba7e288e19186b7184b",
"transaction_status_hash": "a6b4433cd4cc98934a0334509aff9d2dea0ba685cbffb0db4c03eaf693a1a945",
"hash_rate": 13049844,
"transaction_count": 60,
"chain_status": "mainnet"
},
{
"hash": "c0b1eb3ef3e90e15acfaba57b6250c30bd5b1f564b7f9765787b670378a35bdc",
"size": 1754,
"version": 1,
"height": 66684,
"previous_block_hash": "03266dfef52a070aa530eb0fd2888125283301c37f9645abdd8eeae32d96044f",
"timestamp": 1533121630,
"nonce": 4770121628526893245,
"bits": 2017612633068329013,
"difficulty": "11353365045",
"transaction_merkle_root": "f7dee684af790dd4206de4c119087e5df3599226cae65f17d96bbae0092838e1",
"transaction_status_hash": "a4489d66751139d2d3f120b2dacf4a8c52e6cadd7de603dc8ef1c66c350cba74",
"hash_rate": 1032124095,
"transaction_count": 3,
"chain_status": "mainnet"
},
{
"hash": "03266dfef52a070aa530eb0fd2888125283301c37f9645abdd8eeae32d96044f",
"size": 5774,
"version": 1,
"height": 66683,
"previous_block_hash": "827da542f0da085ca66a2e83df2d53f20f2d906e5e3b1f2a4720327cb83039c7",
"timestamp": 1533121619,
"nonce": 76625012584420006,
"bits": 2017612633068329013,
"difficulty": "11353365045",
"transaction_merkle_root": "baa16a745a24d4b3cb2ae2244f93630f6249d01a226050e985da218ec37e7165",
"transaction_status_hash": "3c1af31e7207e35fb156b258d53fabb0a3d3dab4dda3080d396494fb188c340c",
"hash_rate": 283834126,
"transaction_count": 9,
"chain_status": "mainnet"
}
],
"pagination": {
"current": 1,
"limit": 10,
"total": 6670
}
}
daily
Get daily statistic of bytom network
Method
/stat/daily
Parameters
optional:
Integer- from, start timestamp of statisticInteger- to, end timestamp of statistic
Example
// Request
curl -X GET https://blockmeta.com/api/v2/stat/daily
// Response
[
{
"date": "2018-08-01",
"mainnet_block_count": 377,
"orphan_block_count": 1,
"transaction_count": 488,
"transaction_amount": 1261058177984834,
"transaction_fee": 1067204216,
"transaction_gas": 5336021.08,
"new_address_count": 102,
"new_asset_count": 1
}
]
difficulty
Get difficulty statistic of bytom network
Method
/stat/difficulty
Parameters
optional:
Integer- from, start timestamp of statisticInteger- to, end timestamp of statistic
Example
// Request
curl -X GET https://blockmeta.com/api/v2/stat/difficulty?from=1530874300&to=15312384200
// Response
[
{
"change_time": "2018-07-08 04:45:51",
"difficulty": 10452505013,
"change_rate": "14.3%"
},
{
"change_time": "2018-07-12 04:00:51",
"difficulty": 9217527092,
"change_rate": "-11.82%"
},
{
"change_time": "2018-07-15 20:49:28",
"difficulty": 8721820207,
"change_rate": "-5.38%"
},
{
"change_time": "2018-07-19 06:28:40",
"difficulty": 8977184039,
"change_rate": "2.93%"
},
{
"change_time": "2018-07-22 19:20:11",
"difficulty": 8883415522,
"change_rate": "-1.04%"
},
{
"change_time": "2018-07-26 03:21:49",
"difficulty": 9322699206,
"change_rate": "4.94%"
},
{
"change_time": "2018-07-29 02:45:08",
"difficulty": 10964255885,
"change_rate": "17.61%"
},
{
"change_time": "2018-08-01 11:53:14",
"difficulty": 11353365045,
"change_rate": "3.55%"
}
]
hash-rate
Get hash rate statistic of bytom network
Method
/stat/hash-rate
Parameters
optional:
Integer- from, start timestamp of statisticInteger- to, end timestamp of statistic
Example
// Request
curl -X GET https://blockmeta.com/api/v2/stat/difficulty?from=1530874300&to=15312384200
// Response
[
[
1533052800,
63422994.50333333
],
[
1533056400,
61562406.08166666
],
[
1533060000,
71880656.02
],
[
1533063600,
75958760.63583334
],
[
1533067200,
93855763.4063889
],
[
1533070800,
59036902.51777778
],
[
1533074400,
78712127.97944444
],
[
1533078000,
53553248.29472222
],
[
1533081600,
90436467.12472223
],
[
1533085200,
86353272.05444445
],
[
1533088800,
75134306.41916667
],
[
1533092400,
86312727.75277779
],
[
1533096000,
65323902.23888889
],
[
1533099600,
72487528.42305556
],
[
1533103200,
56278212.83
],
[
1533106800,
67019420.557222225
],
[
1533110400,
66181084.608333334
],
[
1533114000,
51030506.395833336
],
[
1533117600,
85207861.46222222
]
]
miner
Get miner statistic of bytom network
Method
/stat/miner
Parameters
optional:
Integer- from, start timestamp of statisticInteger- to, end timestamp of statistic
Example
// Request
curl -X GET https://blockmeta.com/api/v2/stat/miner?from=1533052800&to=1533139200
// Response
[
{
"address": "bm1q3yt265592czgh96r0uz63ta8fq40uzu5a8c2h0",
"name": "鱼池",
"mine_block_count": 198,
"percent": "49.75%"
},
{
"address": "bm1qcxg0w7c70tdd46t7dxn204mkyeyudcz063s49e",
"name": "双U",
"mine_block_count": 79,
"percent": "19.85%"
},
{
"address": "bm1qp92dpx6c69zrz9gwyde8glpww29yjlu7lxyf2y",
"name": "国池",
"mine_block_count": 40,
"percent": "10.05%"
},
{
"address": "bm1qsk6dj6pym7yng0ev7wne7tm3d54ea2sjz5tyxk",
"name": "未知矿池1号",
"mine_block_count": 30,
"percent": "7.54%"
},
{
"address": "bm1qap4qk88n6sk388lfy55s9z8antz5avp5z3spqp",
"name": "蜘蛛",
"mine_block_count": 25,
"percent": "6.28%"
},
{
"address": "bm1q2lm5c7ajtutcjzhr4cvuge385ygynupe90m7xj",
"name": "蚂蚁",
"mine_block_count": 12,
"percent": "3.02%"
},
{
"address": "bm1q3jymk8ruwslvx568qh98y2u7wuqhaz8gf3pt3q",
"name": "未知矿池",
"mine_block_count": 7,
"percent": "1.76%"
},
{
"address": "bm1qxlvtg7078znef59g039h9f5k40atz7j05s7y3q",
"name": "未知矿池",
"mine_block_count": 6,
"percent": "1.51%"
},
{
"address": "bm1qrwhwspf4mva328xtaeed9fjmgj2u8mqywv887z",
"name": "蜜蜂",
"mine_block_count": 1,
"percent": "0.25%"
}
]
rank
Get asset balance rankings of address
Method
/rank/<string:asset_id>
Parameters
optional:
String- asset_id, asset_idInteger- page, page number of rankingsInteger- limit, address number per page
Example
// Request
https://blockmeta.com/api/v2/rank/04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141?page=1&limit=10
// Response
{
"address": [
{
"address": "bm1qhzmyg3ky2tf7xaa6v24n7ryx2qqz5g8ty4jcrc",
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"balance": 997200000000,
"receive": 997200000000,
"sent": 0,
"join_timestamp": 1528890869
},
{
"address": "bm1qc8w2ahzguzeuq22gt4gf5r72z4lfsle3ltk8d2",
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"balance": 1500000000,
"receive": 2500000000,
"sent": 1000000000,
"join_timestamp": 1528888504
},
{
"address": "bm1qlf9cfmn9alm6zjljeaag35h80y4ha2adra7rcz",
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"balance": 1190000000,
"receive": 1190000000,
"sent": 0,
"join_timestamp": 1528890326
},
{
"address": "bm1qx09067ax6t9t3vekk0uat78ajxhep7tkcezqve",
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"balance": 100000000,
"receive": 100000000,
"sent": 0,
"join_timestamp": 1528890326
},
{
"address": "bm1qcrz3rnme38v6awccca2l6mmk3dsu5fhafu6v4q",
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"balance": 10000000,
"receive": 1300000000,
"sent": 1290000000,
"join_timestamp": 1528888504
},
{
"address": "bm1qd83zunqeq5cfml6g540jlxfpe073tnqm4w5z8n",
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"balance": 0,
"receive": 1000000000000,
"sent": 1000000000000,
"join_timestamp": 1527315522
},
{
"address": "bm1qjwdx4dcda3vendajtgrjpx6gxmvmagq52t8ag5",
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"balance": 0,
"receive": 1000000000000,
"sent": 1000000000000,
"join_timestamp": 1527317202
},
{
"address": "bm1q406g9qk6ne7alanztt27q7snhte8h4kx2w8w4p",
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"balance": 0,
"receive": 999900000000,
"sent": 999900000000,
"join_timestamp": 1528885266
},
{
"address": "bm1qv5wa2xsaaq02ardxty4sp5pwj26nx4j5eu9l9x",
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"balance": 0,
"receive": 100000000,
"sent": 100000000,
"join_timestamp": 1528885266
},
{
"address": "bm1qkfmv7yqpewchr43kyzg4m864sdydkmddp5mfxf",
"asset_id": "04356941e62729a4099a45c5e9c1945545d4023da08bf270ab726d4162165141",
"balance": 0,
"receive": 997700000000,
"sent": 997700000000,
"join_timestamp": 1528889587
}
],
"pagination": {
"current": 1,
"limit": 10,
"total": 2
}
}
total
Get total statistic of bytom network
Method
/stat/total
Parameters
optional:
Integer- from, start timestamp of statisticInteger- to, end timestamp of statistic
Example
// Request
https://blockmeta.com/api/v2/stat/total
// Response
{
"mainnet_block_count": 66577,
"orphan_block_count": 3,
"transaction_count": 217540,
"transaction_amount": 2201666087354342581,
"transaction_fee": 366284534845,
"transaction_gas": 1831422674.225,
"new_address_count": 165602,
"new_asset_count": 22
}
transaction
Get transaction by transaction_id
Method
/transaction/<string:transaction_id>
Parameters
String- transaction_id, transaction id
Example
// Request
https://blockmeta.com/api/v2/transaction/88def07e14825e78d552245846fd2b88eb109049b7b0185a6ab893f2eae1eead
// Response
{
"id": "88def07e14825e78d552245846fd2b88eb109049b7b0185a6ab893f2eae1eead",
"version": 1,
"size": 78,
"time_range": 0,
"status_fail": false,
"mux_id": "bae7a52e33bc64d0bd5c7103fb200ed80a263386f3a5b28aaa7556505dd4b140",
"height": 12579,
"chain_status": "mainnet",
"coinbase": 1,
"detail": [
{
"type": "coinbase",
"asset_id": "0000000000000000000000000000000000000000000000000000000000000000",
"amount": 0,
"arbitrary": "e384a3",
"transaction_id": "88def07e14825e78d552245846fd2b88eb109049b7b0185a6ab893f2eae1eead",
"io": 0
},
{
"type": "control",
"id": "55946ee277e75e945bdf619bbcf13fafc19f992d2ff7a252ddedd90582b307c5",
"position": 0,
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"amount": 41250000000,
"control_program": "0014c190f77b1e7adadae97e69a6a7d7762649c6e04f",
"address": "bm1qcxg0w7c70tdd46t7dxn204mkyeyudcz063s49e",
"transaction_id": "88def07e14825e78d552245846fd2b88eb109049b7b0185a6ab893f2eae1eead",
"io": 1
}
]
}
utxo
Get assets utxo statistic of bytom network
Method
/stat/utxo
Parameters
optional:
Integer- from, start timestamp of statisticInteger- to, end timestamp of statistic
Example
// Request
https://blockmeta.com/api/v2/stat/utxo
// Response
[
{
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"utxo_count": 5508
},
{
"asset_id": "d5e348366a1c341dc60759e0de102bded16a3565c6038ffbe846a54073750e68",
"utxo_count": 3
}
]