Data Center API

The data center provides external price and on-chain data query interfaces, and provides underlying data support for Nebulas ecosystem applications such as browsers and wallets.

Node

Mainnet Node:

API	URL	Protocol
RESTful	https://data.nebulas.io	HTTP

API List

NRC20 transaction list
Transaction Details
Transaction List
Off-chain (Pending) Transaction List
Query the Transaction List by Addresses
History Transaction Statistics
Current Transaction Statistics
Block List
Block Details
Highest Block
Contract List
Token List
Token Details
Token Transaction List
Token Holders List
NAS Holders List
NAX Distribution History
NAX Statistics
NAX Address Distribution History
Address Information
Address Statistics
Public Chain Statistics Information

API Details

NRC20 Transaction List

Query by address to obtain the NRC20 transaction list [paged].

Protocol	Method	API
HTTP	GET	tx/nrc20

Parameters

address address

page page number; optional parameter, default 1

page_size page size; optional parameter, default 20

Return

txnList transaction list

totalPage total page number

maxDisplayCnt maximum number of displays

currentPage current page number

txnCnt total

Example

//Request
curl -X GET https://data.nebulas.io/tx/nrc20?address="n1zJjyWVKr8HiL1b6dN7JGBtCZFuKQHenLG"&page=1&page_size=2

//Result
{"code":0,"msg":"success","data":{"txnList":[{"hash":"eb3c8d848679ad1786d5986da48bcc5d5732141fd6fccde0a9a3bfd78ae1d970","block":{"hash":"e188cb8f384f010cc5cfd84ed6779a96f74f7cb363383024b26502c0e85e767d","height":4841297},"from":{"hash":"n1QUMEs7qkvCDuimT2zYsbf62z9pRtofQiP"},"to":{"hash":"n1zJjyWVKr8HiL1b6dN7JGBtCZFuKQHenLG"},"status":1,"value":"346000000000000000000","nonce":27,"timestamp":1595146350000,"currentTimestamp":1595149022681,"timeDiff":2672681,"type":"call","gasPrice":"20000000000","gasLimit":"830000","gasUsed":"63615","data":"{\"Function\":\"transfer\",\"Args\":\"[\\\"n1zJjyWVKr8HiL1b6dN7JGBtCZFuKQHenLG\\\",\\\"346000000000000000000\\\"]\"}","contractAddress":"","executeError":"","tokenName":"MRH2","decimal":18,"txFee":"1272300000000000"},{"hash":"fc148958467c69d9ad1c0a5038a41b096d3c2302a604e0edecb52c7a6e9e1675","block":{"hash":"f7b9ed2a907c39a75789246ce071213d0903027ee014cece16063b397bde8e1e","height":4841292},"from":{"hash":"n1N9dDUn3AcdrjLhfCSzNxBGzfxHYTgKH1W"},"to":{"hash":"n1zJjyWVKr8HiL1b6dN7JGBtCZFuKQHenLG"},"status":1,"value":"323000000000000000000","nonce":41,"timestamp":1595146275000,"currentTimestamp":1595149022681,"timeDiff":2747681,"type":"call","gasPrice":"20000000000","gasLimit":"830000","gasUsed":"63615","data":"{\"Function\":\"transfer\",\"Args\":\"[\\\"n1zJjyWVKr8HiL1b6dN7JGBtCZFuKQHenLG\\\",\\\"323000000000000000000\\\"]\"}","contractAddress":"","executeError":"","tokenName":"MRH2","decimal":18,"txFee":"1272300000000000"}],"totalPage":243,"maxDisplayCnt":500,"currentPage":1,"txnCnt":485}}

Transaction Details

Query transaction details by address.

Protocol	Method	API
HTTP	GET	tx/detail

Parameters

hash transaction hash

Return

tx_hash transaction hash

address_main transaction origination address

address_supporting transaction acceptance address

direction transaction acceptance address

tx_type transaction type

timestamp timestamp

block_timestamp transaction timestamp

contract_address contract address

tx_value transaction amount

real_value amount

gas_price transaction fee price

gas_limit transaction fee limit

gas_used transaction usage

statue transaction status: 0 failed, 1 successful, 2 pending

block_height transaction block height

is_nrc20 if it's a NRC20 transaction

Example

//Request
curl -X GET https://data.nebulas.io/tx/detail?hash="eb3c8d848679ad1786d5986da48bcc5d5732141fd6fccde0a9a3bfd78ae1d970"

//Result
{"code":0,"msg":"success","data":{"ext_info":{"data":"eyJGdW5jdGlvbiI6InRyYW5zZmVyIiwiQXJncyI6IltcIm4xekpqeVdWS3I4SGlMMWI2ZE43SkdCdENaRnVLUUhlbkxHXCIsXCIzNDYwMDAwMDAwMDAwMDAwMDAwMDBcIl0ifQ==","execute_error":"","execute_result":"\"\""},"tx_hash":"eb3c8d848679ad1786d5986da48bcc5d5732141fd6fccde0a9a3bfd78ae1d970","address_main":"n1QUMEs7qkvCDuimT2zYsbf62z9pRtofQiP","address_supporting":"n1zJjyWVKr8HiL1b6dN7JGBtCZFuKQHenLG","direction":"send","tx_type":"call","timestamp":1595146335,"block_timestamp":1595146350,"contract_address":"n1pxpisjJMsnVLrqHBnS52o8wsuMUsycfDV","tx_value":"0","real_value":"346000000000000000000","gas_price":"20000000000","gas_limit":830000,"gas_used":63615,"status":1,"block_height":4841297,"is_nrc20":true}}

Transaction List

Query the transaction list.

Protocol	Method	API
HTTP	GET	tx/list

Parameters

block_height block height, optional parameter

page page number; optional parameter, default 1

page_size page size; optional parameter, default 20

Return

next next page request URL

count transactiontotal

total_page total number of pages

current_page current page number

list transaction list

server_timestamp Timestamp

Example

//Request
curl -X GET https://data.nebulas.io/tx/list?page=1&page_size=2


//Result
{"code":0,"msg":"success","data":{"next":"http://data.nebulas.io/tx/list?page=2&page_size=2","previous":null,"count":13352569,"total_page":6676285,"current_page":1,"list":[{"tx_hash":"b3805aaf308fea5fc975e5b87632dbd27c7795c3b2bcc03b69263f8301bfcc6a","chainId":1,"address_from":"n1Tx1bxFsgyTcjQ82h59kMQ3XbZGXSiq8w2","address_to":"n1KxWR8ycXg7Kb9CPTtNjTTEpvka269PniB","value":"586003179640000000000","nonce":7181,"timestamp":1595152078,"block_timestamp":1595157150,"block_date":"20200719","tx_type":"binary","gas_price":"20000000000","gas_limit":200000,"gas_used":20000,"contract_address":"","status":1,"execute_error":"","execute_result":"","block_height":4842017},{"tx_hash":"a920a35b4450d1cb7395b96a6b4f3ae3a616a6f0a129f6586efb6f6b2f71c13f","chainId":1,"address_from":"n1EoNsJNXG1tN3z9rvjwPKoBXbJMqAjmESC","address_to":"n1gtEoDBNnPrAHzRY9tSnpSSg3QppLYXUdR","value":"0","nonce":4915,"timestamp":2147483647,"block_timestamp":1595157075,"block_date":"20200719","tx_type":"call","gas_price":"20000000000","gas_limit":9000000,"gas_used":989604,"contract_address":"","status":1,"execute_error":"","execute_result":"{\"hasNext\":false,\"period\":298,\"start\":4836000,\"end\":4842000,\"page\":4}","block_height":4842012}],"server_timestamp":1595157487445}}

Off-chain (Pending) Transaction List

Quary the off-chain transaction list.

Protocol	Method	API
HTTP	GET	tx/list/pending

Parameters

page page number; optional parameter, default 1

page_size page size; optional parameter, default 20

Return

next next page requestURL

count transactiontotal

total_page total number of pages

current_page current page number

list transaction list

server_timestamp Timestamp

Example

//Request
curl -X GET https://data.nebulas.io/tx/list/pending?page=1&page_size=2


//Result
{"code":0,"msg":"success","data":{"next":"http://data.nebulas.io/tx/list/pending?page=2&page_size=2","previous":null,"count":156,"total_page":78,"current_page":1,"list":[{"tx_hash":"4138b43575e419a534a878be45dd8e43f4ddb61ac122ed82a8d5050fde156f7b","chainId":1,"address_from":"n1Gfg8uqtFsvGKZn6XtVmEb116ZtagRHDoe","address_to":"n22CMMXaxkAjjbsWtVXSmFJgEsnVZ3UwUWf","value":"0","nonce":2818,"timestamp":1595154990,"block_timestamp":null,"block_date":null,"tx_type":"pod","gas_price":"1000000000000","gas_limit":50000000000,"gas_used":null,"contract_address":null,"status":2,"execute_error":"","execute_result":"","block_height":null},{"tx_hash":"9a6a2fa7c02c18a0f61c96cf4b545da6e41bf5e64a8641062e66c81134b924f8","chainId":1,"address_from":"n1bc9szRj57bD4HqM5672v92gnBvPayacJE","address_to":"n22CMMXaxkAjjbsWtVXSmFJgEsnVZ3UwUWf","value":"0","nonce":2894,"timestamp":1595154990,"block_timestamp":null,"block_date":null,"tx_type":"pod","gas_price":"1000000000000","gas_limit":50000000000,"gas_used":null,"contract_address":null,"status":2,"execute_error":"","execute_result":"","block_height":null}],"server_timestamp":1595157812578}}

Query the Transaction List by Addresses

Query the transaction list by addresses

Protocol	Method	API
HTTP	GET	tx/listByAddress

Parameters

address address

is_nrc20 If it's a NRC20 transaction

page page number; optional parameter, default 1

page_size page size; optional parameter, default 20

Return

next next page requestURL

count transactiontotal

total_page total number of pages

current_page current page number

list transaction list

server_timestamp Timestamp

Example

//Request
curl -X GET https://data.nebulas.io/tx/listByAddress?address=n1Gfg8uqtFsvGKZn6XtVmEb116ZtagRHDoe&page=1&page_size=2


//Result
{"code":0,"msg":"success","data":{"next":"http://data.nebulas.io/tx/listByAddress?address=n1Gfg8uqtFsvGKZn6XtVmEb116ZtagRHDoe&page=2&page_size=2","previous":null,"count":2829,"total_page":1415,"current_page":1,"list":[{"tx_hash":"9e862c72614aba4138e8e1fcbf44ef0a8f2007520015e899bf75da3d9136049b","chainId":1,"address_from":"n1Gfg8uqtFsvGKZn6XtVmEb116ZtagRHDoe","address_to":"n22CMMXaxkAjjbsWtVXSmFJgEsnVZ3UwUWf","value":"0","nonce":2818,"timestamp":1595154930,"block_timestamp":1595154990,"block_date":"20200719","tx_type":"pod","gas_price":"1000000000000","gas_limit":50000000000,"gas_used":150885,"contract_address":"","status":1,"execute_error":"","execute_result":"\"\"","block_height":4841873},{"tx_hash":"4138b43575e419a534a878be45dd8e43f4ddb61ac122ed82a8d5050fde156f7b","chainId":1,"address_from":"n1Gfg8uqtFsvGKZn6XtVmEb116ZtagRHDoe","address_to":"n22CMMXaxkAjjbsWtVXSmFJgEsnVZ3UwUWf","value":"0","nonce":2818,"timestamp":1595154990,"block_timestamp":null,"block_date":null,"tx_type":"pod","gas_price":"1000000000000","gas_limit":50000000000,"gas_used":null,"contract_address":null,"status":2,"execute_error":"","execute_result":"","block_height":null}],"server_timestamp":1595158063474}}

History Transaction Statistics

History transaction statistics

Protocol	Method	API
HTTP	GET	tx/count/history

Parameters

days statistical days, optional parameter, default is 15

Return

price NAS price

date date

transaction_count transaction amount

Example

//Request
curl -X GET https://data.nebulas.io/tx/count/history?days=2

//Result
{"code":0,"msg":"success","data":[{"price":0.4775322101523956,"date":"20200718","transaction_count":2354},{"price":0,"date":"20200717","transaction_count":2231}]}

Current Transaction Statics

Current (24 hours) transaction statics

Protocol	Method	API
HTTP	GET	tx/count/today

Parameters

None

Return

count transaction数

Example

//Request
curl -X GET https://data.nebulas.io/tx/count/today

//Result
{"code":0,"msg":"success","data":{"count":1074}}

Block List

Block list.

Protocol	Method	API
HTTP	GET	block/list

Parameters

page page number; optional parameter, default 1

page_size page size; optional parameter, default 20

Return

next next page requestURL

count transactiontotal

total_page total number of pages

current_page current page number

list block list

Example

//Request
curl -X GET https://data.nebulas.io/block/list?page=1&page_size=2

//Result
{"code":0,"msg":"success","data":{"next":"http://data.nebulas.io/block/list?page=2&page_size=2","previous":null,"count":4842132,"total_page":2421066,"current_page":1,"list":[{"block_hash":"c7e7862a725acb12c599cb1bbf5dd2e9781a4edffb4d850d2ad70776f0517dcc","parent_hash":"87f27c9e71d6797eb80fcb4f4ee39d87c7ea153f7124b9679851fb672e6631eb","height":4842132,"tx_count":1,"nonce":0,"coinbase":"n1HEitaphPaJG1iJHVU5AVtC7GvhHmKf1YV","timestamp":1595158875,"chain_id":1,"state_root":"5f173a48643475b17564114b761112e2c091f12916606a91f3a9d3dff9037532","txs_root":"70204ae37a62a318de69fe33505edb10a3983bc417394c97186c56d831c9a3ff","events_root":"442586640329dc93208dae2177d924bf0dc58663b12ec85caa7ef87c87012beb","miner":"n1RKTn2SXD67TvBaf55eHcFHa1AKzJcmrh2","randomSeed":"ac841e144b2cc1725bcd26f0dca14697ceca2e41c2021fd4a481a7c05fdb6890","randomProof":"e4e895173487a7e69fe917a7e987dc646736f5503f0f4432505ddf1755f3e3478c9f8a395cda5b273c5db8b5554c2b0c0079283d4b51c12ce925b4ae1d0a3cc1045a45d40d9e575f4f8acb20f276fec1023cc0989feabab87d76a7d52814dbced2bb5712630c0c43e4cacdba54bd3f6bd0414a15346b82ba59636c49f0cfece864","is_finality":false},{"block_hash":"87f27c9e71d6797eb80fcb4f4ee39d87c7ea153f7124b9679851fb672e6631eb","parent_hash":"d7e6b5705addf45c5e33f2953ebb894be22fe6b6f4412abfe5e548aa22c0ad8b","height":4842131,"tx_count":1,"nonce":0,"coinbase":"n1bSo5dMmVejyTnD9fBKsWmufrsTnoMUJVJ","timestamp":1595158860,"chain_id":1,"state_root":"bd9d19401e797fdfcff2cca354d7b7f1db0b4aad08407242dab9facdb1334aef","txs_root":"e120e7f50f08a2a1773e1782668c3d9f4312c5fffb1317f22fd6ec37b9a47161","events_root":"494985b7def3ac8c18f96ecf0464e966fe5a11f948be435a48870a5e0eb1d867","miner":"n1QyuEwxQED86Wq1ADMCTFjCay4BUnJDBGX","randomSeed":"a8866802b63d386edfc1ee009fa2d8e73163192382e27857cd087aa2afa59c46","randomProof":"2a2f3d701f0aa89695a7a69f9d48c7fc136cb8cf6cde2ab51187f8da8f72f90457ed8cc8530b040cdb4d79736f46dfdb4ce1a3a5e8fcbfe1df74c42e0b8d23b30474230844ec470f97014f8d0064fb5b077cab04afaeba5cb5fed42b3401fbe77abd395ac8489f128cf46bd96ffdc58e9f760effc6baadba0239bb7f0bebc9458c","is_finality":false}]}}

Block Details

Query the block details

Protocol	Method	API
HTTP	GET	block/detail

Parameters

h block hash or height

Return

gas_info gas infomation

dynasty miner address list

node miner node information

block_hash block hash

parent_hash parent block hash

height block height

tx_count transaction amount

nonce nonce

coinbase coinbase address

timestamp Timestamp

chain_id Chain ID

miner miner address

is_finality If it's finality

Example

//Request
curl -X GET https://data.nebulas.io/block/detail?h=4820298

//Result
{"code":0,"msg":"success","data":{"gas_info":{"gas_limit":"0","gas_reward":"0","avg_gas_price":"0"},"dynasty":["n1FfapZbhjFb2Lt9vxuSW7odjEPh8DeYsFG","n1FoHjHE3rMGsYEEPgadvrHeuiVmvkL44p3","n1HpAFoBMnhMRSJ4jXECWbhAVbx1fzh1Pcj","n1Jkdiq1H1HSXYJXtvDDkYm84Tmapo4hhMv","n1NSK8TiFQRGXzxcc5jmTCuCLbnCejUcw8s","n1Qm4ZaRf7HnQNVhg13BxjprVW42vAi8dYY","n1QyuEwxQED86Wq1ADMCTFjCay4BUnJDBGX","n1S7CvsNWbPtaxH8pMqSby8hW6EkHExM59C","n1Sg1yFp4fGFLtvmxHXBrcATSBWwNJfUyBc","n1SqTLCGr56ZpT58Gj3wLfKVmQ8GXvr9ZYG","n1TURfNzQzT3aG4WDDebhrC1VJ6VbXvh2ZC","n1VwmLzc8VGbLa6o49WVA4fctJszVo3JPgQ","n1YRxpRaKikNPJRUScnWaqM9zKEPbsbGsgD","n1ZciM6PYAkEjsXUfHCwYwW9gNWqU9AnXax","n1bYLRcBtA5McKxbdqAXWMiDygjGnFpMrH2","n1baJw6b6LhoTz1ARaLBhoESuV5wEMuLmCf","n1bc9szRj57bD4HqM5672v92gnBvPayacJE","n1cbzD8Y1Pgw94eojoKd7nGQdA1JtML4daT","n1d2RCScDDxVA7PgJNT1N1kuue7raT9KMtG","n1dHKZTnMA2hmocLD35UfqG6kwDQ3Uq92nS","n1dXgssVuGTGPCnfG3eh2huEpmP542GybSd"],"node":{"period":23001,"info":{"avatar":"vko6lukmtl.png","email":"support@keysinteractive.com","id":"keys01","income-distribute":"We will distribute 80% of the block rewards back to our voters.\n\nPayout frequency is weekly (every 168 polling cycle).","name":"Keys | Share 80%","server":"Memory: 32GB of RAM\nStorage: 1TB SSD\nCPU: 64-bit\nProcessor: 8 cores (3.2 GHz each)\nNetwork: 1 Gbps","summary":"We provide staking/validation services for Proof of Stake networks for more than a year. \n\nOur primary goal is to ensure stable and secure block production by maintaining high-performance hardware and the optimal infrastructure.","telegram":null,"twitter":"keys_tech","website":null,"wechat":null}},"block_hash":"88131b5416e2b564fe478317bf842110f10f27ab654f03a33a6be2b222149afc","parent_hash":"b33862a67bfc69ec2ee790748d32104b7ac863a2e891659e3e8bf0e90b3700b3","height":4820298,"tx_count":0,"nonce":0,"coinbase":"n1VNg5f4E3KW9sjif2BeQ8dshdK9wgKwwQv","timestamp":1594831260,"chain_id":1,"miner":"n1Sg1yFp4fGFLtvmxHXBrcATSBWwNJfUyBc","is_finality":true,"server_timestamp":1595163814094}}

Highest Block

Query the highest block.

Protocol	Method	API
HTTP	GET	block/max

Parameters

None

Return

height height

server_timestamp Timestamp

Example

//Request
curl -X GET https://data.nebulas.io/block/max

//Result
{"code":0,"msg":"success","data":{"height":4842503.0,"server_timestamp":1595164447597}}

Contract List

Query the contract list.

Protocol	Method	API
HTTP	GET	contracts

Parameters

page page number; optional parameter, default 1

page_size page size; optional parameter, default 20

Return

next next page requestURL

count total

total_page total number of pages

current_page current page number

list contract list

Example

//Request
curl -X GET https://data.nebulas.io/contracts?page=1&page_size=2

//Result
{"code":0,"msg":"success","data":{"next":"http://data.nebulas.io/contracts?page=2&page_size=2","previous":null,"count":15423,"total_page":7712,"current_page":1,"list":[{"block_timestamp":1593176850000,"type":"NORMAL","address":"n1orbrZ5r7wa6C4dBmCo46ZkPtMiMaS5GcP","creator_address":"n1SD9Bp3pEDy1g8acG7qmVJu5DPWreLeqsm","deploy_tx_hash":"bff2e9c73c1c3a85ac5911614fef1892f9f35cbd253aa6eef79e905ebca2b150","block_height":4710023},{"block_timestamp":1591266855000,"type":"NORMAL","address":"n1nvqH9aE57USRPfGm33sTRPac9kRjsXiKu","creator_address":"n1QaTZhe1TABmigiGsutCJR2kdrhHNXqNeZ","deploy_tx_hash":"ce06c9e6a5b5bd0ca985df3b837f39a6bd475e45247b392629badeb9b64d3450","block_height":4582759}]}}

token list

QUery the token list.

Protocol	Method	API
HTTP	GET	token/list

Parameters

None

Return list

token_name token name

description token description

contract contractaddress

total total

token_decimals token decimals

Example

//Request
curl -X GET https://data.nebulas.io/token/list

//Result
{"code":0,"msg":"success","data":[{"token_name":"ATP","description":"ATP-DESC","contract":"n1zUNqeBPvsyrw5zxp9mKcDdLTjuaEL7s39","total":"10000000000000000000000000000","token_decimals":18},{"token_name":"WITI","description":"WITI-DESC","contract":"n1hiWG7Ce8HhTaJGzSJoAaJ9w1CJd7Do2rm","total":"200000000000000000","token_decimals":8},{"token_name":"NAT","description":"NAT","contract":"n1mpgNi6KKdSzr7i5Ma7JsG5yPY9knf9He7","total":"100000000000000000000000000000","token_decimals":18},{"token_name":"WICM","description":"WITTICISM TOKEN","contract":"n1jJHWrXMysNm7odsUed3RGddiEH1jbJXtt","total":"200000000000000000000000000","token_decimals":18},{"token_name":"NAX","description":"NAX","contract":"n1etmdwczuAUCnMMvpGasfi8kwUbb2ddvRJ","total":"10000000000000000000","token_decimals":9},{"token_name":"MRH2","description":"MRH2","contract":"n1pxpisjJMsnVLrqHBnS52o8wsuMUsycfDV","total":"1000000000000000000000000000","token_decimals":18}]}

Token Details

Query the token details

Protocol	Method	API
HTTP	GET	token/detail

Parameters

token token name

contract select one between contract address and token

Return

token_name token name

description token description

contract contract address

total total

token_decimals token decimals

Example

//Request
curl -X GET https://data.nebulas.io/token/detail?token=NAX

//Result
{"code":0,"msg":"success","data":{"token_name":"NAX","description":"NAX","contract":"n1etmdwczuAUCnMMvpGasfi8kwUbb2ddvRJ","total":"10000000000000000000","token_decimals":9}}

Token Transaction List

Query token dettails

Protocol	Method	API
HTTP	GET	token/tx/list

Parameters

token token name

contract select one between the contract address and token

page page number; optional parameter, default 1

page_size page size; optional parameter, default 20

Return

next next page request URL

count total

total_page total number of pages

current_page current page number

list transaction list

token token information

Example

//Request
curl -X GET https://data.nebulas.io/token/tx/list?token=NAX&page=1&page_size=2

//Result
{"code":0,"msg":"success","data":{"next":"http://data.nebulas.io/token/tx/list?page=2&page_size=2&token=NAX","previous":null,"count":8318,"total_page":4159,"current_page":1,"list":[{"token":{"token_name":"NAX","description":"NAX","contract":"n1etmdwczuAUCnMMvpGasfi8kwUbb2ddvRJ","total":"10000000000000000000","token_decimals":9},"tx_hash":"63d2395551bc1ad95138d2efeee941573a6eb7154c8db532988f64663e1ea2b3","address_main":"n1dTbtBu98qsxLNmmZKRWmh5qMS6L2pSzKy","address_supporting":"n1aM6Bag362YnAVtjLkRWzFVjQdrZpsNmwk","direction":"send","tx_type":"call","timestamp":1595164824,"block_timestamp":1595164845,"contract_address":"n1etmdwczuAUCnMMvpGasfi8kwUbb2ddvRJ","tx_value":"0","real_value":"2486000000000","gas_price":"20000000000","gas_limit":810000,"gas_used":21105,"status":1,"block_height":4842530,"is_nrc20":true},{"token":{"token_name":"NAX","description":"NAX","contract":"n1etmdwczuAUCnMMvpGasfi8kwUbb2ddvRJ","total":"10000000000000000000","token_decimals":9},"tx_hash":"7063f2234170f43747149711bf119a03cdd8b51405212114c7c4ae9021295100","address_main":"n1dTbtBu98qsxLNmmZKRWmh5qMS6L2pSzKy","address_supporting":"n1aM6Bag362YnAVtjLkRWzFVjQdrZpsNmwk","direction":"send","tx_type":"call","timestamp":1595164477,"block_timestamp":1595164500,"contract_address":"n1etmdwczuAUCnMMvpGasfi8kwUbb2ddvRJ","tx_value":"0","real_value":"3707000000000","gas_price":"20000000000","gas_limit":810000,"gas_used":20673,"status":0,"block_height":4842507,"is_nrc20":true}],"server_timestamp":1595165282662,"token":{"token_name":"NAX","description":"NAX","contract":"n1etmdwczuAUCnMMvpGasfi8kwUbb2ddvRJ","total":"10000000000000000000","token_decimals":9}}}

Token Holders List

Query token holders list.

Protocol	Method	API
HTTP	GET	token/holders

Parameters

token token name

contract contract address，and token (select one)

page page number; optional parameter, default 1

page_size page size; optional parameter, default 20

Return

next next page requestURL

count total

total_page total number of pages

current_page current page number

list address list

Example

//Request
curl -X GET https://data.nebulas.io/token/holders?token=NAX&page=1&page_size=2

//Result
{"code":0,"msg":"success","data":{"next":"http://data.nebulas.io/token/holders?page=2&page_size=2&token=NAX","previous":null,"count":1399,"total_page":700,"current_page":1,"list":[{"address":"n1QbEBKhsGxJUahRQXqV88T9oi4d9ywK453","contract":"n1etmdwczuAUCnMMvpGasfi8kwUbb2ddvRJ","balance":"390084128964550818"},{"address":"n214bLrE3nREcpRewHXF7qRDWCcaxRSiUdw","contract":"n1etmdwczuAUCnMMvpGasfi8kwUbb2ddvRJ","balance":"100395915000000000"}]}}

NAS Holders List

Query NAS holders list。

Protocol	Method	API
HTTP	GET	holders

Parameters

page page number; optional parameter, default 1

page_size page size; optional parameter, default 20

Return

next next page requestURL

count total

total_page total number of pages

current_page current page number

list address list

Example

//Request
curl -X GET https://data.nebulas.io/holders?page=1&page_size=2

//Result
{"code":0,"msg":"success","data":{"next":"http://data.nebulas.io/holders?page=2&page_size=2","previous":null,"count":339598,"total_page":400,"current_page":1,"list":[{"tx_count":12,"percentage":59.493851,"address":"n1gczhpkT54RaT4PB55CNoYbqmEQcfo4hqq","nonce":0,"type":88,"balance":"35901357730000000000000000","date_of_found":"20191009","rank":1.0},{"tx_count":88344,"percentage":20.707855,"address":"n1KxWR8ycXg7Kb9CPTtNjTTEpvka269PniB","nonce":49290,"type":87,"balance":"12496083258556280663196250","date_of_found":"20180424","rank":2.0}]}}

NAX Distribution History

Query NAX distribution history.

Protocol	Method	API
HTTP	GET	nax/history

Parameters

page page number; optional parameter, default 1

page_size page size; optional parameter, default 20

Return

next next page requestURL

count total

total_page total number of pages

current_page current page number

list history list

Example

//Request
curl -X GET https://data.nebulas.io/nax/history?page=1&page_size=2

//Result
{"code":0,"msg":"success","data":{"next":"http://data.nebulas.io/nax/history?page=2&page_size=2","previous":null,"count":299,"total_page":150,"current_page":1,"list":[{"nas_price":0.4775322101523956,"nax_price":0.002492307692307692,"start_timestamp":"2020-07-18T10:08:00","end_timestamp":"2020-07-19T11:08:15","total_distributed_nax":"1233673083506519749","total_destroyed_nax":"1351842110126118095","total_vote_nax":"514052192214285714.2857","avg_reward_rate":0.950916,"created_at":"2020-07-18T10:12:16","stage":298,"start":4836000,"end":4842000,"estimate_nax":"7421906713080442","distributed_nax":"3425198001737814","destroyed_nax":"3996708711342628","total_supplied_nax":"1233673083506411630","pledged_nas":"27848503662499186630500000","total_supplied_nas":"60343663688079320000000000","status":1},{"nas_price":0.4541347259763038,"nax_price":0.002418367088607595,"start_timestamp":"2020-07-17T09:07:00","end_timestamp":"2020-07-18T10:08:00","total_distributed_nax":"1230247885504781935","total_destroyed_nax":"1347845401414775467","total_vote_nax":"513406552357142857.1429","avg_reward_rate":0.932828,"created_at":"2020-07-17T09:12:05","stage":297,"start":4830000,"end":4836000,"estimate_nax":"7429336049129572","distributed_nax":"3429332827592696","destroyed_nax":"4000003221536876","total_supplied_nax":"1230247885504674237","pledged_nas":"27850287662499186630500000","total_supplied_nas":"58103599263060000000000000","status":1}]}}

NAX Statistics

Query NAX statistics.

Protocol	Method	API
HTTP	GET	nax/summary

Parameters

None

Return

last_distributed_nax last distributed NAX

total_distributed_nax total distributed NAX

current_pledged_nas current dstaking nas

current_total_nas current total NAS

list distribution history list

Example

//Request
curl -X GET https://data.nebulas.io/nax/summary

//Result
{"code":0,"msg":"success","data":{"last_distributed_nax":"3425198001737814","total_distributed_nax":"1233673083506519749","current_pledged_nas":"27856286662499186630500000","current_total_nas":"71910268469860000000000000","estimate_nax":"7414484806367362","end_height":4848000,"list":[{"nas_price":0.4775322101523956,"nax_price":0.002492307692307692,"start_timestamp":"2020-07-18T10:08:00","end_timestamp":"2020-07-19T11:08:15","total_distributed_nax":"1233673083506519749","total_destroyed_nax":"1351842110126118095","total_vote_nax":"514052192214285714.2857","avg_reward_rate":0.950916,"created_at":"2020-07-18T10:12:16","stage":298,"start":4836000,"end":4842000,"estimate_nax":"7421906713080442","distributed_nax":"3425198001737814","destroyed_nax":"3996708711342628","total_supplied_nax":"1233673083506411630","pledged_nas":"27848503662499186630500000","total_supplied_nas":"60343663688079320000000000","status":1},{"nas_price":0.4541347259763038,"nax_price":0.002418367088607595,"start_timestamp":"2020-07-17T09:07:00","end_timestamp":"2020-07-18T10:08:00","total_distributed_nax":"1230247885504781935","total_destroyed_nax":"1347845401414775467","total_vote_nax":"513406552357142857.1429","avg_reward_rate":0.932828,"created_at":"2020-07-17T09:12:05","stage":297,"start":4830000,"end":4836000,"estimate_nax":"7429336049129572","distributed_nax":"3429332827592696","destroyed_nax":"4000003221536876","total_supplied_nax":"1230247885504674237","pledged_nas":"27850287662499186630500000","total_supplied_nas":"58103599263060000000000000","status":1},{"nas_price":0.46206315262654346,"nax_price":0.0023882391304347827,"start_timestamp":"2020-07-16T08:06:30","end_timestamp":"2020-07-17T09:07:00","total_distributed_nax":"1226818552677189239","total_destroyed_nax":"1343845398193238591","total_vote_nax":"511429083862068965.5172","avg_reward_rate":0.999776,"created_at":"2020-07-16T08:09:31","stage":296,"start":4824000,"end":4830000,"estimate_nax":"7436772821951523","distributed_nax":"3435182528484704","destroyed_nax":"4001590293466819","total_supplied_nax":"1226818552677081958","pledged_nas":"27865941662499186630500000","total_supplied_nas":"60326540408079320000000000","status":1},{"nas_price":0.49049006922562666,"nax_price":0.0026480666666666665,"start_timestamp":"2020-07-15T07:06:30","end_timestamp":"2020-07-16T08:06:30","total_distributed_nax":"1223383370148704535","total_destroyed_nax":"1339843807899771772","total_vote_nax":"507907569000000000.0000","avg_reward_rate":0.930706,"created_at":"2020-07-15T07:10:30","stage":295,"start":4818000,"end":4824000,"estimate_nax":"7444217038990514","distributed_nax":"3475204652507346","destroyed_nax":"3969012386483168","total_supplied_nax":"1223383370148597666","pledged_nas":"28158410662499186630500000","total_supplied_nas":"58080768183060000000000000","status":1},{"nas_price":0.4789442682472688,"nax_price":0.002679741935483871,"start_timestamp":"2020-07-14T06:06:30","end_timestamp":"2020-07-15T07:06:30","total_distributed_nax":"1219908165496197189","total_destroyed_nax":"1335874795513288604","total_vote_nax":"505217907310344827.5862","avg_reward_rate":0.935081,"created_at":"2020-07-14T06:10:31","stage":294,"start":4812000,"end":4818000,"estimate_nax":"7451668707698212","distributed_nax":"3470160088219490","destroyed_nax":"3981508619478722","total_supplied_nax":"1219908165496090731","pledged_nas":"28085431662499186630500000","total_supplied_nas":"60309417128079320000000000","status":1},{"nas_price":0.48084590963152873,"nax_price":0.002551816091954023,"start_timestamp":"2020-07-13T05:06:30","end_timestamp":"2020-07-14T06:06:30","total_distributed_nax":"1216438005407977699","total_destroyed_nax":"1331893286893809882","total_vote_nax":"498465746892857142.8571","avg_reward_rate":0.964755,"created_at":"2020-07-13T05:11:31","stage":293,"start":4806000,"end":4812000,"estimate_nax":"7459127835533746","distributed_nax":"3485080668820116","destroyed_nax":"3974047166713630","total_supplied_nax":"1216438005407871672","pledged_nas":"28173983662499186630500000","total_supplied_nas":"60300855488079320000000000","status":1},{"nas_price":0.48637544312914666,"nax_price":0.00253512,"start_timestamp":"2020-07-12T04:04:15","end_timestamp":"2020-07-13T05:06:30","total_distributed_nax":"1212952924739157583","total_destroyed_nax":"1327919239727096252","total_vote_nax":"493814339137931034.4828","avg_reward_rate":1.025423,"created_at":"2020-07-12T04:08:16","stage":292,"start":4800000,"end":4806000,"estimate_nax":"7466594429963709","distributed_nax":"3477434441786175","destroyed_nax":"3989159988177534","total_supplied_nax":"1212952924739051971","pledged_nas":"28080070662499186630500000","total_supplied_nas":"60292293848079320000000000","status":1},{"nas_price":0.4700681555242065,"nax_price":0.002359413043478261,"start_timestamp":"2020-07-11T03:04:15","end_timestamp":"2020-07-12T04:04:15","total_distributed_nax":"1209475490297371408","total_destroyed_nax":"1323930079738918718","total_vote_nax":"490152026857142857.1429","avg_reward_rate":1.037342,"created_at":"2020-07-11T03:09:15","stage":291,"start":4794000,"end":4800000,"estimate_nax":"7474068498462171","distributed_nax":"3487928053271783","destroyed_nax":"3986140445190388","total_supplied_nax":"1209475490297266225","pledged_nas":"28132645662499186630500000","total_supplied_nas":"60283732208079320000000000","status":1},{"nas_price":0.4345778883513563,"nax_price":0.0022704367816091956,"start_timestamp":"2020-07-10T02:04:15","end_timestamp":"2020-07-11T03:04:15","total_distributed_nax":"1205987562244099625","total_destroyed_nax":"1319943939293728330","total_vote_nax":"487198695321428571.4286","avg_reward_rate":1.011173,"created_at":"2020-07-10T02:09:16","stage":290,"start":4788000,"end":4794000,"estimate_nax":"7481550048510682","distributed_nax":"3498863698327820","destroyed_nax":"3982686350182862","total_supplied_nax":"1205987562243994834","pledged_nas":"28188624662499186630500000","total_supplied_nas":"60275170568079320000000000","status":1},{"nas_price":0.42344173104069566,"nax_price":0.0022432717391304346,"start_timestamp":"2020-07-09T01:04:15","end_timestamp":"2020-07-10T02:04:15","total_distributed_nax":"1202488698545771805","total_destroyed_nax":"1315961252943545468","total_vote_nax":"486888939275862068.9655","avg_reward_rate":1.04999,"created_at":"2020-07-09T01:08:16","stage":289,"start":4782000,"end":4788000,"estimate_nax":"7489039087598280","distributed_nax":"3501787111156831","destroyed_nax":"3987251976441449","total_supplied_nax":"1202488698545667432","pledged_nas":"28179961662499186630500000","total_supplied_nas":"60266608928079320000000000","status":1},{"nas_price":0.4371542430544301,"nax_price":0.0022258924731182795,"start_timestamp":"2020-07-08T00:04:00","end_timestamp":"2020-07-09T01:04:15","total_distributed_nax":"1198986911434614974","total_destroyed_nax":"1311974000967104019","total_vote_nax":"484083464107142857.1429","avg_reward_rate":1.054589,"created_at":"2020-07-08T00:09:16","stage":288,"start":4776000,"end":4782000,"estimate_nax":"7496535623221502","distributed_nax":"3504034562399862","destroyed_nax":"3992501060821640","total_supplied_nax":"1198986911434511012","pledged_nas":"28165847662499186630500000","total_supplied_nas":"58000859403060000000000000","status":1},{"nas_price":0.4082020724468925,"nax_price":0.00200694623655914,"start_timestamp":"2020-07-06T23:04:00","end_timestamp":"2020-07-08T00:04:00","total_distributed_nax":"1195482876872215112","total_destroyed_nax":"1307981499906282379","total_vote_nax":"480995342107142857.1429","avg_reward_rate":1.09882,"created_at":"2020-07-06T23:08:05","stage":287,"start":4770000,"end":4776000,"estimate_nax":"7504039662884386","distributed_nax":"3204930295742230","destroyed_nax":"4299109367142156","total_supplied_nax":"1195482876872111553","pledged_nas":"25732193662499186630500000","total_supplied_nas":"60249485648079320000000000","status":1},{"nas_price":0.3761060705104889,"nax_price":0.0019144444444444445,"start_timestamp":"2020-07-05T22:03:15","end_timestamp":"2020-07-06T23:04:00","total_distributed_nax":"1192277946576472882","total_destroyed_nax":"1303682390539140223","total_vote_nax":"480877008448275862.0690","avg_reward_rate":1.102562,"created_at":"2020-07-05T22:08:16","stage":286,"start":4764000,"end":4770000,"estimate_nax":"7511551214098485","distributed_nax":"3327871474520931","destroyed_nax":"4183679739577554","total_supplied_nax":"1192277946576369732","pledged_nas":"26688768656599066630500000","total_supplied_nas":"60240924008079320000000000","status":1},{"nas_price":0.3670408923895109,"nax_price":0.0018900108695652175,"start_timestamp":"2020-07-04T21:02:45","end_timestamp":"2020-07-05T22:03:15","total_distributed_nax":"1188950075101951951","total_destroyed_nax":"1299498710799562669","total_vote_nax":"480231897821428571.4286","avg_reward_rate":1.049588,"created_at":"2020-07-04T21:06:46","stage":285,"start":4758000,"end":4764000,"estimate_nax":"7519070284382868","distributed_nax":"3318646097157277","destroyed_nax":"4200424187225591","total_supplied_nax":"1188950075101849212","pledged_nas":"26584389656599066630500000","total_supplied_nas":"60232362368079320000000000","status":1},{"nas_price":0.3664989544953158,"nax_price":0.001934,"start_timestamp":"2020-07-03T20:02:45","end_timestamp":"2020-07-04T21:02:45","total_distributed_nax":"1185631429004794674","total_destroyed_nax":"1295298286612337078","total_vote_nax":"478950430892857142.8571","avg_reward_rate":1.031921,"created_at":"2020-07-03T20:06:48","stage":284,"start":4752000,"end":4758000,"estimate_nax":"7526596881264132","distributed_nax":"3353989426569032","destroyed_nax":"4172607454695100","total_supplied_nax":"1185631429004692345","pledged_nas":"26836828656599066630500000","total_supplied_nas":"57955197243060000000000000","status":1}]}}

NAX Address Distribution History

Query NAX address distribution history

Protocol	Method	API
HTTP	GET	nax/profits

Parameters

address address

page page number; optional parameter, default 1

page_size page size; optional parameter, default 20

Return

next next page requestURL

count total

total_page total number of pages

current_page current page number

list data list

Example

//Request
curl -X GET https://data.nebulas.io/nax/profits?address=n1d4wXxTVmK4rzyiN1vxhMuzxT441bxr8Fg&page=1&page_size=2

//Result
{"code":0,"msg":"success","data":{"next":"http://data.nebulas.io/nax/profits?address=n1d4wXxTVmK4rzyiN1vxhMuzxT441bxr8Fg&page=2&page_size=2","previous":null,"count":10,"total_page":5,"current_page":1,"list":[{"address":"n1d4wXxTVmK4rzyiN1vxhMuzxT441bxr8Fg","tx_hash":"ed36d5bc52f48c55a92551044b14fd1e35b9e9b3a57226f9e910b8e9709ea9c0","block_timestamp":1593710040,"profit":"-1000000000","stage":-1,"source":1,"block_height":4745566},{"address":"n1d4wXxTVmK4rzyiN1vxhMuzxT441bxr8Fg","tx_hash":"c27185fc66fd346fb53dde96cfa73fec957fc40e2e38c19cf5f051fd42bcc516","block_timestamp":1593710115,"profit":"-1000000000","stage":-1,"source":1,"block_height":4745571}]}}

Address Information

Query address information

Protocol	Method	API
HTTP	GET	address/info

Parameters

address address

Return

address address

nonce transaction nonce

type type: 87 normal address, 88 contract address

balance balance

date_of_found created date

Example

//Request
curl -X GET https://data.nebulas.io/address/info?address=n1d4wXxTVmK4rzyiN1vxhMuzxT441bxr8Fg

//Result
{"code":0,"msg":"success","data":{"contract":{},"address":"n1d4wXxTVmK4rzyiN1vxhMuzxT441bxr8Fg","nonce":124,"type":87,"balance":"22386060161435630252100","date_of_found":"20200130"}}

Address Statistics

Query address statistics

Protocol	Method	API
HTTP	GET	address/count/history

Parameters

days days, optional parameter, default is 30

Return

created_at created date

updated_at updated date

date date

all_address_count address count

contract_count contract count

Example

//Request
curl -X GET https://data.nebulas.io/address/count/history?days=5

//Result
{"code":0,"msg":"success","data":[{"created_at":"2020-07-19T00:00:00","updated_at":"2020-07-19T00:00:00","date":"20200718","all_address_count":339596,"contract_count":15922},{"created_at":"2020-07-18T00:00:00","updated_at":"2020-07-18T00:00:00","date":"20200717","all_address_count":339587,"contract_count":15922},{"created_at":"2020-07-17T00:00:00","updated_at":"2020-07-17T00:00:00","date":"20200716","all_address_count":339581,"contract_count":15922},{"created_at":"2020-07-17T00:00:00","updated_at":"2020-07-17T00:00:00","date":"20200716","all_address_count":339581,"contract_count":15922},{"created_at":"2020-07-16T00:00:00","updated_at":"2020-07-16T00:00:00","date":"20200715","all_address_count":339577,"contract_count":15922}]}

Public Chain Statistics Informations

Query public chain statistics information.

Protocol	Method	API
HTTP	GET	chain/summary

Parameters

None

Return

block_count block count

tx_count transaction count

contract_count contract count

normal_address_count address count

Example

//Request
curl -X GET https://data.nebulas.io/chain/summary

//Result
{"code":0,"msg":"success","data":{"block_count":4842814,"tx_count":13075893,"contract_count":15922,"normal_address_count":323676}}

nebdocs/docs/go-nebulas/data-center/api.md

Data Center API

Node

API List

API Details

NRC20 Transaction List

Parameters

Return

Example

Transaction Details

Parameters

Return

Example

Transaction List

Parameters

Return

Example

Off-chain (Pending) Transaction List

Parameters

Return

Example

Query the Transaction List by Addresses

Parameters

Return

Example

History Transaction Statistics

Parameters

Return

Example

Current Transaction Statics

Parameters

Return

Example

Block List

Parameters

Return

Example

Block Details

Parameters

Return

Example

Highest Block

Parameters

Return

Example

Contract List

Parameters

Return

Example

token list

Parameters

Return list

Example

Token Details

Parameters

Return

Example

Token Transaction List

Parameters

Return

Example

Token Holders List

Parameters

Return

Example

NAS Holders List

Parameters

Return

Example

NAX Distribution History

Parameters

Return

Example

NAX Statistics

Parameters

Return

Example

NAX Address Distribution History

Parameters

Return