WHITEPAPER
Search
K

Siriusscan

API Documentation

This API is provided for developers transitioning their applications from Siriusscan. It supports GET and POST requests.

Account ?module=account

Mimics Siriusnet JSON RPC's mcd_getBalance. Returns the balance as of the provided block (defaults to latest)

?module=account&action=mcd_get_balance&address={addressHash}
mcd_get_balance GET POST
Name
Description
Module *required string (query)
A string with the name of the module to be invoked.
Must be set to: account
Action *required
string (query)
A string with the name of the action to be invoked.
Must be set to: mcd_get_balance
address *required
string (query)
The address of the account.
block
string (query)
Either the block number as a string, or one of latest, earliest or pending latest will be the latest balance in a consensus block. earliest will be the first recorded balance for the address. pending will be the latest balance in consensus or nonconsensus blocks.

Get balance for address. Also available through a GraphQL 'addresses' query. If the balance hasn't been updated in a long time, we will double check with the node to fetch the absolute latest balance. This will not be reflected in the current request, but once it is updated, subsequent requests will show the updated balance. If you want to know whether or not we are checking for another balance, use the `balancemulti` action. That contains a property called `stale` that will let you know to recheck that balance in the near future.

?module=account&action=balance&address={addressHash}

Name
Description
Module *required string (query)
A string with the name of the module to be invoked.
Must be set to: account
Action *required
string (query)
A string with the name of the action to be invoked.
Must be set to: balance
address *required
string (query)
A 160-bit code used for identifying Accounts.

Get balance for multiple addresses. Also available through a GraphQL 'addresses' query. If the balance hasn't been updated in a long time, we will double check with the node to fetch the absolute latest balance. This will not be reflected in the current request, but once it is updated, subsequent requests will show the updated balance. You can know that this is taking place via the `stale` attribute, which is set to `true` if a new balance is being fetched.

?module=account&action=balancemulti&address={addressHash1,addressHash2,addressHash3}

Get pending transactions by address.

?module=account&action=pendingtxlist&address={addressHash}

Get transactions by address. Up to a maximum of 10,000 transactions. Also available through a GraphQL 'address' query.

?module=account&action=txlist&address={addressHash}

Get internal transactions by transaction or address hash. Up to a maximum of 10,000 internal transactions. Also available through a GraphQL 'transaction' query.

?module=account&action=txlistinternal&txhash={transactionHash}

Get token transfer events by address. Up to a maximum of 10,000 token transfer events. Also available through a GraphQL 'token_transfers' query.

?module=account&action=tokentx&address={addressHash}

Get token account balance for token contract address.

?module=account&action=tokenbalance&contractaddress={contractAddressHash}&address={addressHash}

Get list of tokens owned by address.

?module=account&action=tokenlist&address={addressHash}

Get list of blocks mined by address.

?module=account&action=getminedblocks&address={addressHash}

Get a list of accounts and their balances, sorted ascending by the time they were first seen by the explorer.

?module=account&action=listaccounts

Log

Get event logs for an address and/or topics. Up to a maximum of 1,000 event logs.

?module=logs&action=getLogs&fromBlock={blockNumber}&toBlock={blockNumber}&address={addressHash}&topic0={firstTopic}

Token

Get ERC-20 or ERC-721 token by contract address.

?module=token&action=getToken&contractaddress={contractAddressHash}

Get token holders by contract address.

?module=token&action=getTokenHolders&contractaddress={contractAddressHash}

Stats

Get ERC-20 or ERC-721 token total supply by contract address.

?module=stats&action=tokensupply&contractaddress={contractAddressHash}

Get total supply in Wei from exchange.

?module=stats&action=mcdsupplyexchange

Get total supply in Wei from DB.

?module=stats&action=mcdsupply

Get total coin supply from DB minus burnt number.

?module=stats&action=coinsupply

Get latest price of native coin in USD and BTC.

?module=stats&action=coinprice

Gets total transaction fees in Wei are paid by users to validators per day.

?module=stats&action=totalfees&date={date}