Skip to content
This repository has been archived by the owner on Mar 21, 2024. It is now read-only.

Explorer API

Jump to bottom
martinzlf edited this page Sep 13, 2018 · 11 revisions

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:

Client URL
curl https://blockmeta.com/api/v2

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_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%"
    }
]

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
        }
    ]
}

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
    }
]

by bytom

home

Installation Instructions

Development-Environment

Build-Node

Usage

Create-Account-and-Wallet

Node-CLI-Guide

Node-GUI-Guide

Smart contract

Coming soon

API

API-Reference

Explorer

Explorer-API

Clone this wiki locally