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:
A complete request example via curl:
// curl -X GET url/method
curl -X GET https://blockmeta.com/api/v2/blocks
API Methods
addressassetassetsblockblocksdailydifficultyhash-rateminernodesranktotaltransactiontransactionsunconfirmed-transactionsutxo
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%"
}
]
nodes
Get information of all bytom nodes.country include cn,sg,jp,es,de,us,kr,ca,ru,uk
Method
/nodes
Parameters
optional:
Integer- page, page number of data, page >= 1Integer- limit, number of data per page, max limit is 200String- * country*, country the node is located
Example
// Request
curl -X GET https://blockmeta.com/api/v2/nodes?page=1&limit=2&country=cn
// Response
{
"nodes": [
{
"address": "47.101.167.203:46657",
"status": "active",
"height": 243658,
"status_time": "2019-06-03T09:03:01Z",
"rtt": 50359363,
"network": "mainnet",
"version": "1.0.9+00f77625",
"is_seed": false,
"coordinate": {
"longitude": 120.1614,
"latitude": 30.2936
},
"country": "China",
"symbol": "cn",
"name": "iczc"
},
{
"address": "193.112.67.165:46657",
"status": "busy",
"height": 243656,
"status_time": "2019-06-03T09:01:59Z",
"rtt": 51971962,
"network": "mainnet",
"version": "1.0.8+56443ac4",
"is_seed": false,
"coordinate": {
"longitude": 116.3883,
"latitude": 39.9289
},
"country": "China",
"symbol": "cn",
"name": "EONE"
}
],
"pagination": {
"current": 1,
"limit": 2,
"total": 37
}
}
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
}
]
}
transactions
Get latest transactions
Method
/transactions
Parameters
Integer- page, page number of data, page >= 1Integer- limit, number of date per page, max limit is 200
Example
// Request
https://blockmeta.com/api/v2/transactions?page=1&limit=2
// Response
{
"transactions": [
{
"id": "49362f0fe882d6f2f0497550269f21c2b138706cc7192a37e50d9a598548044b",
"version": 1,
"size": 82,
"time_range": 0,
"status_fail": false,
"mux_id": "a3b111a5cb2915c8a3e81b8e5a2a121e14ced098ee52a11408da974a5f9027e4",
"height": 243653,
"timestamp": 1559551478,
"chain_status": "mainnet",
"coinbase": 1,
"fee": 0,
"transaction_amount": 41258000000,
"confirmations": 1,
"details": [
{
"type": "coinbase",
"asset_id": "0000000000000000000000000000000000000000000000000000000000000000",
"amount": 0,
"arbitrary": "00323433363533",
"input_id": "d45562151da84c46f45123fb1cc81084848324bcea6473c2a90119a33e3b8301",
"transaction_id": "49362f0fe882d6f2f0497550269f21c2b138706cc7192a37e50d9a598548044b",
"status_fail": false,
"io": 0
},
{
"type": "control",
"id": "bbfeb44d07f338baaf65f54701a4a31f989cab4babde8b62c4a11082b8228830",
"position": 0,
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"amount": 41258000000,
"control_program": "00148916ad528556048b97437f05a8afa7482afe0b94",
"address": "bm1q3yt265592czgh96r0uz63ta8fq40uzu5a8c2h0",
"transaction_id": "49362f0fe882d6f2f0497550269f21c2b138706cc7192a37e50d9a598548044b",
"status_fail": false,
"io": 1,
"decode_program": [
"DUP",
"HASH160",
"DATA_20 8916ad528556048b97437f05a8afa7482afe0b94",
"EQUALVERIFY",
"TXSIGHASH",
"SWAP",
"CHECKSIG"
],
"asset_name": "BTM",
"asset_decimals": "8"
}
]
},
{
"id": "b8f38f5d5e2ee27a5b041bb61faafec5c507aaa3fc92b731c3c9b6b61e6aaf80",
"version": 1,
"size": 930,
"time_range": 1559551455,
"status_fail": false,
"mux_id": "c6b8916d63e146e2cccc3477a2f7d716f15d5fd498c5f77160c50a2b957e4996",
"height": 243653,
"timestamp": 1559551478,
"chain_status": "mainnet",
"coinbase": 0,
"fee": 8000000,
"transaction_amount": 50459230073,
"confirmations": 1,
"details": [
{
"type": "spend",
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"amount": 27896288081,
"control_program": "0014d9a283348ff2ee94905b0011e07a131dc6e7c20a",
"address": "bm1qmx3gxdy07thffyzmqqg7q7snrhrw0ss288flcu",
"spent_output_id": "51df8e3b88360ec431ce2aed9d190e080625a28d9782e15516f0ccae0a6f8e81",
"input_id": "e77366f5702a798538cd6fe1f021b0c800a74f2f3e0d1d169cd51c0eca5abe5d",
"witness_arguments": [
"bf4a56a6320fa973649a34bcbf115c862a5430e71484c596671c465d00b67a2281d6bee55115015aabc2e081c13f3469d80ecb56de60468c67e0619b7f3a3c08",
"8167cfa7199eaa405d8b06f0e39364d2e5ed76b089fd1c86128b942b48fce0cd"
],
"transaction_id": "b8f38f5d5e2ee27a5b041bb61faafec5c507aaa3fc92b731c3c9b6b61e6aaf80",
"status_fail": false,
"io": 0,
"decode_program": [
"DUP",
"HASH160",
"DATA_20 d9a283348ff2ee94905b0011e07a131dc6e7c20a",
"EQUALVERIFY",
"TXSIGHASH",
"SWAP",
"CHECKSIG"
],
"asset_name": "BTM",
"asset_decimals": "8"
},
{
"type": "spend",
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"amount": 12213562353,
"control_program": "001498f4f39d15d0da7a74b0a9790e2a1ec68d509204",
"address": "bm1qnr6088g46rd85a9s49usu2s7c6x4pysyfft9gv",
"spent_output_id": "bf8777b87b1793c16267a9ddeb660fe738157897a0c2f23cc528191a9343a8c5",
"input_id": "7ad066082839a732e6651d91cd4ac048025a6bc485ad8be1e4542cf28c2c479f",
"witness_arguments": [
"b9c4e0748d1e4d4d6ea0718a522a2c075373bb430e0e1fe32b17130043146c0d77b2bc79745c068bad4d2a4f0d22563706f39ab4f8d61d8cc0b703ce8e68020b",
"5acf8e75a59bad604a4a757356b1fdf5468fa3d54a07c68b69640d6a24d3200f"
],
"transaction_id": "b8f38f5d5e2ee27a5b041bb61faafec5c507aaa3fc92b731c3c9b6b61e6aaf80",
"status_fail": false,
"io": 0,
"decode_program": [
"DUP",
"HASH160",
"DATA_20 98f4f39d15d0da7a74b0a9790e2a1ec68d509204",
"EQUALVERIFY",
"TXSIGHASH",
"SWAP",
"CHECKSIG"
],
"asset_name": "BTM",
"asset_decimals": "8"
},
{
"type": "spend",
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"amount": 7399161717,
"control_program": "00143dbce80e2110753f5ee4b2ee018ad91bd3b5c36e",
"address": "bm1q8k7wsr3pzp6n7hhykthqrzker0fmtsmwwqjsx2",
"spent_output_id": "eec00f99f435ecda5f59d319086cb63f41aeeed54f3dbe32087e410f0def0ec5",
"input_id": "5273b33e4c87f749c017e65e308b325aaa4e8223f3ce794496675b61e0c7be9c",
"witness_arguments": [
"e6b5594eb6e083fc7e130ffdfa8f326dfaed439cca9b040e5b22b80f4b02e07c107ed6ab762e27efd48340f317608f64f3cb35ba9d5ae02a937889db6567550a",
"c628b33e97881eb3c3916f2c5a992fa8fee476021566386faa8d17a29fbad853"
],
"transaction_id": "b8f38f5d5e2ee27a5b041bb61faafec5c507aaa3fc92b731c3c9b6b61e6aaf80",
"status_fail": false,
"io": 0,
"decode_program": [
"DUP",
"HASH160",
"DATA_20 3dbce80e2110753f5ee4b2ee018ad91bd3b5c36e",
"EQUALVERIFY",
"TXSIGHASH",
"SWAP",
"CHECKSIG"
],
"asset_name": "BTM",
"asset_decimals": "8"
},
{
"type": "spend",
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"amount": 2958217922,
"control_program": "0014b7c13ae88a97100b537cfc15f37852cfe3cd9c53",
"address": "bm1qklqn46y2jugqk5muls2lx7zjel3um8znhfrvsr",
"spent_output_id": "799b4efcc17700a20bfc60a6ed7169539849e29336ca9c33fd525f5f2fa343f8",
"input_id": "5af25fee3cb0c8052f4a21f6d06dc6e16b28d49ffc03743be2f656ad132166aa",
"witness_arguments": [
"483ae2e780258d63c0913479c9c37bf20d00130f54e74afd641b2d4b61a00a47bae2aef0195f02aee65d14cc3ecb6f779290ac90b13a0fc3cc714d9deeead90c",
"a3297b8e42d58404a34662e71389cc816b863aaaec1ce1375ccb2f35707d1a00"
],
"transaction_id": "b8f38f5d5e2ee27a5b041bb61faafec5c507aaa3fc92b731c3c9b6b61e6aaf80",
"status_fail": false,
"io": 0,
"decode_program": [
"DUP",
"HASH160",
"DATA_20 b7c13ae88a97100b537cfc15f37852cfe3cd9c53",
"EQUALVERIFY",
"TXSIGHASH",
"SWAP",
"CHECKSIG"
],
"asset_name": "BTM",
"asset_decimals": "8"
},
{
"type": "control",
"id": "da54a32deb7d37723086ce23b75687ad95722eff32075cc80fbc6542df9f2b09",
"position": 0,
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"amount": 859230073,
"control_program": "0014c7ba9f5a385aebb29bf6973ab2f009410837e8c9",
"address": "bm1qc7af7k3ctt4m9xlkjuat9uqfgyyr06xfpnagsv",
"transaction_id": "b8f38f5d5e2ee27a5b041bb61faafec5c507aaa3fc92b731c3c9b6b61e6aaf80",
"status_fail": false,
"io": 1,
"decode_program": [
"DUP",
"HASH160",
"DATA_20 c7ba9f5a385aebb29bf6973ab2f009410837e8c9",
"EQUALVERIFY",
"TXSIGHASH",
"SWAP",
"CHECKSIG"
],
"asset_name": "BTM",
"asset_decimals": "8"
},
{
"type": "control",
"id": "0e5823d2b3b2bed2125344e4d1b0bfea5e7bb77d648221aa8fb652c496c6d8fc",
"position": 1,
"asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"amount": 49600000000,
"control_program": "0014800b6d9b785834179d5e47e5b58818a051801409",
"address": "bm1qsq9kmxmctq6p0827gljmtzqc5pgcq9qfp4qr40",
"transaction_id": "b8f38f5d5e2ee27a5b041bb61faafec5c507aaa3fc92b731c3c9b6b61e6aaf80",
"status_fail": false,
"io": 1,
"decode_program": [
"DUP",
"HASH160",
"DATA_20 800b6d9b785834179d5e47e5b58818a051801409",
"EQUALVERIFY",
"TXSIGHASH",
"SWAP",
"CHECKSIG"
],
"asset_name": "BTM",
"asset_decimals": "8"
}
]
}
],
"pagination": {
"current": 1,
"limit": 2,
"total": 535457
}
}
unconfirmed-transactions
Get unconfirmed transactions from bytom node memory pool
Method
/unconfirmed-transactions
Example
// Request
https://blockmeta.com/api/v2/unconfirmed-transactions
// Response
[
{
"id": "e1a8f056f69f02be63a82374c3928ae2a49bf4c4e6a8f2ad7d231c1737121070",
"version": 1,
"size": 611,
"time_range": 0,
"status_fail": false,
"mux_id": "507ab87ae0e6ae078275055d062b3c902e8bf0ac7a1407429778cbd439bc82ad",
"fee": 1000000,
"transaction_amount": 3546000000
},
{
"id": "738446630c5c7801b39dcced868e5e3f692f68791d85b543c6cf227e53f1082f",
"version": 1,
"size": 332,
"time_range": 260933,
"status_fail": false,
"mux_id": "6cb8e7c87ae20e09f773036c3bb9f1db0e4116055559d3d4b3f731d010320c3c",
"fee": 449000,
"transaction_amount": 3800000000
},
{
"id": "52cd5f58b3e7990a693dade6d5aaf6343bc2b970132426edebf8238b34334403",
"version": 1,
"size": 468,
"time_range": 0,
"status_fail": false,
"mux_id": "67f8abe784022969c1dad75a89c691ba9d7ccf5e3f446c455ed963769f65b440",
"fee": 1200000,
"transaction_amount": 0
},
{
"id": "abed223d45c9eab5789174064746617132189672d83b04fefb53bf17986d65ea",
"version": 1,
"size": 339,
"time_range": 1559551685,
"status_fail": false,
"mux_id": "36e4cdf903141e9cd2251a6bc18f05aeef75c23823842c0360c2746554362c43",
"fee": 8000000,
"transaction_amount": 5941788000000
}
]
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
}
]