Dashboard API

From VeriBlock Wiki
Jump to: navigation, search

See: Main_Page

Overview

These are some of the public APIs used by the dashboard to retrieve data.

https://testnet.explore.veriblock.org

These are still in Testnet, and may change.

Block

block/<height>

https://testnet.explore.veriblock.org/api/block/23731

Returns same output as: block/<hash>

block/<hash>

https://testnet.explore.veriblock.org/api/block/00000001176E53EA4CB9872910F9E567C6DC4B09C01DBB6B

{
   "coinbaseTransaction":{
      "txId":"56FADC13E5358B308190A7FEF195E4AE4E94A2A61602A17153A7610B166430E7",
      "poWCoinbaseAmount":"3500000000",
      "poPCoinbaseAmount":"0",
      "poWFeeShare":"0",
      "poPFeeShare":"1",
      "poWOutputs":[
         {
            "address":"V8dy5tWcP7y36kxiJwxKPKUrWAJbjs",
            "amount":"3500000000"
         }
      ],
      "poPOutputs":[

      ]
   },
   "extraNonce":"1000000",
   "number":23731,
   "timestamp":1523471236,
   "hash":"00000001176E53EA4CB9872910F9E567C6DC4B09C01DBB6B",
   "previousHash":"00000001729191297AEB9CB938DE9EC887B93A720DE10D78",
   "difficulty":73356734,
   "winningNonce":424815302,
   "transactionCount":1,
   "poPTransactionCount":6,
   "fees":"1",
   "poWCoinbaseReward":"3500000000",
   "poPCoinbaseReward":"0",
   "coinbaseReward":"3500000000",
   "size":61,
   "ledgerHash":"2C52EAAED1675B9627F584C8E290A026AAD5AB69529E421B",
   "minerComment":"Default NodeCore Pool Software"
}

--

block?count=N

https://testnet.explore.veriblock.org/api/block?count=3

[
   {
      "number":30008,
      "timestamp":1525202495,
      "hash":"00000011528B98032F9AEC7E2D8185855A7F6E42BBDCF634",
      "previousHash":"00000000687DF0843C4935466516B2CB2B5BE1C716423619",
      "difficulty":68038033,
      "winningNonce":1520483838,
      "transactionCount":1,
      "poPTransactionCount":0,
      "fees":"1",
      "poWCoinbaseReward":"3500000000",
      "poPCoinbaseReward":"0",
      "coinbaseReward":"3500000000",
      "size":61,
      "ledgerHash":"F45C0EE48C87FCDE139F7637D92EB2B80EE4C816EA461A62",
      "minerComment":"Default NodeCore Pool Software"
   },
   {
      "number":30007,
      "timestamp":1525202401,
      "hash":"00000000687DF0843C4935466516B2CB2B5BE1C716423619",
      "previousHash":"0000000040823C53285580CF2A98A38ED1454A6B25686B80",
      "difficulty":68038033,
      "winningNonce":-1117829961,
      "transactionCount":1,
      "poPTransactionCount":0,
      "fees":"1",
      "poWCoinbaseReward":"3500000000",
      "poPCoinbaseReward":"0",
      "coinbaseReward":"3500000000",
      "size":61,
      "ledgerHash":"2E7FD03953299272B08E3565827E245ECBC982E912ABDBB1",
      "minerComment":"Default NodeCore Pool Software"
   },
   {
      "number":30006,
      "timestamp":1525202368,
      "hash":"0000000040823C53285580CF2A98A38ED1454A6B25686B80",
      "previousHash":"000000009071102F01E46BE606674B2EE642EFDB7A5CF21A",
      "difficulty":68038033,
      "winningNonce":-1540725286,
      "transactionCount":1,
      "poPTransactionCount":0,
      "fees":"1",
      "poWCoinbaseReward":"3500000000",
      "poPCoinbaseReward":"0",
      "coinbaseReward":"3500000000",
      "size":61,
      "ledgerHash":"D1148AFDB81421DAC904DBA5B0CF45781C39F932CBC623FE",
      "minerComment":"Default NodeCore Pool Software"
   }
]


block/<height>/transactions

https://testnet.explore.veriblock.org/api/block/29995/transactions

[
   {
      "timestamp":1525201652,
      "signedState":"Signed",
      "type":"Standard",
      "sourceAddress":"V7aFSJpHHpbfsVTQPuYbDeL97A5aik",
      "sourceAmount":"3500000000",
      "outputs":[
         {
            "address":"VDd3rkzM4GLEvdYuHftQNx3dSDS22s",
            "amount":"3499999999"
         }
      ],
      "transactionFee":"1",
      "merklePath":"",
      "size":61,
      "txId":"16CCBF1D4E84BE4FEB3812E2493B9F1079F16D92DBBFD59A960F83C803E89447",
      "blockHash":"00000000B096AF506FE36A2679A1A8452C72B4A718C7FAE8"
   }
]

Address

address/<id>

https://testnet.explore.veriblock.org/api/address/V7aFSJpHHpbfsVTQPuYbDeL97A5aik

{  
   "address":"V7aFSJpHHpbfsVTQPuYbDeL97A5aik",
   "balance":"17500000006",
   "blocksMined":"2142",
   "transactionCount":2137,
   "poPTransactionCount":0
}

Transaction

tx/<TxId>

https://testnet.explore.veriblock.org/api/tx/771CE6D2B1BCEB4FBDC1A9BBFA7EBDD78A5E8AFEAAF87A96C301407566F6E73B

{
   "txId":"771CE6D2B1BCEB4FBDC1A9BBFA7EBDD78A5E8AFEAAF87A96C301407566F6E73B",
   "blockNumber":29998,
   "blockHash":"000000115757C1BA2C357E9E1015F69A613765B88B40AC62",
   "timestamp":1525201752,
   "signatureState":"Signed",
   "type":"Standard",
   "sourceAddress":"V7aFSJpHHpbfsVTQPuYbDeL97A5aik",
   "sourceAmount":"3500000000",
   "outputs":[
      {
         "address":"VDd3rkzM4GLEvdYuHftQNx3dSDS22s",
         "amount":"3499999999"
      }
   ],
   "transactionFee":"1",
   "data":"",
   "bitcoinTransaction":"",
   "endorsedBlockHeader":"",
   "merklePath":"",
   "size":61
}


Stats

stats/banner

Contains the banner message. If type=warning or critical, then something is not ideal.

https://testnet.explore.veriblock.org/api/stats/banner

{
  "type": "warning",
  "icon": "icon-exclamation",
  "title": "BlockExplorer cache is behind",
  "subtitle": "New blocks and transactions may not show up, balances may not reflect more recent transactions"
}


stats/network

https://testnet.explore.veriblock.org/api/stats/network

{  
   "lastBlock":{  
      "hash":"00000004D1C58D4CA8B97C7A02F7D0C76ED685AFED0969E0",
      "height":30015,
      "time":1525202800
   },
   "lastBtcBlock":{  
      "hash":"",
      "height":-1,
      "time":-1
   },
   "hashRate":3756787,
   "difficulty":"68038033",
   "blockTimes":[  
      42,
      40,
      29,
      66,
      47,
      57,
      15,
      185,
      116,
      75,
      28,
      33,
      94,
      10,
      118,
      65,
      22,
      54,
      4,
      32
   ],
   "blockPopTxs":[  

   ],
   "totalPopTxs":0,
   "totalPopTxPerBlock":0,
   "txSec":0.014654348518636508,
   "blocksizeAvg":"57.3 B",
   "feeByte":"0.02",
   "popBlock":0,
   "bitcoinUse":0,
   "payoutPop":"0 V$"
}