# Blockmeta Vapor API

# API 接口

默认的JSON-RPC:

Client URL
Base URL https://vapor.blockmeta.com/api/v1

一个完整的curl示例:

// curl -X GET url/method
curl -X GET "https://vapor.blockmeta.com/api/v1/address/vp1qfk9kgj6mt9ga4wfnz7zqq6zkys9t84lj5t53x5" -H "accept: application/json"

// response
{
  "code": 200,
  "data": {
    "address": [
      {
        "address_id": "vp1qfk9kgj6mt9ga4wfnz7zqq6zkys9t84lj5t53x5",
        "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
        "asset_name": "BTM",
        "decimals": 8,
        "balance": 11730661615088,
        "receive": 23461428747242,
        "sent": 11730767132154,
        "timestamp": 1563946177000
      }
    ]
  },
  "msg": "ok"
}

# API 方法


block

Get the latest block

Parameters

None

Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Object - block, block detail.
      • String- hash, hash of block.
      • String- blocker, the public key who product the block.
      • String- previous_block_hash, previous block hash.
      • String- transaction_merkle_root, merkle root of transaction.
      • String- transaction_status_hash, merkle root of transaction status.
      • Integer- size, size of block.
      • Integer- version, version of block.
      • Integer- height, height of block.
      • Integer- timestamp, timestamp of block.
      • String- miner_address, the address of miner.
      • Integer- transaction_count, the count of transaction in the block.
      • String- chain_status, mainchain or orphan.
      • Array - witness, the block witness.
      • String- name, blocker name.
      • String- name_en, blocker english name.
      • String- logo, blocker logo.
  • String - msg, error message.

Example

get latest block:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/block" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "block": {
      "hash": "2e5159b6bf5266db2bff816cd7d1c7cd7dd8812ffeb1a2830894164c89f7c2dc",
      "blocker": "e7f458ee8d2ba19b0fdc7410d1fd57e9c2e1a79377c661d66c55effe49d7ffc920e40510442d4a10b7bea06c09fb0b41f52601135adaaa7136204db36106c093",
      "previous_block_hash": "618480716ddc8e07e2e8f6fac38c3630da518f88a0bd72cc67f9af17c7da3d14",
      "transaction_status_hash": "c9c377e5192668bc0a367e4a4764f11e7c725ecced1d7b6a492974fab1b6d5bc",
      "transaction_merkle_root": "5444006d0429ce7e5831cf398cb8d1111cd41dc51234b015f8f6a3c98af14b80",
      "size": 918,
      "version": 1,
      "height": 5507997,
      "timestamp": 1566378131000,
      "miner_address": "vp1qn5h4469cmksadpuxn042398kdzda48reu8ar2n",
      "transaction_count": 1,
      "chain_status": "mainnet",
      "witness": [
        "",
        "",
        "",
        "d5e650af2dcef9edbc5d53007a028ba681e4f46002683cd77b2b4b19bfb975e83e0d3164972445c87e4dc53d95685919f5ff887f8d2b877d81b315435b50f008",
        "",
        "",
        "14f75dc3f0eb34a6fc111268a1f9fd24514baf1e64be379a844aa15cc2c039b033243dbfbbb199fa19b543dbc20b9e5b2b63cca6ec91d5d2dbf023a140e4ce06",
        "",
        "618865db3da31bbd197389b49d943d722e91eeb9dc515fa1f75e724bd20acf31234ee83c2040ee6edc987111b88c2dbdb1eebaeaeb5195cc1a77a985c040850a",
        "3f35dbdd982b04d51bc880565cdd39a901d9ef56cdbde4ccbb067e42db7170a22e4ae3b619f8c94006ef3cfa06c0551d4484c5635b5e354cf3525a924f673a0d"
      ],
      "name": "",
      "name_en": "",
      "logo": ""
    }
  },
  "msg": "ok"
}

blocks

Get blocklist that was sorted by height

Parameters

Optional:

  • Integer- page, page number of data.
  • Integer- limit, number of data per page.

Returns

Object:

Object:

  • Integer- code, error code.
  • Object - data, blocks detail.
    • Array of Object - lists, block list.
      • String- hash, hash of block.
      • String- blocker, the public key who product the block.
      • String- previous_block_hash, previous block hash.
      • String- transaction_merkle_root, merkle root of transaction.
      • String- transaction_status_hash, merkle root of transaction status.
      • Integer- size, size of block.
      • Integer- version, version of block.
      • Integer- height, height of block.
      • Integer- timestamp, timestamp of block.
      • String- miner_address, the address of miner.
      • Integer- transaction_count, the count of transaction in the block.
      • String- chain_status, mainchain or orphan.
      • Array - witness, the block witness.
      • String- name, blocker name.
      • String- name_en, blocker english name.
      • String- logo, blocker logo.
    • Array of Object - pagination, pagination info.
      • Integer- current, current number of page.
      • Integer- limit, number of data per page.
      • Integer- total, the number of total blocks.
      • Integer- timestamp, the timestamp which can accelerate query speed.
  • String - msg, error message.

Example

Get blocks when the page is 1 and limit is 1:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/blocks?page=1&limit=1" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "lists": [
      {
        "hash": "99b644981e52011daec6b6dcfe4e810c872e744bb06376c43feca82ae659d3b9",
        "blocker": "0f8669abbd3cc0a167156188e428f940088d5b2f36bb3449df71d2bdc5e077814ea3f68628eef279ed435f51ee26cff00f8bd28fabfd500bedb2a9e369f5c825",
        "previous_block_hash": "5a623c59817b7f7bd029de40760eaef357d7fb68891afead3dac1062b985d96f",
        "transaction_status_hash": "c9c377e5192668bc0a367e4a4764f11e7c725ecced1d7b6a492974fab1b6d5bc",
        "transaction_merkle_root": "009a33cd6215c2b4e3d7e23bd89f8e8c3c94c9c293979129b6b2e51748676976",
        "size": 1686,
        "version": 1,
        "height": 5509933,
        "timestamp": 1566379099000,
        "miner_address": "vp1ql4dakjlqhndda7xh0smz38j847e265fft3gz4u",
        "transaction_count": 1,
        "chain_status": "mainnet",
        "witness": [
          "6b08ed9d96eecfa97c99a58aa5b00919b818aece97b1dfd1dea8fb89734306f337d07baa08779943c71b04894cb345ecd10db5e66e091ab431b862b79c1e8208",
          "ca03d6dc4920cf3a6119ce34523d3ee8e57622e2aea2fc58d40c019d46bf0b7ded39e3f47e26cd4f01f9cca85f668d6c38605c7acc6488014858a9654e1bca0b",
          "2a590b6bc425b3a7a61d094ee377828c253f35f6676a585ccb95c430628628a0217af0cdd7f9a573e352f0e0df3536ad26051a41f390ec82cab7dba0cfbbb60d",
          "555558e4baba020c3abd3b3a5c56d9b98e05d306b86a6db14534bcc138fcca35e5b9388ba3b717a7faa910da6223fd68d4d87893d8d5ebd30d2fdbf93a115a0f",
          "d26627b56877a6502251beff968ed3cd93c14673f83b32caf3f998613c9ea77119ed180bf4ec1820fe2d89f0485263435cfa06f8f8287259fdbf3ea23f46fe0a",
          "f5467d24de5c47acc4c0897ad081954e7f203a0ecaa20a9d8909cfd5385c4d9bb64606074de8a15c820c21a4a6c99645f7a9979a9b82a1bdfa655596c05aa10b",
          "b1f416372b217b04fac236aa980aa4603500327f79a16b9366b7c1e512f3495309714764986d401bb8a6838ec7cd1b87591930b78e9545e2f2338a319a269b01",
          "2b488aa0eeacda5eae089a839e57199a3b691e6ce4656049697c18c41f4c8291a71e3f74ef0ecd3dbbbd533c14a9b8ac2de9a6ba476560e7b59777a93a44fb02",
          "60555a5285eafd5162c8117038f874202e3a76d48a10e5bb037fc2a2228b5b21d97f2646f05ae2696f163e25dd88ffd5e151253a949a2ef6d971ee8d0e669401",
          "aa94165b1aa9aea45abc678cb2c288fc21d7cba82a173b7c5071b01f1b56508870e01d7a287ed661d4034c5e847a1fa6ae8eb37b2ce7fa880464ed9cacbf200b"
        ],
        "name": "MatPool",
        "name_en": "MatPool",
        "logo": "https://api.bystack.com/supernode/v1/uploads/1562316066.53449061_14.png"
      }
    ],
    "pagination": {
      "current": 1,
      "limit": 1,
      "total": 5509933,
      "timestamp": 0
    }
  },
  "msg": "ok"
}

block/height/{height}

Get block by block height Parameters

Optional:

  • String- height, block height. Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Object - block, block detail.
      • String- hash, hash of block.
      • String- blocker, the public key who product the block.
      • String- previous_block_hash, previous block hash.
      • String- transaction_merkle_root, merkle root of transaction.
      • String- transaction_status_hash, merkle root of transaction status.
      • Integer- size, size of block.
      • Integer- version, version of block.
      • Integer- height, height of block.
      • Integer- timestamp, timestamp of block.
      • String- miner_address, the address of miner.
      • Integer- transaction_count, the count of transaction in the block.
      • String- chain_status, mainchain or orphan.
      • Array - witness, the block witness.
      • String- name, blocker name.
      • String- name_en, blocker english name.
      • String- logo, blocker logo.
  • String - msg, error message.

Example

Get block when the height is 123:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/block/height/123" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "block": {
      "hash": "b5ca3311d47d99d981216d9deedc3b181665d8c2da45d94129f9f6206f07f3f6",
      "blocker": "fc10ec35cb7b27f9deaef5332eb9f41b8e19751ba8666877b73a7570c0c20b4510b2ac5c0bf589abfa69051874f833ddf294121c16024342dc13d05f3cd9679c",
      "previous_block_hash": "6b9ac010d6db11ebd17a75370bb88ea38ee1b97c729db06bfb73a8cf5378c4da",
      "transaction_status_hash": "c9c377e5192668bc0a367e4a4764f11e7c725ecced1d7b6a492974fab1b6d5bc",
      "transaction_merkle_root": "fe84ad31de4507e1b792e801af16ea8b678c2ffba769b14069a6e3f456d9ab88",
      "size": 518,
      "version": 1,
      "height": 123,
      "timestamp": 1563602590000,
      "miner_address": "vp1qfnvlnrl27eac9ts0kfz2axkptltn7g2zx050ep",
      "transaction_count": 1,
      "chain_status": "mainnet",
      "witness": [
        "663e83f10040edd4c8d5c32c9e70ff60843c33cf97b115f1c7b91e1f0cd186a68f83c21f63f11ab8fc7918cda30552cf08d8460e119d337b23d85c46f2b92306",
        "",
        "",
        "",
        "",
        "",
        "",
        "",
        "",
        ""
      ],
      "name": "",
      "name_en": "",
      "logo": ""
    }
  },
  "msg": "ok"
}

tx

Get the most advanced five transactions Parameters

None Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - transactions, transaction object:
      • String - tx_id, transaction id, hash of the transaction.
      • Integer - timestamp, transaction timestamp.
      • Integer - block_height, block height.
      • String - block_hash, transaction hash of the transaction.
      • Integer - trx_amount, the amount of transaction.
      • Integer - trx_fee, the fee of transaction.
      • Integer - size, size of transaction.
      • Boolean - status_fail, whether the state of the request has failed.
      • Integer - chain_status, mainnet or orphan.
      • Integer - coinbase, the flag of coinbase transaction.
      • Boolean - is_cross_chain, the flag of cross chain transaction.
      • Boolean - is_vote, the flag of vote transaction.
      • Integer - index_id, index in block.
      • Array of Object - inputs, object of inputs for the transaction.
        • String - type,  the type of input action, available option include: 'spend', 'issue', 'coinbase'.
        • String - asset_id, asset id.
        • String - asset_alias, name of asset.
        • Object - asset_definition, definition of asset(json object).
        • Integer - amount, amount of asset.
        • Object - issuance_program, issuance program, it only exist when type is 'issue'.
        • Object - control_program, control program of account, it only exist when type is 'spend'.
        • String - address, address of account, it only exist when type is 'spend'.
        • String - spent_output_id, the front of outputID to be spent in this input, it only exist when type is 'spend'.
        • String - account_id, account id.
        • String - account_alias, name of account.
        • Object - arbitrary, arbitrary infomation can be set by miner, it only exist when type is 'coinbase'.
        • String - input_id, hash of input action.
        • Array of String - witness_arguments, witness arguments.
        • String - asset_name, asset name.
        • String - asset_decimals, decimal of asset.
      • Array of Object - outputs, object of outputs for the transaction.
        • String - type, the type of output action, available option include: 'retire', 'control'.
        • String - id, outputid related to utxo.
        • Integer - position, position of outputs.
        • String - asset_id, asset id.
        • String - asset_alias, name of asset.
        • Object - asset_definition, definition of asset(json object).
        • Integer - amount, amount of asset.
        • String - account_id, account id.
        • String - account_alias, name of account.
        • Object - control_program, control program of account.
        • String - address, address of account.
        • String - asset_name, asset name.
        • String - asset_decimals, decimal of asset.
  • String - msg, error message.

Example

Get transactions when the page is 1 and limit is 1:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/tx" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "transactions": [
      {
        "tx_id": "89fde2896a02574f596419e89b4bbe069640f87d617e727d68761823e7d9d71c",
        "timestamp": 1566379624500,
        "block_hash": "8ddc95db0ee6a0e129b7749167f7c5d6777397783d7fc63061212bdadeb1ee01",
        "block_height": 5510984,
        "trx_amount": 0,
        "trx_fee": 0,
        "status_fail": false,
        "is_vote": false,
        "is_cross_chain": false,
        "coinbase": 1,
        "size": 0,
        "chain_status": "mainnet",
        "index_id": 5518860,
        "inputs": [
          {
            "type": "coinbase",
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "arbitrary": "0035353130393834",
            "input_id": "06eaa4ee2b94261e9d2d9d8c2884fdf976ac1d65506fb8739b6806d24ac55844",
            "witness_arguments": [],
            "decimals": 8,
            "symbol": "BTM"
          }
        ],
        "outputs": [
          {
            "type": "control",
            "id": "beb7af5ff5c803745317d397fda20d5bd42ebf720580327b78a768bcd51ad0f6",
            "position": 0,
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "control_program": "00142e36e94edbc4138a84e825d1d5390ee185257dcc",
            "address": "vp1q9cmwjnkmcsfc4p8gyhga2wgwuxzj2lwvzrqh3c",
            "decimals": 8,
            "symbol": "BTM"
          }
        ]
      },
      {
        "tx_id": "0a26935b85a882a37b7e7f7f0a6cfc2ceff3b6eb912ca01e79b9098e129c9ab9",
        "timestamp": 1566379624000,
        "block_hash": "60e0072077dac74c513d1066c06c58f77374da1cb39ce7b1d68238ac3712ddbc",
        "block_height": 5510983,
        "trx_amount": 0,
        "trx_fee": 0,
        "status_fail": false,
        "is_vote": false,
        "is_cross_chain": false,
        "coinbase": 1,
        "size": 0,
        "chain_status": "mainnet",
        "index_id": 5518859,
        "inputs": [
          {
            "type": "coinbase",
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "arbitrary": "0035353130393833",
            "input_id": "504120b3c6a2d20bc63172e644de150d55e1e397b46a85e9891e32a2e5cbee2f",
            "witness_arguments": [],
            "decimals": 8,
            "symbol": "BTM"
          }
        ],
        "outputs": [
          {
            "type": "control",
            "id": "c1bedae7e13fc0a305eaef15d0f85cc00062d5a4154e2e4ade14b7fb2b636ab4",
            "position": 0,
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "control_program": "00142e36e94edbc4138a84e825d1d5390ee185257dcc",
            "address": "vp1q9cmwjnkmcsfc4p8gyhga2wgwuxzj2lwvzrqh3c",
            "decimals": 8,
            "symbol": "BTM"
          }
        ]
      },
      {
        "tx_id": "368dfb861902c77915ef8fc182b51ade0154fc024a9457e0a6405228b5540ee6",
        "timestamp": 1566379623500,
        "block_hash": "aaea9333b838215100c65818a1fef8729548d6f22d0354b26267a2f496f7089e",
        "block_height": 5510982,
        "trx_amount": 0,
        "trx_fee": 0,
        "status_fail": false,
        "is_vote": false,
        "is_cross_chain": false,
        "coinbase": 1,
        "size": 0,
        "chain_status": "mainnet",
        "index_id": 5518858,
        "inputs": [
          {
            "type": "coinbase",
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "arbitrary": "0035353130393832",
            "input_id": "dc01b5190a0a72bbae7240cd311817d71fa5792064312299c57119326e7debf8",
            "witness_arguments": [],
            "decimals": 8,
            "symbol": "BTM"
          }
        ],
        "outputs": [
          {
            "type": "control",
            "id": "5e4543adb84e7590572f886b253fea063de6d3ce6541dda882ce5263c8ec01b0",
            "position": 0,
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "control_program": "00142e36e94edbc4138a84e825d1d5390ee185257dcc",
            "address": "vp1q9cmwjnkmcsfc4p8gyhga2wgwuxzj2lwvzrqh3c",
            "decimals": 8,
            "symbol": "BTM"
          }
        ]
      },
      {
        "tx_id": "c975c3c8aee4274e57d07e65598504cb93cad090323d1f6bf6869ac43ed800ff",
        "timestamp": 1566379623000,
        "block_hash": "0c7fd6c774febacaee167647eb75e1b24d02f8301fef3ebc3f72530ffe5cec71",
        "block_height": 5510981,
        "trx_amount": 0,
        "trx_fee": 0,
        "status_fail": false,
        "is_vote": false,
        "is_cross_chain": false,
        "coinbase": 1,
        "size": 0,
        "chain_status": "mainnet",
        "index_id": 5518857,
        "inputs": [
          {
            "type": "coinbase",
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "arbitrary": "0035353130393831",
            "input_id": "97da4b1bfade7ae0139dc6c4a52b576ba6d0e05deca4fd2e8396c5c772c4fefd",
            "witness_arguments": [],
            "decimals": 8,
            "symbol": "BTM"
          }
        ],
        "outputs": [
          {
            "type": "control",
            "id": "801669e897dbf9d60f722860b7253948a69c3a795c5a3c0a3d4a5a7e5c47dc4c",
            "position": 0,
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "control_program": "00142e36e94edbc4138a84e825d1d5390ee185257dcc",
            "address": "vp1q9cmwjnkmcsfc4p8gyhga2wgwuxzj2lwvzrqh3c",
            "decimals": 8,
            "symbol": "BTM"
          }
        ]
      },
      {
        "tx_id": "9af9e071b9b9a23130e481eb669e9b1715e5e43d02a8a5d2762d50a6b5af997f",
        "timestamp": 1566379622500,
        "block_hash": "f40636c01edf732348abe182111e4139d1d5c2d7cc06ddbd76e35db9ade36dca",
        "block_height": 5510980,
        "trx_amount": 0,
        "trx_fee": 0,
        "status_fail": false,
        "is_vote": false,
        "is_cross_chain": false,
        "coinbase": 1,
        "size": 0,
        "chain_status": "mainnet",
        "index_id": 5518856,
        "inputs": [
          {
            "type": "coinbase",
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "arbitrary": "0035353130393830",
            "input_id": "7d9d6053c087d20dc8b8aeb8960236c8c24a424198842d911388b5235e424702",
            "witness_arguments": [],
            "decimals": 8,
            "symbol": "BTM"
          }
        ],
        "outputs": [
          {
            "type": "control",
            "id": "90a0052c255bad2be48667f015a3b596db3a28a185093e8e2da9c52d86bbce43",
            "position": 0,
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "control_program": "00142e36e94edbc4138a84e825d1d5390ee185257dcc",
            "address": "vp1q9cmwjnkmcsfc4p8gyhga2wgwuxzj2lwvzrqh3c",
            "decimals": 8,
            "symbol": "BTM"
          }
        ]
      }
    ]
  },
  "msg": "ok"
}

tx/hash/{hash}

Get transaction detail by transaction id(hash) Parameters

Object:

  • String- hash, tranasction id. Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Object - transactions, transaction object:
      • String - tx_id, transaction id, hash of the transaction.
      • Integer - timestamp, transaction timestamp.
      • Integer - block_height, block height.
      • String - block_hash, transaction hash of the transaction.
      • Integer - trx_amount, the amount of transaction.
      • Integer - trx_fee, the fee of transaction.
      • Integer - size, size of transaction.
      • Boolean - status_fail, whether the state of the request has failed.
      • Integer - chain_status, mainnet or orphan.
      • Integer - coinbase, the flag of coinbase transaction.
      • Boolean - is_cross_chain, the flag of cross chain transaction.
      • Boolean - is_vote, the flag of vote transaction.
      • Integer - index_id, index in block.
      • Array of Object - inputs, object of inputs for the transaction.
        • String - type, the type of input action, available option include: 'spend', 'issue', 'coinbase'.
        • String - asset_id, asset id.
        • String - asset_alias, name of asset.
        • Object - asset_definition, definition of asset(json object).
        • Integer - amount, amount of asset.
        • Object - issuance_program, issuance program, it only exist when type is 'issue'.
        • Object - control_program, control program of account, it only exist when type is 'spend'.
        • String - address, address of account, it only exist when type is 'spend'.
        • String - spent_output_id, the front of outputID to be spent in this input, it only exist when type is 'spend'.
        • String - account_id, account id.
        • String - account_alias, name of account.
        • Object - arbitrary, arbitrary infomation can be set by miner, it only exist when type is 'coinbase'.
        • String - input_id, hash of input action.
        • Array of String - witness_arguments, witness arguments.
        • String - asset_name, asset name.
        • String - asset_decimals, decimal of asset.
      • Array of Object - outputs, object of outputs for the transaction.
        • String - type, the type of output action, available option include: 'retire', 'control'.
        • String - id, outputid related to utxo.
        • Integer - position, position of outputs.
        • String - asset_id, asset id.
        • String - asset_alias, name of asset.
        • Object - asset_definition, definition of asset(json object).
        • Integer - amount, amount of asset.
        • String - account_id, account id.
        • String - account_alias, name of account.
        • Object - control_program, control program of account.
        • String - address, address of account.
        • String - asset_name, asset name.
        • String - asset_decimals, decimal of asset.
  • String - msg, error message.

Example

get transaction when hash is 9af9e071b9b9a23130e481eb669e9b1715e5e43d02a8a5d2762d50a6b5af997f:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/tx/hash/9af9e071b9b9a23130e481eb669e9b1715e5e43d02a8a5d2762d50a6b5af997f" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "transaction": {
      "tx_id": "9af9e071b9b9a23130e481eb669e9b1715e5e43d02a8a5d2762d50a6b5af997f",
      "timestamp": 1566379622500,
      "block_hash": "f40636c01edf732348abe182111e4139d1d5c2d7cc06ddbd76e35db9ade36dca",
      "block_height": 5510980,
      "trx_amount": 0,
      "trx_fee": 0,
      "status_fail": false,
      "is_vote": false,
      "is_cross_chain": false,
      "coinbase": 1,
      "size": 0,
      "chain_status": "mainnet",
      "index_id": 5518856,
      "inputs": [
        {
          "type": "coinbase",
          "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
          "amount": 0,
          "arbitrary": "0035353130393830",
          "input_id": "7d9d6053c087d20dc8b8aeb8960236c8c24a424198842d911388b5235e424702",
          "witness_arguments": [],
          "decimals": 8,
          "symbol": "BTM"
        }
      ],
      "outputs": [
        {
          "type": "control",
          "id": "90a0052c255bad2be48667f015a3b596db3a28a185093e8e2da9c52d86bbce43",
          "position": 0,
          "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
          "amount": 0,
          "control_program": "00142e36e94edbc4138a84e825d1d5390ee185257dcc",
          "address": "vp1q9cmwjnkmcsfc4p8gyhga2wgwuxzj2lwvzrqh3c",
          "decimals": 8,
          "symbol": "BTM"
        }
      ]
    }
  },
  "msg": "ok"
}

tx/height/{height}

Get transactions by block height Parameters

Object:

  • Integer- height, block height. Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Object - transactions, transaction object:
      • String - tx_id, transaction id, hash of the transaction.
      • Integer - timestamp, transaction timestamp.
      • Integer - block_height, block height.
      • String - block_hash, transaction hash of the transaction.
      • Integer - trx_amount, the amount of transaction.
      • Integer - trx_fee, the fee of transaction.
      • Integer - size, size of transaction.
      • Boolean - status_fail, whether the state of the request has failed.
      • Integer - chain_status, mainnet or orphan.
      • Integer - coinbase, the flag of coinbase transaction.
      • Boolean - is_cross_chain, the flag of cross chain transaction.
      • Boolean - is_vote, the flag of vote transaction.
      • Integer - index_id, index in block.
      • Array of Object - inputs, object of inputs for the transaction.
        • String - type, the type of input action, available option include: 'spend', 'issue', 'coinbase'.
        • String - asset_id, asset id.
        • String - asset_alias, name of asset.
        • Object - asset_definition, definition of asset(json object).
        • Integer - amount, amount of asset.
        • Object - issuance_program, issuance program, it only exist when type is 'issue'.
        • Object - control_program, control program of account, it only exist when type is 'spend'.
        • String - address, address of account, it only exist when type is 'spend'.
        • String - spent_output_id, the front of outputID to be spent in this input, it only exist when type is 'spend'.
        • String - account_id, account id.
        • String - account_alias, name of account.
        • Object - arbitrary, arbitrary infomation can be set by miner, it only exist when type is 'coinbase'.
        • String - input_id, hash of input action.
        • Array of String - witness_arguments, witness arguments.
        • String - asset_name, asset name.
        • String - asset_decimals, decimal of asset.
      • Array of Object - outputs, object of outputs for the transaction.
        • String - type, the type of output action, available option include: 'retire', 'control'.
        • String - id, outputid related to utxo.
        • Integer - position, position of outputs.
        • String - asset_id, asset id.
        • String - asset_alias, name of asset.
        • Object - asset_definition, definition of asset(json object).
        • Integer - amount, amount of asset.
        • String - account_id, account id.
        • String - account_alias, name of account.
        • Object - control_program, control program of account.
        • String - address, address of account.
        • String - asset_name, asset name.
        • String - asset_decimals, decimal of asset.
  • String - msg, error message.

Example

get transactions when height is 13:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/tx/height/13" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "transactions": [
      {
        "tx_id": "657067c03470ca68195cd685ca3946dca46c274ec20246b48e02bf87c1b44fc3",
        "timestamp": 1563602153000,
        "block_hash": "7f56f25687acde9c5484fdad3db8a8382d7d34a61d013b7318f8bdde4e7b6279",
        "block_height": 13,
        "trx_amount": 0,
        "trx_fee": 0,
        "status_fail": false,
        "is_vote": false,
        "is_cross_chain": false,
        "coinbase": 1,
        "size": 0,
        "chain_status": "mainnet",
        "index_id": 13,
        "inputs": [
          {
            "type": "coinbase",
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "arbitrary": "003133",
            "input_id": "75a6a7c5ec3f0416486b8f0b5daac0c00ac57c541346b0cbb593708f74d43b1a",
            "witness_arguments": [],
            "decimals": 8,
            "symbol": "BTM"
          }
        ],
        "outputs": [
          {
            "type": "control",
            "id": "8b85a8035af73682d10b9e86f4da7bb5bdd7afa729e894348e7d78985b411dd3",
            "position": 0,
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "control_program": "00144cd9f98feaf67b82ae0fb244ae9ac15fd73f2142",
            "address": "vp1qfnvlnrl27eac9ts0kfz2axkptltn7g2zx050ep",
            "decimals": 8,
            "symbol": "BTM"
          }
        ]
      }
    ]
  },
  "msg": "ok"
}

txs

get transactions by pagination Parameters

Optional:

  • Integer- page, page number of data, default 1.
  • Integer- limit, number of data per page, default 20. Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - lists, transactions object:
      • String - tx_id, transaction id, hash of the transaction.
      • Integer - timestamp, transaction timestamp.
      • Integer - block_height, block height.
      • String - block_hash, transaction hash of the transaction.
      • Integer - trx_amount, the amount of transaction.
      • Integer - trx_fee, the fee of transaction.
      • Integer - size, size of transaction.
      • Boolean - status_fail, whether the state of the request has failed.
      • Integer - chain_status, mainnet or orphan.
      • Integer - coinbase, the flag of coinbase transaction.
      • Boolean - is_cross_chain, the flag of cross chain transaction.
      • Boolean - is_vote, the flag of vote transaction.
      • Integer - index_id, index in block.
      • Array of Object - inputs, object of inputs for the transaction.
        • String - type, the type of input action, available option include: 'spend', 'issue', 'coinbase'.
        • String - asset_id, asset id.
        • String - asset_alias, name of asset.
        • Object - asset_definition, definition of asset(json object).
        • Integer - amount, amount of asset.
        • Object - issuance_program, issuance program, it only exist when type is 'issue'.
        • Object - control_program, control program of account, it only exist when type is 'spend'.
        • String - address, address of account, it only exist when type is 'spend'.
        • String - spent_output_id, the front of outputID to be spent in this input, it only exist when type is 'spend'.
        • String - account_id, account id.
        • String - account_alias, name of account.
        • Object - arbitrary, arbitrary infomation can be set by miner, it only exist when type is 'coinbase'.
        • String - input_id, hash of input action.
        • Array of String - witness_arguments, witness arguments.
        • String - asset_name, asset name.
        • String - asset_decimals, decimal of asset.
      • Array of Object - outputs, object of outputs for the transaction.
        • String - type, the type of output action, available option include: 'retire', 'control'.
        • String - id, outputid related to utxo.
        • Integer - position, position of outputs.
        • String - asset_id, asset id.
        • String - asset_alias, name of asset.
        • Object - asset_definition, definition of asset(json object).
        • Integer - amount, amount of asset.
        • String - account_id, account id.
        • String - account_alias, name of account.
        • Object - control_program, control program of account.
        • String - address, address of account.
        • String - asset_name, asset name.
        • String - asset_decimals, decimal of asset.
    • Array of Object - pagination, pagination info.
      • Integer- current, current number of page.
      • Integer- limit, number of data per page.
      • Integer- total, the number of total blocks.
      • Integer- timestamp, the timestamp which can accelerate query speed.
  • String - msg, error message.

Example

get transactions when page is 1 and limit is 1:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/txs?page=1&limit=1" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "lists": [
      {
        "tx_id": "8d74b47b21b2c84bec3cd422a19f4ad2115212bccfd37dd0e5c1cc0a75132cf6",
        "timestamp": 1566435344000,
        "block_hash": "c56002b4383febc2eb807deef4294a7954761d8d17236e8996b2945345fb9ff1",
        "block_height": 5622362,
        "trx_amount": 0,
        "trx_fee": 0,
        "status_fail": false,
        "is_vote": false,
        "is_cross_chain": false,
        "coinbase": 1,
        "size": 0,
        "chain_status": "mainnet",
        "index_id": 5631455,
        "inputs": [
          {
            "type": "coinbase",
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "arbitrary": "0035363232333632",
            "input_id": "0113c1e03914cf4fdda9b6eb5ab37a019d3591e9c8da4092d50c99422998eb65",
            "witness_arguments": [],
            "decimals": 8,
            "symbol": "BTM"
          }
        ],
        "outputs": [
          {
            "type": "control",
            "id": "38cc18206a4a075ea1fb4ff75ba9986826039336e8efd82c15b27c22f4bc7588",
            "position": 0,
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "control_program": "0014a99f1a09aca63445964664b73c2cb696481460f2",
            "address": "vp1q4x035zdv5c6yt9jxvjmnct9kjeypgc8jp99hug",
            "decimals": 8,
            "symbol": "BTM"
          }
        ]
      }
    ],
    "pagination": {
      "current": 1,
      "limit": 1,
      "total": 5631455,
      "timestamp": 0
    }
  },
  "msg": "ok"
}

vote/txs

get vote transactions by pagination Parameters

Optional:

  • Integer- page, page number of data, default 1.
  • Integer- limit, number of data per page, default 20. Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - vote_trx_list, vote transactions object:
      • String - tx_id, transaction id, hash of the transaction.
      • Integer - timestamp, transaction timestamp.
      • Integer - block_height, block height.
      • String - block_hash, transaction hash of the transaction.
      • Integer - vote_amount, the amount of vote.
      • Integer - size, size of transaction.
      • Boolean - status_fail, whether the state of the request has failed.
      • Integer - chain_status, mainnet or orphan.
      • String - voter, voter.
      • String - voted_pub_key, Who is voting for.
    • Array of Object - pagination, pagination info.
      • Integer- current, current number of page.
      • Integer- limit, number of data per page.
      • Integer- total, the number of total blocks.
      • Integer- timestamp,the timestamp which can accelerate query speed.
  • String - msg, error message.

Example

get transactions when page is 1 and limit is 1:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/vote/txs?page=1&limit=1" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "pagination": {
      "current": 1,
      "limit": 1,
      "total": 3548,
      "timestamp": 0
    },
    "vote_trx_list": [
      {
        "tx_id": "4bd4a3a5b01b3c8ff8fe8fe9b2bc34fbe5c3b868ecf30f162b1c6607d1770ca7",
        "timestamp": 1563607361500,
        "block_hash": "334f9033bedefb4b1ffc8419faeb4907e9494f74936b22b6f61f31517b8e44fd",
        "block_height": 826,
        "status_fail": false,
        "vote_amount": 1000000000000,
        "voter": "vp1qwelekdhu00twq0ehws5d8gh7wvuv2xr7ujqmtv",
        "voted_pub_key": "0f8669abbd3cc0a167156188e428f940088d5b2f36bb3449df71d2bdc5e077814ea3f68628eef279ed435f51ee26cff00f8bd28fabfd500bedb2a9e369f5c825",
        "size": 0,
        "type": "vote",
        "chain_status": "mainnet"
      }
    ]
  },
  "msg": "ok"
}

cross-chain/txs

get cross chain transactions by pagination Parameters

Optional:

  • Integer- page, page number of data, default 1.
  • Integer- limit, number of data per page, default 20.
  • Integer- direction, 0:cross in, 1:cross out Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - crosschain_trx_list, vote transactions object:
      • String - tx_id, vapor transaction id, hash of the transaction.
      • String - main_chain_tx_id, bytom transaction id, hash of the transaction.
      • Integer - timestamp, transaction timestamp.
      • Integer - block_height, block height.
      • String - block_hash, transaction hash of the transaction.
      • Integer - cross_amount, the amount of cross.
      • Integer - trx_fee, transaction fee.
      • Integer - size, size of transaction.
      • Boolean - status_fail, whether the state of the request has failed.
      • Integer - chain_status, mainnet or orphan.
      • String - from, from address.
      • String - to, to address.
      • Boolean - cross_in, true: from bytom to vapor; false: from vapor to bytom.
    • Array of Object - pagination, pagination info.
      • Integer- current, current number of page.
      • Integer- limit, number of data per page.
      • Integer- total, the number of total blocks.
      • Integer- timestamp, the timestamp which can accelerate query speed.
  • String - msg, error message.

Example

get transactions when page is 1,limit is 1:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/cross-chain/txs?page=1&limit=1" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "crosschain_trx_list": [
      {
        "tx_id": "d66a87bd5606ce796d92dcf22313b9eeb7b6e1bc11c714de93b9165a7431bfee",
        "main_chain_tx_id": "",
        "timestamp": 1566433284000,
        "block_hash": "42c1666adc64bac39327b001a77423a84ea62ae2c8134e652c74b0186088b85e",
        "block_height": 5618242,
        "trx_fee": 2245000,
        "cross_amount": 2000000000,
        "from": "vp1qg8mhs5x6dfurfts35cd5jvrccmlk5z595y4lzh",
        "to": "bm1qg8mhs5x6dfurfts35cd5jvrccmlk5z59l99z8p",
        "size": 0,
        "chain_status": "mainnet",
        "cross_in": false,
        "status_fail": false
      }
    ],
    "fed_bytom_addr": "-",
    "pagination": {
      "current": 1,
      "limit": 1,
      "total": 1583,
      "timestamp": 0
    }
  },
  "msg": "ok"
}

cross-chain/all/txs

get multi-asset cross-chain transactions by pagination Parameters

Optional:

  • Integer- page, page number of data, default 1.
  • Integer- limit, number of data per page, default 20.
  • Integer- direction, 0:cross in, 1:cross out Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - crosschain_trx_list, vote transactions object:
      • String - source_tx_hash_, source transaction id_, hash of the transaction.
      • String - dest_tx_hash, destination transaction id, hash of the transaction.
      • Integer - decimals, asset decimals.
      • String - symbol, asset decimals.
      • String - asset_id, asset id.
      • Integer - amount, the amount of cross.
      • Integer - source_timestamp, source transatction timestamp.
      • Integer - dest_timestamp, destination transaction timestamp.
      • String - from_address, from address.
      • String - to_address, to address.
    • Array of Object - pagination, pagination info.
      • Integer- current, current number of page.
      • Integer- limit, number of data per page.
      • Integer- total, the number of total blocks.
      • Integer- timestamp, the timestamp which can accelerate query speed.
  • String - msg, error message.

Example

get transactions when page is 1 and limit is 1 and direction is 1:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/cross-chain/all/txs?page=1&limit=3&direction=1" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "crosschain_trx_list": [
      {
        "source_tx_hash": "88cc227a34a639c4280b76181a265d4c9a8afcb30a2e4d7e6a97a4c3f1d6e377",
        "dest_tx_hash": "",
        "amount": 2200000000,
        "from_address": "vp1q8kw95s4mz69hsy3xs443h2lt9hq320806074mf",
        "to_address": "bm1q8kw95s4mz69hsy3xs443h2lt9hq320803wwg7l",
        "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
        "symbol": "BTM",
        "source_timestamp": 1568003501,
        "dest_timestamp": 0,
        "decimals": 8
      },
      {
        "source_tx_hash": "7ac14523d379803de13930a1c5ee3cc6733dd918ef5bdff8ffa1c268f627c974",
        "dest_tx_hash": "",
        "amount": 3500000000,
        "from_address": "vp1qhqf8akwk57htmagx93ne99sunx9psz2sjfsap7",
        "to_address": "bm1qhqf8akwk57htmagx93ne99sunx9psz2segqqyg",
        "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
        "symbol": "BTM",
        "source_timestamp": 1568000991,
        "dest_timestamp": 0,
        "decimals": 8
      },
      {
        "source_tx_hash": "0fc94cbd68709ada1fd2b1b6451da80f4641261f6353de0659a6615ca8dcbdfc",
        "dest_tx_hash": "",
        "amount": 1395300000000,
        "from_address": "vp1qp0kx26u2lj87ppdrzjlamqcuqvzzkg5vfwss84",
        "to_address": "bm1qp0kx26u2lj87ppdrzjlamqcuqvzzkg5vz0qdzr",
        "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
        "symbol": "BTM",
        "source_timestamp": 1567997769,
        "dest_timestamp": 0,
        "decimals": 8
      }
    ],
    "fed_bytom_addr": "-",
    "pagination": {
      "current": 1,
      "limit": 3,
      "total": 420,
      "timestamp": 0
    }
  },
  "msg": "ok"
}

address/{address_id}

Get address which asset balance and received asset amount and sent asset amount. Parameters

Object:

  • String- address_id, address Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - address, address list.
      • String - address_id, address.
      • String - asset_id, asset id.
      • String - asset_name, asset name.
      • Integer - decimals, asset decimals.
      • Integer - balance, address balance.
      • Integer - receive, address reveived asset total amount.
      • Integer - sent, address sent asset total amount.
      • Integer - timestamp, first time create address.
  • String - msg, error message.

Example

get address info when address_id is vp1qfk9kgj6mt9ga4wfnz7zqq6zkys9t84lj5t53x5:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/address/vp1qfk9kgj6mt9ga4wfnz7zqq6zkys9t84lj5t53x5" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "address": [
      {
        "address_id": "vp1qfk9kgj6mt9ga4wfnz7zqq6zkys9t84lj5t53x5",
        "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
        "asset_name": "BTM",
        "decimals": 8,
        "balance": 11730661615088,
        "receive": 23461428747242,
        "sent": 11730767132154,
        "timestamp": 1563946177000
      }
    ]
  },
  "msg": "ok"
}

address/{address_id}/cross-chain-tx

Get address that all cross-chain transactions Parameters

Object:

  • String- addres_id, address

Optional:

  • Integer- page, page number of data, default 1.
  • Integer- limit, number of data per page, default 20.
  • Integer- timestamp, timestamp of last transaction. Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - transactions, vote transactions object:
      • String - tx_id, vapor transaction id, hash of the transaction.
      • String - main_chain_tx_id, bytom transaction id, hash of the transaction.
      • Integer - timestamp, transaction timestamp.
      • Integer - block_height, block height.
      • String - block_hash, transaction hash of the transaction.
      • Integer - cross_amount, the amount of cross.
      • Integer - trx_fee, transaction fee.
      • Integer - size, size of transaction.
      • Boolean - status_fail, whether the state of the request has failed.
      • Integer - chain_status, mainnet or orphan.
      • String - from, from address.
      • String - to, to address.
      • Boolean - cross_in, true: from bytom to vapor; false: from vapor to bytom.
    • Array of Object - pagination, pagination info.
      • Integer- current, current number of page.
      • Integer- limit, number of data per page.
      • Integer- total, the number of total blocks.
      • Integer- timestamp, the timestamp which can accelerate query speed.
  • String - msg, error message.

Example

Get address's cross-chain transaction info when  address_id is vp1qfk9kgj6mt9ga4wfnz7zqq6zkys9t84lj5t53x5:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/address/vp1qfk9kgj6mt9ga4wfnz7zqq6zkys9t84lj5t53x5/cross-chain-tx" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "pagination": {
      "current": 1,
      "limit": 20,
      "total": 1,
      "timestamp": 1563946177000
    },
    "transactions": [
      {
        "tx_id": "c9ea098ac81a463c100d08bb37ffa8f1a5600b600067954053bd5b5eac0bab48",
        "main_chain_tx_id": "246c05f2461840e637d65dd7e26b7a48fabf9fd3cd0a2e8d946440b714dc9b6e",
        "timestamp": 1563946177000,
        "block_hash": "fa8f61899b88e4e11f17cc9277b90c3bffdc16dec451c714d114cd471b1d8c36",
        "block_height": 646115,
        "trx_fee": 0,
        "cross_amount": 11610900000000,
        "from": "bm1qfk9kgj6mt9ga4wfnz7zqq6zkys9t84ljl2yvrz",
        "to": "vp1qfk9kgj6mt9ga4wfnz7zqq6zkys9t84lj5t53x5",
        "size": 0,
        "chain_status": "mainnet",
        "cross_in": true,
        "status_fail": false
      }
    ]
  },
  "msg": "ok"
}

address/{address_id}/trx/{asset_id}

Get address all asset transactions Parameters

Object:

  • String- addres_id, address.
  • String- asset_id, asset id.

Optional:

  • Integer- page, page number of data, default 1.
  • Integer- limit, number of data per page, default 20.
  • Integer- timestamp, timestamp of last transaction. Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - transactions, vote transactions object:
      • String - tx_id, transaction id, hash of the transaction.
      • Integer - timestamp, transaction timestamp.
      • Integer - block_height, block height.
      • String - block_hash, transaction hash of the transaction.
      • Integer - trx_amount, the amount of transaction.
      • Integer - trx_fee, the fee of transaction.
      • Integer - size, size of transaction.
      • Boolean - status_fail, whether the state of the request has failed.
      • Integer - chain_status, mainnet or orphan.
      • Integer - coinbase, the flag of coinbase transaction.
      • Boolean - is_cross_chain, the flag of cross chain transaction.
      • Boolean - is_vote, the flag of vote transaction.
      • Integer - index_id, index in block.
      • Array of Object - inputs, object of inputs for the transaction.
        • String - type, the type of input action, available option include: 'spend', 'issue', 'coinbase'.
        • String - asset_id, asset id.
        • String - asset_alias, name of asset.
        • Object - asset_definition, definition of asset(json object).
        • Integer - amount, amount of asset.
        • Object - issuance_program, issuance program, it only exist when type is 'issue'.
        • Object - control_program, control program of account, it only exist when type is 'spend'.
        • String - address, address of account, it only exist when type is 'spend'.
        • String - spent_output_id, the front of outputID to be spent in this input, it only exist when type is 'spend'.
        • String - account_id, account id.
        • String - account_alias, name of account.
        • Object - arbitrary, arbitrary infomation can be set by miner, it only exist when type is 'coinbase'.
        • String - input_id, hash of input action.
        • Array of String - witness_arguments, witness arguments.
        • String - asset_name, asset name.
        • String - asset_decimals, decimal of asset.
      • Array of Object - outputs, object of outputs for the transaction.
        • String - type, the type of output action, available option include: 'retire', 'control'.
        • String - id, outputid related to utxo.
        • Integer - position, position of outputs.
        • String - asset_id, asset id.
        • String - asset_alias, name of asset.
        • Object - asset_definition, definition of asset(json object).
        • Integer - amount, amount of asset.
        • String - account_id, account id.
        • String - account_alias, name of account.
        • Object - control_program, control program of account.
        • String - address, address of account.
        • String - asset_name, asset name.
        • String - asset_decimals, decimal of asset.
    • Array of Object - pagination, pagination info.
      • Integer- current, current number of page.
      • Integer- limit, number of data per page.
      • Integer- total, the number of total blocks.
      • Integer- timestamp, the timestamp which can accelerate query speed.
  • String - msg, error message.

Example

get address's asset transaction info when address_id is vp1qmwqyr4tdc22kzqag2dzrxr967djaaxr3k20cff and asset_id is ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff and page is 1 and limit is 1:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/address/vp1qmwqyr4tdc22kzqag2dzrxr967djaaxr3k20cff/trx/ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff?page=1&limit=1" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "pagination": {
      "current": 1,
      "limit": 1,
      "total": 77,
      "timestamp": 1566392309500
    },
    "transactions": [
      {
        "tx_id": "559fcb5800becda0b962f17aabe9e470926e02ceb631eafd859b08ca8cb9a12d",
        "timestamp": 1566392309500,
        "block_hash": "01883c5ec1d19f0cff85ab251cf359381ab3ba15bd6461b2ebd30a4d9d447f26",
        "block_height": 5536311,
        "trx_amount": 4993200000000,
        "trx_fee": 4490000,
        "status_fail": false,
        "is_vote": false,
        "is_cross_chain": true,
        "coinbase": 0,
        "size": 0,
        "chain_status": "mainnet",
        "index_id": 5545299,
        "inputs": [
          {
            "type": "spend",
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 3990198653000,
            "control_program": "0014db8041d56dc2956103a85344330cbaf365de9871",
            "address": "vp1qmwqyr4tdc22kzqag2dzrxr967djaaxr3k20cff",
            "spent_output_id": "c17d49cc0806f4edcaadf8573ac53b347ae2dc2372ac398da87823eacd0e52a1",
            "input_id": "c5ad4c49ef8181edf7a02bdbc7fa03dd7a8034464a6acef318402b779351e634",
            "witness_arguments": [
              "4310bfd2a78c586142e391499eef8de8fe07bd00db4efa1abc26c1d8acecaeea2d925182ef9e57bcd121816e5ffd68032f180d23c361fbc567a443f5b1086a07",
              "7e046ece232ced9211bf4261c98579a4fcb66778e3e1279682d3a676924cb9d5"
            ],
            "decimals": 8,
            "symbol": "BTM"
          },
          {
            "type": "spend",
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 999999551000,
            "control_program": "0014db8041d56dc2956103a85344330cbaf365de9871",
            "address": "vp1qmwqyr4tdc22kzqag2dzrxr967djaaxr3k20cff",
            "spent_output_id": "31d56663755d38f7006799bbe958b5f01308390ae4b4622663909b5c44206ef2",
            "input_id": "621b5c8e56d88c9646c3d2b121308268031eefddbabe77e48e1200ec36979cdd",
            "witness_arguments": [
              "757a1adced039b93547fe76fde6101a2ace0d0f174f214e781a6f2bc85b174db995d059e44f5ac5cbc2933a8ed218da45ff77b2f5e55912a7a95914b7d467d09",
              "7e046ece232ced9211bf4261c98579a4fcb66778e3e1279682d3a676924cb9d5"
            ],
            "decimals": 8,
            "symbol": "BTM"
          },
          {
            "type": "spend",
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 631025134,
            "control_program": "0014db8041d56dc2956103a85344330cbaf365de9871",
            "address": "vp1qmwqyr4tdc22kzqag2dzrxr967djaaxr3k20cff",
            "spent_output_id": "bbe7e659b5faa79ea76929f0fdd00802c1c1bd719a7d25e561491fb39f57a0a8",
            "input_id": "bb3eb0853efa5050a06d77017c8ee7c2ebcbf306155bb9015f81aea19afda009",
            "witness_arguments": [
              "ccbd678c4826c0f976f9a974c4cc71459483a71562143862209f83b335491967b7075b9a64c315866f374957a3426b259e9c205a461538da3fb6571770b14607",
              "7e046ece232ced9211bf4261c98579a4fcb66778e3e1279682d3a676924cb9d5"
            ],
            "decimals": 8,
            "symbol": "BTM"
          },
          {
            "type": "spend",
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 630816018,
            "control_program": "0014db8041d56dc2956103a85344330cbaf365de9871",
            "address": "vp1qmwqyr4tdc22kzqag2dzrxr967djaaxr3k20cff",
            "spent_output_id": "f1f1657b4b210f98e3837032ee492d4e5b10a9c0c25c3fa77b0f10e13b56c936",
            "input_id": "f659a7e147bac7f3b2928b61bc19b4e8b11c490363bdc2c9c3d4b651a485d3e8",
            "witness_arguments": [
              "2a57cf4abe640384c84fb9a3c3e18769f9e7aee917fcecaab3b0524244a9b703e33b56157dc9e70ee669f37957189455e09153635dfe07c9f0c830502fae1e09",
              "7e046ece232ced9211bf4261c98579a4fcb66778e3e1279682d3a676924cb9d5"
            ],
            "decimals": 8,
            "symbol": "BTM"
          },
          {
            "type": "spend",
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 630542993,
            "control_program": "0014db8041d56dc2956103a85344330cbaf365de9871",
            "address": "vp1qmwqyr4tdc22kzqag2dzrxr967djaaxr3k20cff",
            "spent_output_id": "7d40293aed3d887a6eb327d792770c7d37e7165a7a4e70ff0563420e36f66708",
            "input_id": "ce76c6a730dff87fa33f28b7666cefa770dc68a0af54408de7f9238ee41bf245",
            "witness_arguments": [
              "3eaabed617ce4718ec39645c0bf2a560bd1d6f9cf74b833ef28e02829b6253eab424f9dcd55c379d81c869e3b7d5c4314b5c607c4017576d272b538c7b630704",
              "7e046ece232ced9211bf4261c98579a4fcb66778e3e1279682d3a676924cb9d5"
            ],
            "decimals": 8,
            "symbol": "BTM"
          }
        ],
        "outputs": [
          {
            "type": "cross_chain_out",
            "id": "f700fddae4e5e5dcf755955ce04b0b8a5898dd9874f7f87f3c5a05067150bfff",
            "position": 0,
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 4993200000000,
            "control_program": "0014db8041d56dc2956103a85344330cbaf365de9871",
            "address": "bm1qmwqyr4tdc22kzqag2dzrxr967djaaxr3atl9vl",
            "decimals": 8,
            "symbol": "BTM"
          },
          {
            "type": "control",
            "id": "a99cb12b6535d27c105f7f289e7e79fc554e3049401f70c7aeb077782d5f47a0",
            "position": 1,
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 21344157,
            "control_program": "0014db8041d56dc2956103a85344330cbaf365de9871",
            "address": "vp1qmwqyr4tdc22kzqag2dzrxr967djaaxr3k20cff",
            "decimals": 8,
            "symbol": "BTM"
          }
        ]
      }
    ]
  },
  "msg": "ok"
}

address/{address_id}/vote-tx

Get address all vote transactions

Parameters

Object:

  • String- addres_id, address.

Optional:

  • Integer- page, page number of data, default 1.
  • Integer- limit, number of data per page, default 20.
  • Integer- timestamp, timestamp of last transaction.

Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - transactions, vote transactions object:
      • String - tx_id, transaction id, hash of the transaction.
      • Integer - timestamp, transaction timestamp.
      • Integer - block_height, block height.
      • String - block_hash, transaction hash of the transaction.
      • Integer - vote_amount, the amount of vote.
      • Integer - size, size of transaction.
      • Boolean - status_fail, whether the state of the request has failed.
      • Integer - chain_status, mainnet or orphan.
      • String - voter, voter.
      • String - voted_pub_key, Who is voting for.
      • String - type, vote or veto.
      • Integer - timestamp, transaction timestamp.
      • String - name_en, the english name is voting for.
      • String - name, the name is voting for.
    • Array of Object - pagination, pagination info.
      • Integer- current, current number of page.
      • Integer- limit, number of data per page.
      • Integer- total, the number of total blocks.
      • Integer- timestamp, the timestamp which can accelerate query speed.
  • String - msg, error message.

Example

get address's asset transaction info when  address_id is vp1qmwqyr4tdc22kzqag2dzrxr967djaaxr3k20cff and page is 1 and limit is 1:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/address/vp1qmwqyr4tdc22kzqag2dzrxr967djaaxr3k20cff/vote-tx?page=1&limit=1" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "pagination": {
      "current": 1,
      "limit": 1,
      "total": 13,
      "timestamp": 1566391821500
    },
    "transactions": [
      {
        "tx_id": "a4442e2dd653052754844369703b89c8d8de78cb1e31ec8bf997b60898a5ae73",
        "timestamp": 1566391821500,
        "block_hash": "7a05a42a0c782e5c5fe1c25ecd89c0dead08abf41c94649e527bb36f072c9da7",
        "block_height": 5535335,
        "status_fail": false,
        "vote_amount": 1000000000000,
        "voter": "vp1qmwqyr4tdc22kzqag2dzrxr967djaaxr3k20cff",
        "voted_pub_key": "ff103f4c001098cad409b1b4510df7a5f808ad6759ec4588626498555b252733d80a8190b387b554c638b20e700048423851d5c3c0012bb43ac0b3736e5abb74",
        "size": 0,
        "type": "veto",
        "chain_status": "mainnet",
        "name": "三一牛币圈",
        "name_en": "三一牛币圈"
      }
    ]
  },
  "msg": "ok"
}

addresses

Get address all asset balance and received asset amount and sent asset amount.

Parameters

Object:

  • String- addres_id, address.

Optional:

  • Integer- page, page number of data, default 1.
  • Integer- limit, number of data per page, default 20.
  • Integer- timestamp, timestamp of last transaction.

Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - lists, address object:
      • String - address_id, address id.
      • String - asset_id_list, first asset id.
      • String - asset_name_list, first asset name.
      • Integer - asset_decimals_list, first asset decimals.
      • Integer - asset_balance_list, asset address first asset balance.
      • Integer - asset_receive_list, address reveived first asset total amount.
      • Integer - asset_sent_list, address sent first asset total amount.
      • Integer - timestamp, first time create address.
      • Array of Object - asset_class, asset list.
        • Integer - asset_id, asset id.
        • String - asset_name, asset name.
    • Array of Object - pagination, pagination info.
      • Integer- current, current number of page.
      • Integer- limit, number of data per page.
      • Integer- total, the number of total blocks.
      • Integer- timestamp, the timestamp which can accelerate query speed.
  • String - msg, error message.

Example

get address info when page is 1 and limit is 2:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/addresses?page=1&limit=2" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "lists": [
      {
        "address_id": "vp1qwy8kny9npdatlkxhvwtr62dhclhlhak3j5nca0",
        "asset_balance_list": 705224512829,
        "asset_class": [
          {
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "asset_name": "BTM"
          }
        ],
        "asset_decimals_list": 8,
        "asset_id_list": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
        "asset_name_list": "BTM",
        "asset_receive_list": 705224512829,
        "asset_sent_list": 0
      },
      {
        "address_id": "vp1q3yjvcnektk98de30w3l6xv5x2yeg9mwxglr3ez",
        "asset_balance_list": 608741676,
        "asset_class": [
          {
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "asset_name": "BTM"
          }
        ],
        "asset_decimals_list": 8,
        "asset_id_list": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
        "asset_name_list": "BTM",
        "asset_receive_list": 608741676,
        "asset_sent_list": 0
      }
    ],
    "pagination": {
      "current": 1,
      "limit": 2,
      "total": 2430,
      "timestamp": 0
    }
  },
  "msg": "ok"
}

asset/{asset_id}

Get asset all amount and holders and transfers in vapor network. Parameters

Object:

  • String- asset_id, asset id. Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Integer - vapor_amount, asset circulation totalcoin in vapor network.
    • Integer - vapor_holders, asset holders in vapor network.
    • Integer - vapor_transfers, asset transaction count in vapor network.
  • String - msg, error message.

Example

get asset all amount,holders,transders in vapor network when  asset_id is  ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/asset/ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "vapor_amount": 16201042913883400,
    "vapor_holders": 2432,
    "vapor_transfers": 5637676
  },
  "msg": "ok"
}

address/{address_id}/trx

Get address all cross chain transactions Parameters

Object:

  • String- addres_id, address

Optional:

  • Integer- page, page number of data, default 1.
  • Integer- limit, number of data per page, default 20.
  • Integer- timestamp, timestamp of last transaction. Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - transactions, vote transactions object:
      • String - tx_id, transaction id, hash of the transaction.
      • Integer - timestamp, transaction timestamp.
      • Integer - block_height, block height.
      • String - block_hash, transaction hash of the transaction.
      • Integer - trx_amount, the amount of transaction.
      • Integer - trx_fee, the fee of transaction.
      • Integer - size, size of transaction.
      • Boolean - status_fail, whether the state of the request has failed.
      • Integer - chain_status, mainnet or orphan.
      • Integer - coinbase, the flag of coinbase transaction.
      • Boolean - is_cross_chain, the flag of cross chain transaction.
      • Boolean - is_vote, the flag of vote transaction.
      • Integer - index_id, index in block.
      • Array of Object - inputs, object of inputs for the transaction.
        • String - type, the type of input action, available option include: 'spend', 'issue', 'coinbase'.
        • String - asset_id, asset id.
        • String - asset_alias, name of asset.
        • Object - asset_definition, definition of asset(json object).
        • Integer - amount, amount of asset.
        • Object - issuance_program, issuance program*, it only exist when type is 'issue'.
        • Object - control_program, control program of account*, it only exist when type is 'spend'.
        • String - address, address of account*, it only exist when type is 'spend'.
        • String - spent_output_id, the front of outputID to be spent in this input, it only exist when type is 'spend'.
        • String - account_id, account id.
        • String - account_alias, name of account.
        • Object - arbitrary, arbitrary infomation can be set by miner, it only exist when type is 'coinbase'.
        • String - input_id, hash of input action.
        • Array of String - witness_arguments, witness arguments.
        • String - asset_name, asset name.
        • String - asset_decimals, decimal of asset.
      • Array of Object - outputs, object of outputs for the transaction.
        • String - type, the type of output action, available option include: 'retire', 'control'.
        • String - id, outputid related to utxo.
        • Integer - position, position of outputs.
        • String - asset_id, asset id.
        • String - asset_alias, name of asset.
        • Object - asset_definition, definition of asset(json object).
        • Integer - amount, amount of asset.
        • String - account_id, account id.
        • String - account_alias, name of account.
        • Object - control_program, control program of account.
        • String - address, address of account.
        • String - asset_name, asset name.
        • String - asset_decimals, decimal of asset.
    • Array of Object - pagination, pagination info.
      • Integer- current, current number of page.
      • Integer- limit, number of data per page.
      • Integer- total, the number of total blocks.
      • Integer- timestamp, the timestamp which can accelerate query speed.
  • String - msg, error message.

Example

get asset transaction info when asset_id si ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff and page is 1 and limit is 1:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/asset/ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff/trxs?page=1&limit=1" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "pagination": {
      "current": 1,
      "limit": 1,
      "total": 5647807,
      "timestamp": 0
    },
    "transactions": [
      {
        "tx_id": "ddfbaa0e9b82e05c600b357e3181efddbd17644b7274869ae800b3a5b1b62d59",
        "timestamp": 1566443519000,
        "block_hash": "dda3d29c16e422b676e315aa5eba7e9a034ed316b26fcc2e14eb4a45121f4e5a",
        "block_height": 5638705,
        "trx_amount": 0,
        "trx_fee": 0,
        "status_fail": false,
        "is_vote": false,
        "is_cross_chain": false,
        "coinbase": 1,
        "size": 0,
        "chain_status": "mainnet",
        "index_id": 5647807,
        "inputs": [
          {
            "type": "coinbase",
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "arbitrary": "0035363338373035",
            "input_id": "e4a2034251750855d2f5418afc6b1ca3bdddd89f4ec9a849f737b614a345056a",
            "witness_arguments": [],
            "decimals": 8,
            "symbol": "BTM"
          }
        ],
        "outputs": [
          {
            "type": "control",
            "id": "b1c4351147016c84576a022926b507efafcf33918d357f02f0f50c1c7f53539e",
            "position": 0,
            "asset_id": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
            "amount": 0,
            "control_program": "0014b5dadc3e717d9892bdb0594a5933863df16c14c4",
            "address": "vp1qkhddc0n30kvf90dst999jvux8hckc9xyxwujna",
            "decimals": 8,
            "symbol": "BTM"
          }
        ]
      }
    ]
  },
  "msg": "ok"
}

stat

Get address count, asset count, top height, max transactions per second, transaction daily count and total count Parameters

None Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Integer - address_count, the sum of address number.
    • Integer - asset_count, the sum of asset number.
    • String - height, top height.
    • Integer - max_tps, max tps.
    • Integer - trx_daily_count, the sum of transaction number(one day).
    • Integer - trx_total_count, the sum of all transaction number.
  • String - msg, error message. Example

get stat:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/stat" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "address_count": 2432,
    "asset_count": 125,
    "height": 5639154,
    "max_tps": 8513,
    "trx_daily_count": 174033,
    "trx_total_count": 5648262
  },
  "msg": "ok"
}

stat/trx/daily

Get daily trading volume Parameters

Optional:

  • Integer- days, number of day. Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - days_trx_count, transaction count object.
      • Integer - date_time, statistic time.
      • Integer - trx_count, that day's transaction count.
  • String - msg, error message.

Example

get history transaction count:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/stat/trx/daily?days=12" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "days_trx_count": [
      {
        "date_time": 1565193600000,
        "trx_count": 172888
      },
      {
        "date_time": 1565280000000,
        "trx_count": 172906
      },
      {
        "date_time": 1565366400000,
        "trx_count": 173045
      },
      {
        "date_time": 1565452800000,
        "trx_count": 173044
      },
      {
        "date_time": 1565539200000,
        "trx_count": 172779
      },
      {
        "date_time": 1565625600000,
        "trx_count": 172453
      },
      {
        "date_time": 1565712000000,
        "trx_count": 172918
      },
      {
        "date_time": 1565798400000,
        "trx_count": 172914
      },
      {
        "date_time": 1565884800000,
        "trx_count": 172947
      },
      {
        "date_time": 1565971200000,
        "trx_count": 172919
      },
      {
        "date_time": 1566057600000,
        "trx_count": 172910
      },
      {
        "date_time": 1566144000000,
        "trx_count": 173327
      },
      {
        "date_time": 1566230400000,
        "trx_count": 172997
      },
      {
        "date_time": 1566316800000,
        "trx_count": 174009
      }
    ]
  },
  "msg": "ok"
}

en/node/{name}.   zn/node/{name}

Get super node info by name

Parameters

Object:

  • String- name, address

Optional:

  • Integer- page, page number of data, default 1.
  • Integer- limit, number of data per page, default 20.

Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - node_infos, super node object:
      • String - uuid, node uuid.
      • String - name, node name.
      • String - location, node location.
      • String - name_en, node english name.
      • String - location_en, node english location.
      • String - homepage, node homepage.
      • String - homepage_en, node english homepage
      • String - pub_key, node public key.
      • String - introduce, node introduce.
      • String - introduce_en, node english introduce.
      • String - node_type_en, node type english introduce.
      • String - node_type, node type(Exchange,Wallet,Investment institution, Investor, DApp development team, KOL, Web portal, Marketing company, Development team, BP/miners, Blockchain education institutions, Others).
      • String - reward, distribution ratio.
      • String - expected_return, vote expected return.
      • String - logo, node log url.
      • String - social_list, contact information.
      • String - social_list_en, english contact information.
      • String - declaration, election manifesto.
      • String - declaration_en, english election manifesto.
    • Array of Object - pagination, pagination info.
      • Integer- current, current number of page.
      • Integer- limit, number of data per page.
      • Integer- total, the number of total blocks.
      • Integer- timestamp, the timestamp which can accelerate query speed.
  • String - msg, error message.

Example

get super node which name include ma when name is ma:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/en/node/ma" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "node_infos": [
      {
        "uuid": "4817e7c299d5a6e5bf72b7f54e08ebce",
        "name": "MatPool",
        "location": "中国",
        "name_en": "MatPool",
        "location_en": "China",
        "homepage": "https://matpool.io/",
        "homepage_en": "",
        "pub_key": "0f8669abbd3cc0a167156188e428f940088d5b2f36bb3449df71d2bdc5e077814ea3f68628eef279ed435f51ee26cff00f8bd28fabfd500bedb2a9e369f5c825",
        "introduce": "MatPool是国内领先的区块链信息服务商巴比特旗下矿池产品,前 Facebook 早期工程师金磊担任项目负责兼 CTO,巴比特合伙人李宗乘出任首席运营官 COO,这是一个成长中的矿池,其背后团队由区块链、人工智能资深开发人员组成。矿池不仅支持POW、PoS、DPoS、PBFT等共识机制主链挖矿,还将提供AI云算力服务业务。",
        "introduce_en": "MatPool是国内领先的区块链信息服务商巴比特旗下矿池产品,前 Facebook 早期工程师金磊担任项目负责兼 CTO,巴比特合伙人李宗乘出任首席运营官 COO,这是一个成长中的矿池,其背后团队由区块链、人工智能资深开发人员组成。矿池不仅支持POW、PoS、DPoS、PBFT等共识机制主链挖矿,还将提供AI云算力服务业务。",
        "node_type": "区块生产者/矿工",
        "node_type_en": "BP/miners",
        "reward": "90%",
        "expected_return": "4.7560%",
        "logo": "https://api.bystack.com/supernode/v1/uploads/1562316066.53449061_14.png",
        "social_list": "微信*xiaxxxxxxxxxxxx\nQQ群*https://jq.qq.com/?_wv=1027&k=5f1IVQ9\n链节点*https://www.chainnode.com/user/572758",
        "social_list_en": "WeChat*xiaxxxxxxxxxxxx\nQQ Group*https://jq.qq.com/?_wv=1027&k=5f1IVQ9\nChainNode*https://www.chainnode.com/user/572758",
        "declaration": "MatPool作为巴比特旗下矿池,第一,MatPool拥有多种媒体宣发途径,会通过巴比特、链节点等平台为Bystack提供流量支持;第二,MatPool将作为社区 KOL 参与社区节点共建计划,为社群成员普及Btm及Bystack发展前景,促进社群成员对Bystack的深刻认识;第三MatPool作为作为一个多币种的矿池平台,支持更多PoS、DPoS、PBFT等依托权益证明共识机制的主链,因此能够促进Bystack与其他优质项目各方面的合作,包括技术,应用和社群等各方面的交流合作,促进Bystack的良性发展。MatPool希望成为维护Bystack区块链网络的共识节点,助力Bystack的大规模商业区块链应用落地",
        "declaration_en": "MatPool作为巴比特旗下矿池,第一,MatPool拥有多种媒体宣发途径,会通过巴比特、链节点等平台为Bystack提供流量支持;第二,MatPool将作为社区 KOL 参与社区节点共建计划,为社群成员普及Btm及Bystack发展前景,促进社群成员对Bystack的深刻认识;第三MatPool作为作为一个多币种的矿池平台,支持更多PoS、DPoS、PBFT等依托权益证明共识机制的主链,因此能够促进Bystack与其他优质项目各方面的合作,包括技术,应用和社群等各方面的交流合作,促进Bystack的良性发展。MatPool希望成为维护Bystack区块链网络的共识节点,助力Bystack的大规模商业区块链应用落地"
      },
      {
        "uuid": "53e311d1a75213d9d6097c1c1d8f11ae",
        "name": "麦子钱包",
        "location": "新加坡",
        "name_en": "MathWallet",
        "location_en": "Singapore",
        "homepage": "http://mathwallet.org",
        "homepage_en": "",
        "pub_key": "c3da521c8f0d7dd5cfb28def43c8360c81d8f4b24bf6dac20bb653654957262df6bf6875a1350effada299939a8a74574399cac8b7ad0bbffde2f68a7982a59f",
        "introduce": "麦子钱包是一个多平台的跨链钱包,产品包括 APP 钱包、网页钱包、浏览器插件钱包、硬件钱包等,且支持18个公链生态,支持去中心化的跨链交易,并构建了一个多链的 DApp 生态系统。麦子也是多个公链社区的POS节点。",
        "introduce_en": "麦子钱包是一个多平台的跨链钱包,产品包括 APP 钱包、网页钱包、浏览器插件钱包、硬件钱包等,且支持18个公链生态,支持去中心化的跨链交易,并构建了一个多链的 DApp 生态系统。麦子也是多个公链社区的POS节点。",
        "node_type": "钱包",
        "node_type_en": "Wallet",
        "reward": "60%",
        "expected_return": "5.3859%",
        "logo": "https://api.bystack.com/supernode/v1/uploads/1562315854.84656481_2.png",
        "social_list": "微信*mathwallet666\nTelegram*https://t.me/mathwallet",
        "social_list_en": "WeChat*mathwallet666\nTelegram*https://t.me/mathwallet",
        "declaration": "2019/6 - 参与测试网络 2019/7 - 社群宣传、并参与正式网络 2019/8 - 支持BTM钱包,麦子钱包与您一起共建互信网络。",
        "declaration_en": "2019/6 - 参与测试网络 2019/7 - 社群宣传、并参与正式网络 2019/8 - 支持BTM钱包,麦子钱包与您一起共建互信网络。"
      }
    ],
    "pagination": {
      "current": 1,
      "limit": 20,
      "total": 2,
      "timestamp": 0
    }
  },
  "msg": "ok"
}

node/{pub_key}

Get super node info by public key

Parameters

Object:

  • String- pub_key, node's public

Optional:

  • Integer- page, page number of node's vote, default 1.
  • Integer- limit, number of node's vote per page, default 20.

Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Integer - blocker_count, the height of the block when calculate blocker reward.
    • Integer - blocker_reward, blocker reward in 'blocker_count' height.
    • Integer - node_pay_amount, payment amount for voter.
    • Integer - staking_calc_time, the time of the node when calculate staking reward.
    • Integer - staking_reward, staking reward on 'staking_calc_time'.
    • Integer - vote_total_count, total votes for all addresses.
    • Object - super_node_detail, super node object:
      • String - uuid, node uuid.
      • String - name, node name.
      • String - location, node location.
      • String - name_en, node english name.
      • String - location_en, node english location.
      • String - homepage, node homepage.
      • String - homepage_en, node english homepage
      • String - pub_key, node public key.
      • String - introduce, node introduce.
      • String - introduce_en, node english introduce.
      • String - node_type_en, node type english introduce.
      • String - node_type, node type(Exchange,Wallet,Investment institution, Investor, DApp development team, KOL, Web portal, Marketing company, Development team, BP/miners, Blockchain education institutions, Others).
      • String - reward, distribution ratio.
      • String - expected_return, vote expected return.
      • String - logo, node log url.
      • String - social_list, contact information.
      • String - social_list_en, english contact information.
      • String - declaration, election manifesto.
      • String - declaration_en, english election manifesto.
    • Object - super_node, object of super node's data which on chain.
      • String - name, node name.
      • String - location, node location.
      • String - name_en, node english name.
      • String - location_en, node english location.
      • String - address, node address.
      • String - pub_key, node public key.
      • Integer - first_timestamp, first time of producting block.
      • Integer - last_timestamp, latest time of producting block.
      • Integer - vote_count, number of votes.
      • Integer - product_blocks, numbers of prodcuting block.
      • String - ratio, vote real return.
      • Integer - last_pay_time, last payment time.
    • Array of Object - vote_list, vote transactions object:
      • String - tx_id, transaction id, hash of the transaction.
      • Integer - timestamp, transaction timestamp.
      • Integer - block_height, block height.
      • String - block_hash, transaction hash of the transaction.
      • Integer - vote_amount, the amount of vote.
      • Integer - size, size of transaction.
      • Boolean - status_fail, whether the state of the request has failed.
      • Integer - chain_status, mainnet or orphan.
      • String - voter, voter.
      • String - voted_pub_key, Who is voting for.
    • Array of Object - pagination, pagination info.
      • Integer- current, current number of page.
      • Integer- limit, number of data per page.
      • Integer- total, the number of total blocks.
      • Integer- timestamp, the timestamp which can accelerate query speed.
  • String - msg, error message.

Example

get super node when  pub_key is 1bec3a35da038ec7a76c40986e80b5af2dcef60341970e3fc58b4db0797bd4ca9b2cbf3d7ab820832e22a80b5b86ae1427f7f706a7780089958b2862e7bc0842:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/node/1bec3a35da038ec7a76c40986e80b5af2dcef60341970e3fc58b4db0797bd4ca9b2cbf3d7ab820832e22a80b5b86ae1427f7f706a7780089958b2862e7bc0842?page=1&limit=1" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "blocker_count": 565626,
    "blocker_reward": 5380765069188,
    "node_pay_amount": 2877072094158,
    "pagination": {
      "current": 1,
      "limit": 1,
      "total": 205,
      "timestamp": 0
    },
    "staking_calc_time": 0,
    "staking_reward": 0,
    "super_node": {
      "name": "火币矿池",
      "location": "中国",
      "name_en": "Huobi Pool",
      "location_en": "China",
      "address": "vp1q4x035zdv5c6yt9jxvjmnct9kjeypgc8jp99hug",
      "pub_key": "1bec3a35da038ec7a76c40986e80b5af2dcef60341970e3fc58b4db0797bd4ca9b2cbf3d7ab820832e22a80b5b86ae1427f7f706a7780089958b2862e7bc0842",
      "first_timestamp": 1563661126500,
      "last_timestamp": 1566524121500,
      "vote_count": 2162497886200000,
      "product_blocks": 572545,
      "ratio": "4.7367",
      "last_pay_time": 1566436625000
    },
    "super_node_detail": {
      "uuid": "3e50e6a0ac90a441a660c1383a2947b0",
      "name": "火币矿池",
      "location": "中国",
      "name_en": "Huobi Pool",
      "location_en": "China",
      "homepage": "https://www.huobipool.com",
      "homepage_en": "",
      "pub_key": "1bec3a35da038ec7a76c40986e80b5af2dcef60341970e3fc58b4db0797bd4ca9b2cbf3d7ab820832e22a80b5b86ae1427f7f706a7780089958b2862e7bc0842",
      "introduce": "火币矿池拥有两大业务,POW矿池与EOS超级社区。 POW矿池致力于为矿工提供收益更多更快、交易更便捷的一站式挖矿服务,独具3大优势:独家套保服务,可提前获取收益;挖矿手续费低,点卡可直接抵扣;直通火币交易平台,一键交易。 EOS超级社区致力于为用户提供专业投票、海量资讯和积分理财一站式服务,具备3大亮点:拥有全球最大最专业的EOS投票平台,作为EOS链上投票平台,安全高效;覆盖全球海量渠道,囊括EOS资讯;发行火币矿池全球生态通证,积分可以为您喜欢的DAPP进行投票。 EOS超级社区,连接用户和全球EOS节点,为构筑EOS繁荣生态提供平台支撑。 火币品牌在全球区块链领域拥有优异的知名度和口碑。",
      "introduce_en": "火币矿池拥有两大业务,POW矿池与EOS超级社区。 POW矿池致力于为矿工提供收益更多更快、交易更便捷的一站式挖矿服务,独具3大优势:独家套保服务,可提前获取收益;挖矿手续费低,点卡可直接抵扣;直通火币交易平台,一键交易。 EOS超级社区致力于为用户提供专业投票、海量资讯和积分理财一站式服务,具备3大亮点:拥有全球最大最专业的EOS投票平台,作为EOS链上投票平台,安全高效;覆盖全球海量渠道,囊括EOS资讯;发行火币矿池全球生态通证,积分可以为您喜欢的DAPP进行投票。 EOS超级社区,连接用户和全球EOS节点,为构筑EOS繁荣生态提供平台支撑。 火币品牌在全球区块链领域拥有优异的知名度和口碑。",
      "node_type": "门户网站",
      "node_type_en": "Web portal",
      "reward": "85%",
      "expected_return": "2.3553%",
      "logo": "https://api.bystack.com/supernode/v1/uploads/1562137632.8043804.png",
      "social_list": "微信客服*Huobipool02(备注BTM)\nTelegram*https://t.me/joinchat/IIM1LRITqjScyUEKpZNedQ",
      "social_list_en": "WeChat*Huobipool02(备注BTM)\nTelegram*https://t.me/joinchat/IIM1LRITqjScyUEKpZNedQ",
      "declaration": "火币矿池目前已完成POW系统升级,多方面优化用户体验,多币种挖矿,包含LTC、ETH、ETC、DCR。火币矿池开启“双挖”模式,挖BTC、BCH、LTC、ETH、ETC、DCR同时可挖HPT,持有HPT获得权益派发包括EOS、TRX、CMT、ONG,欢迎您来体验!我们让挖矿更简单!火币矿池共筑区块链繁荣生态。",
      "declaration_en": "火币矿池目前已完成POW系统升级,多方面优化用户体验,多币种挖矿,包含LTC、ETH、ETC、DCR。火币矿池开启“双挖”模式,挖BTC、BCH、LTC、ETH、ETC、DCR同时可挖HPT,持有HPT获得权益派发包括EOS、TRX、CMT、ONG,欢迎您来体验!我们让挖矿更简单!火币矿池共筑区块链繁荣生态。"
    },
    "vote_list": [
      {
        "tx_id": "6f8a7354592d5f2cf2a53926390330bbb2cd288872408b618b21d36d2f8874e1",
        "timestamp": 1566518490500,
        "block_hash": "494a78b9cd21166b6153385d139087f39fddd677939166041f331d3376474bca",
        "block_height": 5788590,
        "status_fail": false,
        "vote_amount": 3000000000000,
        "voter": "vp1q9mrdy6f0r9j0uc4mlkt8lv8fsxd3skxh2v9z9e",
        "voted_pub_key": "1bec3a35da038ec7a76c40986e80b5af2dcef60341970e3fc58b4db0797bd4ca9b2cbf3d7ab820832e22a80b5b86ae1427f7f706a7780089958b2862e7bc0842",
        "size": 0,
        "type": "veto",
        "chain_status": "mainnet"
      }
    ],
    "vote_total_count": 15634838021494996
  },
  "msg": "ok"
}

nodes

Get all super node Parameters

None Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Object - lists, object of super node's data which on chain.
      • String - name, node name.
      • String - location, node location.
      • String - name_en, node english name.
      • String - location_en, node english location.
      • String - address, node address.
      • String - pub_key, node public key.
      • Integer - first_timestamp, first time of producting block.
      • Integer - last_timestamp, latest time of producting block.
      • Integer - vote_count, number of votes.
      • Integer - product_blocks, numbers of prodcuting block.
      • String - ratio, vote real return.
      • Integer - last_pay_time, last payment time.
      • String - address, host + port
      • String - status,  node status [unknown, healthy, congested,orphan,offline]
      • Integer - updated_at,  Recently detected time
    • Integer- node_total, numbers of node.
    • Integer- vote_total_count, numbers of vote amount.
  • String - msg, error message.

Example

get all super node:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/nodes" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "lists": [
      {
        "name": "火币矿池",
        "location": "中国",
        "name_en": "Huobi Pool",
        "location_en": "China",
        "address": "vp1q4x035zdv5c6yt9jxvjmnct9kjeypgc8jp99hug",
        "pub_key": "1bec3a35da038ec7a76c40986e80b5af2dcef60341970e3fc58b4db0797bd4ca9b2cbf3d7ab820832e22a80b5b86ae1427f7f706a7780089958b2862e7bc0842",
        "first_timestamp": 1563661126500,
        "last_timestamp": 1566523881500,
        "vote_count": 2162497886200000,
        "product_blocks": 572497,
        "type": "formal",
        "ratio": "4.7367",
        "last_pay_time": 1566436625000,
        "expected_return": "2.3553%",
        "node_reward": 5380765069188,
        "address": "52.194.77.99:56656",
        "status": "congested",
        "updated_at": 1568013934
      },
      {
        "name": "MatPool",
        "location": "中国",
        "name_en": "MatPool",
        "location_en": "China",
        "address": "vp1ql4dakjlqhndda7xh0smz38j847e265fft3gz4u",
        "pub_key": "0f8669abbd3cc0a167156188e428f940088d5b2f36bb3449df71d2bdc5e077814ea3f68628eef279ed435f51ee26cff00f8bd28fabfd500bedb2a9e369f5c825",
        "first_timestamp": 1563608517000,
        "last_timestamp": 1566523887500,
        "vote_count": 1135689295000000,
        "product_blocks": 600280,
        "type": "formal",
        "ratio": "4.7356",
        "last_pay_time": 1566444876500,
        "expected_return": "4.7560%",
        "node_reward": 5645129616208,
        "address": "52.144.83.66:56656",
        "status": "congested",
        "updated_at": 1568013934
      },
      {
        "name": "ZB",
        "location": "瑞士",
        "name_en": "ZB",
        "location_en": "Switzerland",
        "address": "vp1qkhddc0n30kvf90dst999jvux8hckc9xyxwujna",
        "pub_key": "27db67692ef909b2d652cae4fd1d26ad83fb9554ffe8271e8811495ab74e489360968dfb6d7d7416eb37ac5ca04d2cb6b8a2745b6e192521e95c6d238d946075",
        "first_timestamp": 1563782642500,
        "last_timestamp": 1566523893500,
        "vote_count": 1087959770000000,
        "product_blocks": 548269,
        "type": "formal",
        "expected_return": "4.9634%",
        "node_reward": 5150352197890,
        "address": "52.194.83.44:56656",
        "status": "congested",
        "updated_at": 1568013934
      },
      ],
    "node_total": 3,
    "vote_total_count": 3162497886200000
  },
  "msg": "ok"
}

nodes/detail

Get all super node detail Parameters

None Returns

Object:

  • Integer- code, error code.
  • Object - data, block details.
    • Array of Object - nodes_detail, super node object:
      • String - uuid, node uuid.
      • String - name, node name.
      • String - location, node location.
      • String - name_en, node english name.
      • String - location_en, node english location.
      • String - homepage, node homepage.
      • String - homepage_en, node english homepage
      • String - pub_key, node public key.
      • String - introduce, node introduce.
      • String - introduce_en, node english introduce.
      • String - node_type_en, node type english introduce.
      • String - node_type, node type(Exchange,Wallet,Investment institution, Investor, DApp development team, KOL, Web portal, Marketing company, Development team, BP/miners, Blockchain education institutions, Others).
      • String - reward, distribution ratio.
      • String - expected_return, vote expected return.
      • String - logo, node log url.
      • String - social_list, contact information.
      • String - social_list_en, english contact information.
      • String - declaration, election manifesto.
      • String - declaration_en, english election manifesto.
  • String - msg, error message.

Example

get all super node detail:

// Request
curl -X GET "https://vapor.blockmeta.com/api/v1/nodes/detail" -H "accept: application/json"

// Result
{
  "code": 200,
  "data": {
    "nodes_detail": [
      {
        "uuid": "4817e7c299d5a6e5bf72b7f54e08ebce",
        "name": "MatPool",
        "location": "中国",
        "name_en": "MatPool",
        "location_en": "China",
        "homepage": "https://matpool.io/",
        "homepage_en": "",
        "pub_key": "0f8669abbd3cc0a167156188e428f940088d5b2f36bb3449df71d2bdc5e077814ea3f68628eef279ed435f51ee26cff00f8bd28fabfd500bedb2a9e369f5c825",
        "introduce": "MatPool是国内领先的区块链信息服务商巴比特旗下矿池产品,前 Facebook 早期工程师金磊担任项目负责兼 CTO,巴比特合伙人李宗乘出任首席运营官 COO,这是一个成长中的矿池,其背后团队由区块链、人工智能资深开发人员组成。矿池不仅支持POW、PoS、DPoS、PBFT等共识机制主链挖矿,还将提供AI云算力服务业务。",
        "introduce_en": "MatPool是国内领先的区块链信息服务商巴比特旗下矿池产品,前 Facebook 早期工程师金磊担任项目负责兼 CTO,巴比特合伙人李宗乘出任首席运营官 COO,这是一个成长中的矿池,其背后团队由区块链、人工智能资深开发人员组成。矿池不仅支持POW、PoS、DPoS、PBFT等共识机制主链挖矿,还将提供AI云算力服务业务。",
        "node_type": "区块生产者/矿工",
        "node_type_en": "BP/miners",
        "reward": "90%",
        "expected_return": "4.7560%",
        "logo": "https://api.bystack.com/supernode/v1/uploads/1562316066.53449061_14.png",
        "social_list": "微信*xiaxxxxxxxxxxxx\nQQ群*https://jq.qq.com/?_wv=1027&k=5f1IVQ9\n链节点*https://www.chainnode.com/user/572758",
        "social_list_en": "WeChat*xiaxxxxxxxxxxxx\nQQ Group*https://jq.qq.com/?_wv=1027&k=5f1IVQ9\nChainNode*https://www.chainnode.com/user/572758",
        "declaration": "MatPool作为巴比特旗下矿池,第一,MatPool拥有多种媒体宣发途径,会通过巴比特、链节点等平台为Bystack提供流量支持;第二,MatPool将作为社区 KOL 参与社区节点共建计划,为社群成员普及Btm及Bystack发展前景,促进社群成员对Bystack的深刻认识;第三MatPool作为作为一个多币种的矿池平台,支持更多PoS、DPoS、PBFT等依托权益证明共识机制的主链,因此能够促进Bystack与其他优质项目各方面的合作,包括技术,应用和社群等各方面的交流合作,促进Bystack的良性发展。MatPool希望成为维护Bystack区块链网络的共识节点,助力Bystack的大规模商业区块链应用落地",
        "declaration_en": "MatPool作为巴比特旗下矿池,第一,MatPool拥有多种媒体宣发途径,会通过巴比特、链节点等平台为Bystack提供流量支持;第二,MatPool将作为社区 KOL 参与社区节点共建计划,为社群成员普及Btm及Bystack发展前景,促进社群成员对Bystack的深刻认识;第三MatPool作为作为一个多币种的矿池平台,支持更多PoS、DPoS、PBFT等依托权益证明共识机制的主链,因此能够促进Bystack与其他优质项目各方面的合作,包括技术,应用和社群等各方面的交流合作,促进Bystack的良性发展。MatPool希望成为维护Bystack区块链网络的共识节点,助力Bystack的大规模商业区块链应用落地"
      },
      {
        "uuid": "492d8e5ac3967b7d3a71f3c1347cfd87",
        "name": "Stake.One",
        "location": "中国",
        "name_en": "Stake.One",
        "location_en": "China",
        "homepage": "-",
        "homepage_en": "",
        "pub_key": " ",
        "introduce": "Stake.One是由原OK资本商务负责人、CoinAll币全副总裁王一丁创立、由了得资本创始人易理华、创世资本创始人孙泽宇投资的一家专注于POS Staking服务的POS矿池。Stake.One依托多年行业经验及行业资源,与各大公链项目共同在交易所、市场、社群层面建设和拓展其生态。",
        "introduce_en": "Stake.One是由原OK资本商务负责人、CoinAll币全副总裁王一丁创立、由了得资本创始人易理华、创世资本创始人孙泽宇投资的一家专注于POS Staking服务的POS矿池。Stake.One依托多年行业经验及行业资源,与各大公链项目共同在交易所、市场、社群层面建设和拓展其生态。",
        "node_type": "区块生产者/矿工",
        "node_type_en": "BP/miners",
        "reward": "70%",
        "expected_return": "",
        "logo": "https://api.bystack.com/supernode/v1/uploads/1563498745.9475577stake.png",
        "social_list": "-",
        "social_list_en": "-",
        "declaration": "Stake.One将在Staking方向同了得资本、创世资本、MXC交易所、LBank交易所战略合作,深度参与Bystack生态的共建,在市场、社群、交易所等多个方面共同推动比原长期稳步的发展。",
        "declaration_en": "Stake.One将在Staking方向同了得资本、创世资本、MXC交易所、LBank交易所战略合作,深度参与Bystack生态的共建,在市场、社群、交易所等多个方面共同推动比原长期稳步的发展。"
      },
      ]
  },
  "msg": "ok"
}
上次更新: 3/30/2020, 11:49:24 AM