Blockmeta api v2使用教程

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
• asset
• assets
• block
• blocks
• daily
• difficulty
• hash-rate
• miner
• nodes
• rank
• total
• transaction
• transactions
• unconfirmed-transactions
• utxo

---

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_id
• Integer - page, page number of address transactions
• Integer - 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 transactions
• Integer - 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 assets
• Integer - 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 height
• String - 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 blocks
• Integer - 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 statistic
• Integer - 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 statistic
• Integer - 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 statistic
• Integer - 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 statistic
• Integer - 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 >= 1
• Integer - limit, number of data per page, max limit is 200
• String - * 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_id
• Integer - page, page number of rankings
• Integer - 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 statistic
• Integer - 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 >= 1
• Integer - 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 statistic
• Integer - 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
    }
]

转载于:https://my.oschina.net/u/3886279/blog/3064832