> For the complete documentation index, see [llms.txt](https://siriusnetdocs.gitbook.io/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://siriusnetdocs.gitbook.io/doc/whitepaper/siriusscan.md).

# Siriusscan

[Siriusscan](https://scan.siriusnet.io) 

<div align="left"><figure><img src="/files/EwI5jatbtUoUI0nee015" alt="" width="375"><figcaption></figcaption></figure></div>

## API Documentation

`[ Base URL:` [`https://scan.siriusnet.io/api`](https://scan.siriusnet.io/api) `]`

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

[Account?module=account](https://scan.siriusnet.io/api-docs#account)[Logs?module=logs](https://scan.siriusnet.io/api-docs#logs)[Token?module=token](https://scan.siriusnet.io/api-docs#token)[Stats?module=stats](https://scan.siriusnet.io/api-docs#stats)[Block?module=block](https://scan.siriusnet.io/api-docs#block)[Contract?module=contract](https://scan.siriusnet.io/api-docs#contract)[Transaction?module=transaction](https://scan.siriusnet.io/api-docs#transaction)

### Account <mark style="color:green;">`?module=account`</mark>

#### Mimics Siriusnet JSON RPC's mcd\_getBalance. Returns the balance as of the provided block (defaults to latest)

<mark style="color:green;">?module=</mark><mark style="color:green;">**account**</mark><mark style="color:green;">\&action=</mark><mark style="color:green;">**mcd\_get\_balance**</mark><mark style="color:green;">\&address={</mark><mark style="color:green;">**addressHash**</mark><mark style="color:green;">}</mark>

<mark style="color:orange;">mcd\_get\_balance</mark>                                                                                                                                      <mark style="color:yellow;">GET</mark>  <mark style="color:green;">POST</mark>

<table><thead><tr><th width="193">Name</th><th width="534">Description</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Module   </strong><mark style="color:red;"><strong>*required</strong></mark><br><mark style="color:purple;">string </mark><em><mark style="color:purple;">(query)</mark></em></td><td><p>A string with the name of the module to be invoked.</p><p><strong>Must be set to:</strong> <em>account</em></p></td><td></td></tr><tr><td><p><strong>Action     </strong><mark style="color:red;"><strong>*required</strong></mark></p><p><mark style="color:purple;">string </mark><em><mark style="color:purple;">(query)</mark></em></p></td><td><p>A string with the name of the action to be invoked.</p><p><strong>Must be set to:</strong> mcd<em>_get_balance</em></p></td><td></td></tr><tr><td><p><strong>address   </strong><mark style="color:red;"><strong>*required</strong></mark></p><p><mark style="color:purple;">string </mark><em><mark style="color:purple;">(query)</mark></em></p></td><td>The address of the account.</td><td></td></tr><tr><td><p><strong>block</strong></p><p><mark style="color:purple;">string </mark><em><mark style="color:purple;">(query)</mark></em></p></td><td>Either the block number as a string, or one of latest, earliest or pending latest will be the latest balance in a <em>consensus</em> block. earliest will be the first recorded balance for the address. pending will be the latest balance in consensus <em>or</em> nonconsensus blocks.</td><td></td></tr></tbody></table>

#### 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.

#### <mark style="color:purple;">?module=</mark><mark style="color:purple;">**account**</mark><mark style="color:purple;">\&action=</mark><mark style="color:purple;">**balance**</mark><mark style="color:purple;">\&address={</mark><mark style="color:purple;">**addressHash**</mark><mark style="color:purple;">}</mark>

<table><thead><tr><th width="193">Name</th><th width="534">Description</th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Module   </strong><mark style="color:red;"><strong>*required</strong></mark><br><mark style="color:purple;">string </mark><em><mark style="color:purple;">(query)</mark></em></td><td><p>A string with the name of the module to be invoked.</p><p><strong>Must be set to:</strong> <em>account</em></p></td><td></td></tr><tr><td><p><strong>Action     </strong><mark style="color:red;"><strong>*required</strong></mark></p><p><mark style="color:purple;">string </mark><em><mark style="color:purple;">(query)</mark></em></p></td><td><p>A string with the name of the action to be invoked.</p><p><strong>Must be set to:</strong> <em>balance</em></p></td><td></td></tr><tr><td><p><strong>address   </strong><mark style="color:red;"><strong>*required</strong></mark></p><p><mark style="color:purple;">string </mark><em><mark style="color:purple;">(query)</mark></em></p></td><td><p>A 160-bit code used for identifying Accounts.</p><p><br></p></td><td></td></tr></tbody></table>

#### 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**}<br>

#### 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&#x20;

#### Get [ERC-20](https://github.com/ethereum/EIPs/issues/20) or [ERC-721](https://github.com/ethereum/EIPs/issues/721) token by contract address.

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

#### Get token holders by contract address.

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

## Stats&#x20;

#### Get [ERC-20](https://github.com/ethereum/EIPs/issues/20) or [ERC-721](https://github.com/ethereum/EIPs/issues/721) token total supply by contract address.

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

#### Get total supply in Wei from exchange.

?module=**stats**\&action=mcd**supplyexchange**

#### Get total supply in Wei from DB.

?module=**stats**\&action=mcd**supply**

#### 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**}