API

Chain

Get all shard information

Returns brief information of all shards.

Endpoint: /api?module=chain&action=shards

Parameters:

Parameter	Description
shardindex	to only return the specify shard. Use ‘g’ for global shard. If not specified, all shards will be included

Sample request:

{{api_get_url}}/api?module=chain&action=shards&shardindex=1

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": [
        {
            "ShardIndex": 1,
            "Throughput": 0.37,
            "TotalTxn": 9,
            "TotalStateSize": 920,
            "MempoolSize": 1,
            "AddressCount": 6,
            "Height": 49
        }
    ]
}

Get chain information

Returns overall information of the chain

Endpoint: /api?module=chain&action=status

Sample request:

{{api_get_url}}/api?module=chain&action=status

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "BlockInterval": 4000,
        "ForkRate": 0.01,
        "TotalBlocks": 245,
        "Difficulty": 0,
        "AvgGasPrice": 10000,
        "ShardOrder": 2,
        "Throughput": 1.3,
        "TotalTxn": 138,
        "TotalStateSize": 3431,
        "MempoolSize": 3,
        "AddressCount": 15,
        "Height": 49,
        "DeployName": "pyrolusite@dioxide",
        "ChainVersion": 64,
        "NumShards": 4
    }
}

Account

Return a list of transactions related to an address with pagination(Either signed by it or sent to it) .

Optional query parameters：transaction type, block height, account transaction type

The returned list is sorted by transaction confirmation time, from newer to older. To query older data, use pos parameter to skip newest transactions.

Endpoint: /api?module=address&action=listtxn

Parameters:

Parameter	Description
address	address, whose related transactions are to be searched for. Mandatory
pos	the amount of newest transactions to skip. Defaults to 0
limit	the maximum amount of transactions to be returned. Defaults to 20
contract	to only search for transactions invoking a certain contract, e.g. core.coin. Ignored when functions parameter is also given.
function	to only search for transactions invoking a certain function, e.g core.coin.address.coinbase.
txntype	enums: Scheduled, UserInitiated, IntraRelay, InboundRelay

Sample request:

{{api_get_url}}/api?module=address&action=listtxn&pos=0&limit=2&address=m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 58,
        "ListData": [
            {
                "Height": 49,
                "ShardIndex": 0,
                "ExecIndex": 1,
                "RelayGroupIndex": 255,
                "ShardOrder": 2,
                "BlockTime": 1641878760000,
                "TxnHash": "9ep83k7prgpkcz4y0h5p9ezjmgys3s2bpa6yd11frhddzds2e1y1",
                "TxnType": "Scheduled",
                "Initiator": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
                "Target": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
                "OriginalTxnHash": "yjkjt6bgryf9qefrv9qce1v0495wz1pe19wtv3vpsgs2xd28mnn1",
                "Func": "core.coin.address.reward",
                "Contract": "coin.core",
                "Invocation": {
                    "Input": {
                        "Reward": "63679230000:DIO"
                    },
                    "Return": 0
                },
                "TokenSymbol": "DIO",
                "TokenFutureMint": 0,
                "TokenDecimals": 8
            },
            {
                "Height": 49,
                "ShardIndex": 0,
                "ExecIndex": 0,
                "RelayGroupIndex": 255,
                "ShardOrder": 2,
                "BlockTime": 1641878760000,
                "TxnHash": "3yx58tae1a5nfq3pv6nhgmy7c6xhbvxhs3vfsj9h2vk12r7jxdt1",
                "TxnType": "Scheduled",
                "Initiator": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
                "Target": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
                "OriginalTxnHash": "yjkjt6bgryf9qefrv9qce1v0495wz1pe19wtv3vpsgs2xd28mnn1",
                "Func": "core.coin.address.coinbase",
                "Contract": "coin.core",
                "Invocation": {
                    "Input": {
                        "Reward": "5000000000:DIO"
                    },
                    "Return": 0
                },
                "TokenSymbol": "DIO",
                "TokenFutureMint": 0,
                "TokenDecimals": 8
            }
        ]
    }
}

Returns the balance by an address.

Endpoint: /api?module=address&action=balance

Parameters:

Parameter	Description
address	address, whose balance is to be returned. Mandatory

Sample request:

{{api_get_url}}/api?module=address&action=balance&address=7xds6xjd5d0qwqktwfta1mmrk7wtc4c2tptmbhje12x5h82adxwb7v0fk8:ed25519

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "Address": "7xds6xjd5d0qwqktwfta1mmrk7wtc4c2tptmbhje12x5h82adxwb7v0fk8:ed25519",
        "Contract": "core.coin.address",
        "Height": 7,
        "State": {
            "Balance": "102000000000:DIO"
        }
    }
}

Get the status of a contract of an address

Returns the latest status of a contract of an address

Endpoint: /api?module=address&action=state

Parameters:

Parameter	Description
address	address. Mandatory
contract	Mandatory
height	the height of block. Defaults to the latest hight

Sample request:

{{api_get_url}}/api?module=address&action=state&address=v2tdnhvaf0tm1fyqenxq99902q1mqy3hfvh0yfks5b4xzrtq11ye7rw274:ed25519&contract=address.stats.core&height=8

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "Address": "7gtgnayn3wbr3w4jjz5vrg9jeeg9mp58d3sydbd5grkg09heqzmrj2xk98:token",
        "Contract": "core.profile.address",
        "Height": 1,
        "ShardOrder": 1,
        "ShardIndex": 0,
        "State": {
            "Avatar": null,
            "Metadata": "",
            "FirstSeen": 1653383796000
        },
        "BlockHash": "mnsbn69tdd29bg97fn486gntv6hag8z0t0zrg8h2ddbhkrpz7yhg",
        "Timestamp": 1653383796000
    }
}

Get the detailed information of an address

Returns the detailed information of an address

Endpoint: /api?module=address&action=detail

Parameters:

Parameter	Description
address	address. Mandatory

Sample request:

{{api_get_url}}/api?module=address&action=detail&address=7gtgnayn3wbr3w4jjz5vrg9jeeg9mp58d3sydbd5grkg09heqzmrj2xk98:token

Sample address response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "ID": 1,
        "Symbol": "DIO",
        "Delegator": "&lt;address:null&gt;",
        "Flags": 0,
        "Metadata": "",
        "FirstSeen": 1653383796000,
        "LastSeen": 1653383796000,
        "TotalSupply": "20098437500000",
        "TotalContract": 3,
        "TotalTxn": 1,
        "TotalIssuedTxn": 0,
        "Balance": "10000000000:DIO",
        "CoinAge":123456,
        "TotalNftComposed": 3,
        "TotalNftManaged": 3,
        "NftHeld": 10000,
        "TotalTokenManaged":6,
        "TotalDappManaged":1
    }
}

DAPP address response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "Balance": "200000000:DIO",
        "Metadata": {
            "IconUrl": "https://scan.dioxide.network/img/overview3.png",
            "Name": "test",
            "Description": "Token For Test",
            "Website": "www.baidu.com",
            "Social": {
                "GitHub": "https://github.com",
                "Discord": "https://discord.com",
                "Twitter": "https://twitter.com",
                "Telegram": "https://telegram.org",
                "Facebook": "https://www.facebook.com"
            }
        },
        "FirstSeen": 1663812179248,
        "LastSeen": 1653384036000,
        "Wallet": {
            "1": "200000000"
        },
        "TotalContract": 4,
        "TotalTxn": 4,
        "ID": 2,
        "Address": "8evex4hrs10p1h2psjfv81fpfk6h4kwys424q0en7fezxr35nffbgxqenw:dapp",
        "Symbol": "test_dapp",
        "Flags": 0,
        "Height": 14,
        "Delegator": "8peb8xwhcq71mnqb9er8tw4xkdrhc02sj6v8vtt13bfet370py156jgb2m:ed25519"
    }
}

Get tokens of an address

Return a list of tokens related to an address with pagination.

Endpoint: /api?module=address&action=tokens

Parameters:

Parameter	Description
address	address. Mandatory
pos	the amount of newest token to skip. Defaults to 0
limit	the maximum amount of Token to be returned. without parameters pos and limit means non pagination. Defaults to 20 when only pos is given.
querytype	enums: held，managed

Sample request:

{{api_get_url}}/api?module=address&action=tokens&address=7gtgnayn3wbr3w4jjz5vrg9jeeg9mp58d3sydbd5grkg09heqzmrj2xk98:token

Held sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 1,
        "ListData": [
            {
                "CVID": 5196100,
                "Name": "DIO",
                "Symbol": "DIO",
                "Flag": 1,
                "Decimals": 8,
                "Owner": "",
                "Amount": "1999999999999959898950000",
                "IconUrl": "http://192.168.218.202:11000/img/logo.png",
                "TokenID": 5196100,
            },
            {
                "CVID": 494996029441,
                "Name": "TOKEN",
                "Symbol": "TESTDIO",
                "Flag": 1,
                "Decimals": 18,
                "TokenID": "22317080981488980",
                "Amount": "1999999999999999998"
            }
        ]
    }
}

Managed sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 2,
        "ListData": [
            {
                "Address": "ZZZZA:token",
                "Delegator": "vx8krtsqy2eyjh0vj18je3ymr6vzb3tv8w325schehry4bgbx8ct7ncdt0:ed25519",
                "Height": 24775,
                "Symbol": "ZZZZA",
                "IconUrl": "https://scan.dioxide.network/img/overview3.png",
                "BlockTime": 1694848727346,
                "TxnStatus": "Finalized",
                "TotalSupply": 0,
                "Decimals": 4,
                "Name": "TOKEN2"
            },
            {
                "Address": "TESTDIO:token",
                "Delegator": "vx8krtsqy2eyjh0vj18je3ymr6vzb3tv8w325schehry4bgbx8ct7ncdt0:ed25519",
                "Height": 217,
                "Symbol": "TESTDIO",
                "BlockTime": 1694749737316,
                "TxnStatus": "Finalized",
                "TotalSupply": "1999999999999999999",
                "Decimals": 18,
                "Name": "TOKEN"
            }
        ]
    }
}

Get contracts of an address

Return a list of contracts related to an address with pagination.

Endpoint: /api?module=address&action=contracts

Parameters:

Parameter	Description
address	address. Mandatory
pos	the amount of newest contract to skip. Defaults to 0
limit	the maximum amount of contract to be returned. Defaults to 20

Sample request:

{{api_get_url}}/api?module=address&action=contracts&address=m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr8:ed25519&pos=0&limit=10

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 3,
        "ListData": [
            {
                "Contract": "coin.core.coin.address"
            },
            {
                "Contract": "core.profile.address"
            },
            {
                "Contract": "core.stats.address"
            }
        ]
    }
}

Get the basic information of an address

Returns the basic information of an address

Endpoint: /api?module=address&action=baseinfo

Parameters:

Parameter	Description
address	address. Mandatory

Sample request:

{{api_get_url}}/api?module=address&action=baseinfo&address=yc2dmy658959kzdrf6dysxmfs7hqkzxa0y5tj6naq1mfpt4axa1g76g894:ed25519

Sample address response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "Address": "was7fdnfrqh42c7f68pv9s8efmf8y0hv4y6m3h0sgj3ypdfyv09379wh2g:ed25519",
        "Contract": "core.profile.address",
        "Height": 13749,
        "ShardOrder": 2,
        "ShardIndex": 1,
        "State": {
            "Avatar": null,
            "Metadata": {
                "IconUrl": "https://cdn.icon-icons.com/icons2/3127/PNG/512/cool\_expression\_face\_emoji\_emoticon\_glasses\_icon_192066.png",
                "Name": "TestAccount",
                "Social": {
                    "Discord": "",
                    "Email": "",
                    "Facebook": "",
                    "Github": "",
                    "Telegram": "",
                    "Twitter": ""
                },
                "Website": ""
            },
            "FirstSeen": 1664415402840
        },
        "Name": "TestAccount"
    }
}

Get DApps of an address

Return a list of DApps related to an address with pagination.

Endpoint: /api?module=address&action=dapps

Parameters:

Parameter	Description
address	address. Mandatory
pos	the amount of newest DApp to skip. Defaults to 0
limit	the maximum amount of DApp to be returned. without parameters pos and limit means non pagination. Defaults to 20 when only pos is given.

Sample request:

{{api_get_url}}/api?module=address&action=dapps&address=7gtgnayn3wbr3w4jjz5vrg9jeeg9mp58d3sydbd5grkg09heqzmrj2xk98:token

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 1,
        "ListData": [
            {
                "Address": "8evex4hrs10p1h2psjfv81fpfk6h4kwys424q0en7fezxr35nffbgxqenw:dapp",
                "MaxHeight": 14,
                "ID": 2,
                "Symbol": "test_dapp",
                "Flags": 0,
                "IconUrl": "https://scan.dioxide.network/img/overview3.png",
                "BlockTime": 1653383844000,
                "TxnStatus": "Finalized"
            }
        ]
    }
}

Transactions

Get pending transactions

Return a list of transactions currently in the memory pool waiting to be confirmed by future blocks with pagination.

Optional query parameters：shardindex

The returned list is sorted by transaction creation time, from newer to older. To query older data, use pos parameter to skip newest transactions.

Endpoint: /api?module=txn&action=pending

Parameters:

Parameter	Description
shardindex	to only search for transaction in a certain shard. Use g for global shard. If not specified, transactions from all shards will be included
pos	the amount of newest transactions to skip. Defaults to 0
limit	the maximum amount of transactions to be returned. Defaults to 20
contract	to only search for transactions invoking a certain contract, e.g. core.coin. Ignored when functions parameter is also given.
function	to only search for transactions invoking a certain function, e.g core.coin.address.coinbase.

Sample request:

{{api_get_url}}/api?module=txn&action=pending&pos=0&limit=15&shardindex=0

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 2,
        "ListData": [
            {
                "TxnHash": "jqa85mw0b5s118xhdery0ca2c5bfbf18tqvr46ysp2v41j55fw80",
                "RelayGroupIndex": 255,
                "ShardIndex": 0,
                "ShardOrder": 2,
                "TxnTime": 1641878760000,
                "TxnType": "UserInitiated",
                "Initiator": "8peb8xwhcq71mnqb9er8tw4xkdrhc02sj6v8vtt13bfet370py156jgb25:ed25519",
                "Target": "8peb8xwhcq71mnqb9er8tw4xkdrhc02sj6v8vtt13bfet370py156jgb25:ed25519",
                "OriginalTxnHash": null,
                "Func": "address.core.coin.address.transfer",
                "Contract": "coin.core",
                "Invocation": {
                    "Input": {
                        "To": "v2tdnhvaf0tm1fyqenxq99902q1mqy3hfvh0yfks5b4xzrtq11ye7rw271:ed25519",
                        "Amount": "1000000000"
                    }
                }
            },
            {
                "TxnHash": "xj9vjrn5fs4x5hgg2b01n0cr2cn4mwy5b279cph8kmx0635zpr01",
                "RelayGroupIndex": 255,
                "ShardIndex": 0,
                "ShardOrder": 2,
                "TxnTime": 1641878760000,
                "TxnType": "UserInitiated",
                "Initiator": "8peb8xwhcq71mnqb9er8tw4xkdrhc02sj6v8vtt13bfet370py156jgb25:ed25519",
                "Target": "8peb8xwhcq71mnqb9er8tw4xkdrhc02sj6v8vtt13bfet370py156jgb25:ed25519",
                "OriginalTxnHash": null,
                "Func": "core.coin.address.transfer",
                "Contract": "core.coin",
                "Invocation": {
                    "Input": {
                        "To": "m8zfv7kw4jw36xhzy0mje0d16mv5wpngr37nhkzmf45ftscseqb461pge6:ed25519",
                        "Amount": "1100000000"
                    }
                }
            }
        ]
    }
}

Get confirmed transactions

Return a list of transactions already confirmed by blocks on chain with pagination.

Optional query parameters：shardindex, block height, transaction type.

The returned list is sorted by transaction confirmation time, from newer to older. To query older data, use pos parameter to skip newest transactions.

Endpoint: /api?module=txn&action=history

Parameters:

Parameter	Description
shardindex	to only search for transaction in a certain shard. Use g for global shard. If not specified, transactions from all shards will be included
contract	to only search for transactions invoking a certain contract, e.g. core.coin. Ignored when functions parameter is also given.
function	to only search for transactions invoking a certain function, e.g core.coin.address.coinbase.
pos	the amount of newest transactions to skip. Defaults to 0
limit	the maximum amount of transactions to be returned. Defaults to 20

Sample request:

{{api_get_url}}/api?module=txn&action=history&pos=0&limit=2

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 132,
        "ListData": [
            {
                "Height": 49,
                "ShardIndex": 0,
                "ExecIndex": 1,
                "RelayGroupIndex": 255,
                "ShardOrder": 2,
                "BlockTime": 1641878760000,
                "TxnHash": "9ep83k7prgpkcz4y0h5p9ezjmgys3s2bpa6yd11frhddzds2e1y1",
                "TxnType": "Scheduled",
                "Initiator": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
                "Target": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
                "OriginalTxnHash": "yjkjt6bgryf9qefrv9qce1v0495wz1pe19wtv3vpsgs2xd28mnn1",
                "Func": "core.coin.address.reward",
                "Contract": "core.coin",
                "Invocation": {
                    "Input": {
                        "Reward": "63679230000:DIO"
                    },
                    "Return": 0
                }
            },
            {
                "Height": 49,
                "ShardIndex": 0,
                "ExecIndex": 0,
                "RelayGroupIndex": 255,
                "ShardOrder": 2,
                "BlockTime": 1641878760000,
                "TxnHash": "3yx58tae1a5nfq3pv6nhgmy7c6xhbvxhs3vfsj9h2vk12r7jxdt1",
                "TxnType": "Scheduled",
                "Initiator": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
                "Target": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
                "OriginalTxnHash": "yjkjt6bgryf9qefrv9qce1v0495wz1pe19wtv3vpsgs2xd28mnn1",
                "Func": "core.coin.address.coinbase",
                "Contract": "core.coin",
                "Invocation": {
                    "Input": {
                        "Reward": "5000000000:DIO"
                    },
                    "Return": 0
                }
            }
        ]
    }
}

Get detailed information of a transaction

Returns detailed information of a transaction.

Endpoint: /api?module=txn&action=details

Parameters:

Parameter	Description
hash	hash of the transaction to be queried. Mandatory

Sample request:

{{api_get_url}}/api?module=txn&action=details&hash=9ep83k7prgpkcz4y0h5p9ezjmgys3s2bpa6yd11frhddzds2e1y1Sample response: 

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "Content": {
            "BuildNum": 1,
            "GasOffered": 0,
            "GasPrice": "10000",
            "Grouped": false,
            "uTxnSize": 138,
            "Mode": "ITM\_PERADDRESS|TGM\_RELAY|TMF\_EMIITTER\_EMBEDDED",
            "Initiator": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
            "OrigTxHash": "yjkjt6bgryf9qefrv9qce1v0495wz1pe19wtv3vpsgs2xd28mnn1",
            "OrigExecIdx": 0,
            "Address": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
            "Function": "core.coin.address.reward",
            "Input": {
                "Reward": "63679230000:DIO"
            },
            "Invocation": {
                "Return": 0,
                "CoinDelta": "63679230000",
                "GasFee": "0"
            },
            "Height": 49,
            "Shard": [
                0,
                2
            ],
            "BlockTime": 1641878809000,
            "ConfirmState": "TXN_CONFIRMED",
            "ConfirmedBy": "1q2fzkh4z2nx265h74nqss022wkpf9gp94b23ceyx11jchbwwh50:1",
            "Hash": "9ep83k7prgpkcz4y0h5p9ezjmgys3s2bpa6yd11frhddzds2e1y1",
            "ExecStage": "XTG_SCHEDULED",
            "Miner": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519"
        },
        "Hash": "9ep83k7prgpkcz4y0h5p9ezjmgys3s2bpa6yd11frhddzds2e1y1"
    }
}

Block

Get master blocks

Returns a list of master blocks with pagination .

The returned list is sorted by block height, from newer to older. To query older data, use pos parameter to skip newest blocks.

Endpoint: /api?module=block&action=headerhistory

Parameters:

Parameter	Description
pos	the amount of newest blocks to skip. Defaults to 0
limit	the maximum amount of blocks to be returned. Defaults to 20
height	when querying with block height, pos and limit are invalid

Sample request:

{{api_get_url}}/api?module=block&action=headerhistory&pos=0&limit=2

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 50,
        "ListData": [
            {
                "Height": 49,
                "Timestamp": 1641878760000,
                "NumScheduledTxns": 3,
                "NumUserInitiatedTxns": 0,
                "NumIntraRelayTxns": 0,
                "NumInboundRelayTxns": 0,
                "NumOutboundRelayTxns": 0,
                "NumDeferredRelayTxns": 0,
                "NumDispatchedRelayTxns": 2,
                "NumExecutedTxns": 3,
                "NumEmittedTxns": 2,
                "MinerAddress": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
                "Reward": "0",
                "Hash": "gm4z93n4gnph3wvwc9vev7541z04fsmschv1xq2bq6p8yy7tejc1"
            },
            {
                "Height": 48,
                "Timestamp": 1641878756000,
                "NumScheduledTxns": 5,
                "NumUserInitiatedTxns": 0,
                "NumIntraRelayTxns": 0,
                "NumInboundRelayTxns": 1,
                "NumOutboundRelayTxns": 0,
                "NumDeferredRelayTxns": 0,
                "NumDispatchedRelayTxns": 4,
                "NumExecutedTxns": 6,
                "NumEmittedTxns": 4,
                "MinerAddress": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
                "Reward": "63679230000",
                "Hash": "aftsprzpkjygg7xkxkeh0js1cyg84qdgwmbvtw38wd56eq1r9611"
            }
        ]
    }
}

Get detailed information of a header block

Returns detailed information of a header block.

Endpoint: /api?module=block&action=headerdetails

Parameters:

Parameter	Description
hash	hash of the block to query. It could be either a master block or a transaction block
height	when height parameters be given, the hash is invalid

Sample request:

{{api_get_url}}/api?module=block&action=headerdetails&hash=xdh8c98hhxhh9cnd2jhnaeq790r1b98p8br7t9mca5fem61wze91

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "Content": {
            "Size": 348,
            "Version": 64,
            "Prev": "ag3wgrp0srkbd2dxd686p730sbmbqd8vhh2pyhsn57hah582mzx1",
            "Height": 20,
            "ShardOrder": 2,
            "Timestamp": 1641878644000,
            "TxnCount": [
                2,
                0,
                0,
                0,
                0,
                0
            ],
            "ShardBlockMerkle": "ezqp0yy5has94jz2y8tj5e1xp87np8skdn7t3vqv5jphdfxqy1y1",
            "ShardChainStateMerkle": "syxfnd64vcha76rj9646r7v26s5dc51zmf09w4shc837cxv8d3x1",
            "ShardProcessedTxnMerkle": "p3zyfya24p926j9xfk8vkzffza6zz5rk11zya9ft18nwnqgb2m00",
            "ShardOutboundRelayMerkle": "vdb12kg0zqac3y2wh4nz6pp9n298kaqcp7nx1abcvsg6mx4bbnr1",
            "GlobalBlockMerkleLeaf": "2ppec4ks8xhfbr5aqpmd9krmxcam7m0z5j552d9zj4vj68dbh6w0",
            "GlobalChainStateMerkle": "btkh5y0s467wvvgfe2pe014rvgt914e5k2adgp9vz0w5qhpnxxn1",
            "GlobalProcessedTxnMerkle": "rzj8g4pff44xd4e8c3x2nz16bjrq7g7ea9s2v32gp6wxq9j2vrc1",
            "Consensus": "CONSENSUS_NOOP",
            "Miner": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
            "TotalGasFee": "0",
            "AvgGasPrice": "10000",
            "ScalingNext": false,
            "SnapshotCarried": 0,
            "Uncles": [],
            "PowTarget": [
                1,
                0
            ],
            "PowDifficulty": 0,
            "PowNonce": "",
            "Hash": "xdh8c98hhxhh9cnd2jhnaeq790r1b98p8br7t9mca5fem61wze91",
            "BlockInterval": 4000,
            "Throughput": 1.7,
            "Stage": "DUS_EXECUTED"
        },
        "Hash": "xdh8c98hhxhh9cnd2jhnaeq790r1b98p8br7t9mca5fem61wze91"
    }
}

Get transaction blocks

Return a list of transaction blocks with pagination.

Optional query parameters：shardindex, block height

The returned list is sorted by block height, from newer to older. To query older data, use pos parameter to skip newest blocks.

Endpoint: /api?module=block&action=blockhistory

Parameters:

Parameter	Description
shardindex	to only get blocks in a certain shard. Use g for global shard. If not specified, transaction blocks from all shards will be included
pos	the amount of newest blocks to skip. Defaults to 0
limit	the maximum amount of blocks to be returned. Defaults to 20
height	If given, to only return transaction blocks at a certain height

Sample request:

{{api_get_url}}/api?module=block&action=blockhistory&pos=0&limit=2&shardindex=0

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 50,
        "ListData": [
            {
                "ShardIndex": 0,
                "Height": 49,
                "Timestamp": 1641878760000,
                "NumScheduledTxns": 2,
                "NumUserInitiatedTxns": 0,
                "NumIntraRelayTxns": 0,
                "NumInboundRelayTxns": 0,
                "NumOutboundRelayTxns": 0,
                "NumDeferredRelayTxns": 0,
                "NumDispatchedRelayTxns": 0,
                "NumExecutedTxns": 2,
                "NumEmittedTxns": 0,
                "MinerAddress": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
                "GasFee": "0",
                "Hash": "hg20ec44y672199d020z1q6k1nr6xbtybe9hr2pgs3v1whsfjf30"
            },
            {
                "ShardIndex": 0,
                "Height": 48,
                "Timestamp": 1641878756000,
                "NumScheduledTxns": 3,
                "NumUserInitiatedTxns": 0,
                "NumIntraRelayTxns": 0,
                "NumInboundRelayTxns": 0,
                "NumOutboundRelayTxns": 0,
                "NumDeferredRelayTxns": 0,
                "NumDispatchedRelayTxns": 0,
                "NumExecutedTxns": 3,
                "NumEmittedTxns": 0,
                "MinerAddress": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
                "GasFee": "95320000",
                "Hash": "440rgka0x9z19pdd2w2s5d7qtmb0je93rak0fnq058nsk4pxehm0"
            }
        ]
    }
}

Get detailed information of a block

Returns detailed information of a block.

Endpoint: /api?module=block&action=blockdetails

Parameters:

Parameter	Description
hash	hash of the block to query. It could be either a master block or a transaction block
shardindex	to only get block in a certain shard. Use g for global shard
height	shardindex and height must be given at the same time, and the hash is invalid

Sample request:

{{api_get_url}}/api?module=block&action=blockdetails&shardindex=0&height=20

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "Content": {
            "Size": 393,
            "Version": 64,
            "Scope": "shard",
            "Shard": [
                0,
                2
            ],
            "Prev": "q90kmw07ywygawy80nghv4rc4x3jcgxtdthcaa90abd466ehrvb1",
            "TxnCount": [
                1,
                0,
                0,
                0,
                0,
                0
            ],
            "ExecutionCount": 1,
            "ConsensusHeaderHash": "xdh8c98hhxhh9cnd2jhnaeq790r1b98p8br7t9mca5fem61wze91",
            "BlockMerkleLeaf": "wdtvqgy6c76t02cmv8ja5v3r5y5atmmsrvy1jhy8ac3q0q9qd260",
            "ConfirmedTxnHash": "0000000000000000000000000000000000000000000000000000",
            "ConfirmedTxnMerkle": "0000000000000000000000000000000000000000000000000000",
            "ProcessedTxnMerkle": "ege7wr6rtar52ztmpkg0ysbt3yf42gmnz1hes9gdjj171mh006k0",
            "ChainStateMerkle": "7qq8f9eyensfrnx1m249g4h6gp90jz4xw8r6txxbpegc8mm61me1",
            "OutboundRelayMerkleRoot": "0000000000000000000000000000000000000000000000000000",
            "TotalGasFee": "0",
            "AvgGasPrice": "10000",
            "Hash": "fz35p8rcaq8p2268a9rkyd550vbg3wyeapxc8zcktbsczb8980m0",
            "Height": 20,
            "Timestamp": 1641878644000,
            "Miner": "m00ad46hnbt27hg05vfdpahp1jp8gyfp3vytst9yxhewfv4ws5x4669dr2:ed25519",
            "State": "DUS_FINALIZED",
            "Transactions": {
                "Scheduled": [
                    "ege7wr6rtar52ztmpkg0ysbt3yf42gmnz1hes9gdjj171mh006k0"
                ],
                "Confirmed": [],
                "IntraRelays": [],
                "OutboundRelays": [],
                "Deferred": []
            }
        },
        "Hash": "fz35p8rcaq8p2268a9rkyd550vbg3wyeapxc8zcktbsczb8980m0"
    }
}

Get executed transactions already included in shard blocks

Return a list of executed transactions already included in blocks on chain by height.

The returned list is sorted by transaction confirmation time, from newer to older. To query older data, use pos parameter to skip newest transactions.

To only search for transactionsin a given block height, specify height.

Endpoint: /api?module=block&action=txn_executed

Parameters:

Parameter	Description
shardindex	to only get transactions in a certain shard. Use g for global shard. Mandatory
height	to only get transactions at a certain height. Mandatory
pos	the amount of newest transactions to skip. Defaults to 0
limit	the maximum amount of transactions to be returned. Defaults to 20

Sample request:

{{api_get_url}}/api?module=block&action=txn_executed&height=48&shardindex=g

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 2,
        "ListData": [
            {
                "Height": 48,
                "ShardIndex": 65535,
                "ExecIndex": 1,
                "RelayGroupIndex": 255,
                "ShardOrder": 2,
                "BlockTime": 1641878756000,
                "TxnHash": "82c1zxbh8p3h03qswqdqv7pfxrynjbbk4fcfhrw1wartyhqjqe41",
                "TxnType": "InboundRelay",
                "Initiator": "8peb8xwhcq71mnqb9er8tw4xkdrhc02sj6v8vtt13bfet370py156jgb25:ed25519",
                "Target": null,
                "OriginalTxnHash": "mcqj62n61yvzkg71jtrkdd73sjncvwzh6729rwrmt5bc8r6mdd91",
                "Func": "core.tokens.global.register",
                "Contract": "core.tokens",
                "Invocation": {
                    "Input": {
                        "Rules": 1,
                        "Symbol": "D-ETH",
                        "Initial": "100000000000000"
                    },
                    "Return": 0
                }
            },
            {
                "Height": 48,
                "ShardIndex": 65535,
                "ExecIndex": 0,
                "RelayGroupIndex": 255,
                "ShardOrder": 2,
                "BlockTime": 1641878756000,
                "TxnHash": "zws0pg9mxxkkcetjt0zde9pxa9a6m3ssm0q0nfkb081btzdyz341",
                "TxnType": "Scheduled",
                "Initiator": null,
                "Target": null,
                "OriginalTxnHash": null,
                "Func": "core.coin.global.issue",
                "Contract": "core.coin",
                "Invocation": {
                    "Input": {},
                    "Return": 0
                }
            }
        ]
    }
}

Get emitted transactions already included in shard blocks

Return a list of emitted transactions already included in blocks on chain by height.

The returned list is sorted by transaction confirmation time, from newer to older. To query older data, use pos parameter to skip newest transactions.

To only search for transactionsin a given block height, specify height.

Endpoint: /api?module=block&action=txn_emitted

Parameters:

Parameter	Description
shardindex	to only get transactions in a certain shard. Use g for global shard. Mandatory
height	to only get transactions at a certain height. Mandatory
pos	the amount of newest transactions to skip. Defaults to 0
limit	the maximum amount of transactions to be returned. Defaults to 20

Sample request:

{{api_get_url}}/api?module=block&action=txn_emitted&pos=0&limit=2&height=48&shardindex=g

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 4,
        "ListData": [
            {
                "Height": 48,
                "ShardIndex": 65535,
                "EmitIndex": 3,
                "RelayGroupIndex": 255,
                "ShardOrder": 2,
                "BlockTime": 1641878756000,
                "TxnHash": "f5wsyvbrykc4cpj1az3tmhhv2c4agnqsy4xe3aa9w601f2c2r6f0",
                "TxnType": "DispatchedRelay",
                "Initiator": "8peb8xwhcq71mnqb9er8tw4xkdrhc02sj6v8vtt13bfet370py156jgb25:ed25519",
                "Target": "8peb8xwhcq71mnqb9er8tw4xkdrhc02sj6v8vtt13bfet370py156jgb25:ed25519",
                "OriginalTxnHash": "82c1zxbh8p3h03qswqdqv7pfxrynjbbk4fcfhrw1wartyhqjqe41",
                "Func": "core.wallet.address.deposit",
                "Contract": "core.wallet",
                "Invocation": {
                    "Input": {
                        "Deposit": "100000000000000:"
                    }
                }
            },
            {
                "Height": 48,
                "ShardIndex": 65535,
                "EmitIndex": 2,
                "RelayGroupIndex": 255,
                "ShardOrder": 2,
                "BlockTime": 1641878756000,
                "TxnHash": "8jdz000rzr0v6zg8fdgyh464ra5wpke4faps0rggrje1cz2vz5y0",
                "TxnType": "DispatchedRelay",
                "Initiator": "8peb8xwhcq71mnqb9er8tw4xkdrhc02sj6v8vtt13bfet370py156jgb25:ed25519",
                "Target": "bhyj7j97c9wrh115hbmbqkrpe7d8yfq078n4djjvfe3bcpvspvz8kbyfm2:token",
                "OriginalTxnHash": "82c1zxbh8p3h03qswqdqv7pfxrynjbbk4fcfhrw1wartyhqjqe41",
                "Func": "core.delegation.address.token_finalize",
                "Contract": "core.delegation",
                "Invocation": {
                    "Input": {
                        "TokenId": 2
                    }
                }
            }
        ]
    }
}

Token

Get a list of tokens.

Return a list of tokens with pagination.

Endpoint: /api?module=token&action=listtoken

Parameters:

Parameter	Description
pos	the amount of newest tokens to skip. Defaults to 0
limit	the maximum amount of tokens to be returned. Defaults to 20

Sample request:

{{api_get_url}}/api?module=token&action=listtoken&pos=0&limit=2

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 2,
        "ListData": [
            {
                "CVID": 288836550657,
                "Name": "testt2",
                "Symbol": "testv2",
                "Flag": 1,
                "Decimals": 18,
                "TotalSupply": 0,
                "Height": 73,
                "TokenID": 280688745050,
                "Description": "TestDapp",
                "IconUrl": "https://scan.dioxide.network/img/overview3.png"
            },
            {
                "CVID": 495000223745,
                "Name": "TOKEN2",
                "Symbol": "ZZZZ",
                "Flag": 1,
                "Decimals": 18,
                "TotalSupply": "2000000000000000000",
                "Height": 21683,
                "TokenID": 1515870810
            }
        ]
    }
}

Get information of token by Symbol.

Return basic information of token.

Endpoint: /api?module=token&action=baseinfo

Parameters:

Parameter	Description
symbol	Mandatory. the symbol of token

Sample request:

{{api_get_url}}/api?module=token&action=baseinfo&symbol=JACK

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "CVID": 288836550657,
        "Name": "testt2",
        "Symbol": "testv2",
        "Flag": 1,
        "Decimals": 18,
        "TotalSupply": 0,
        "Owner": "8peb8xwhcq71mnqb9er8tw4xkdrhc02sj6v8vtt13bfet370py156jgb2m:ed25519",
        "Height": 73,
        "Contract": "TestDapp.contract#0400.global",
        "TokenID": 280688745050,
        "Description": "TestDapp",
        "IconUrl": "https://scan.dioxide.network/img/overview3.png"
    }
}

DApp

Get a list of DApps.

Return a list of DApps with pagination.

Endpoint: /api?module=dapp&action=listdapp

Parameters:

Parameter	Description
pos	the amount of newest DApp to skip. Defaults to 0
limit	the maximum amount of DApp to be returned. Defaults to 20

Sample request:

{{api_get_url}}/api?module=dapp&action=listdapp&pos=0&limit=10

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 2,
        "ListData": [
            {
                "ID": 2,
                "Address": "8evex4hrs10p1h2psjfv81fpfk6h4kwys424q0en7fezxr35nffbgxqenw:dapp",
                "Symbol": "test_dapp",
                "Flags": 0,
                "Height": 14,
                "IconUrl": "https://scan.dioxide.network/img/overview3.png"
            },
            {
                "ID": 1,
                "Address": "f9kk4ytm72b1qhgewtzp7z9qtq2qwwhd9b30xqyvcf6x72hmme0xh5arg0:dapp",
                "Symbol": "core",
                "Flags": 0,
                "Height": 1
            }
        ]
    }
}

Get information of DApp by Symbol.

Return basic information of DApp.

Endpoint: /api?module=dapp&action=baseinfo

Parameters:

Parameter	Description
symbol	Mandatory. the symbol of DApp

Sample request:

{{api_get_url}}/api?module=dapp&action=baseinfo&symbol=test_dapp

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "ID": 2,
        "Address": "8evex4hrs10p1h2psjfv81fpfk6h4kwys424q0en7fezxr35nffbgxqenw:dapp",
        "Symbol": "test_dapp",
        "Flags": 0,
        "Height": 14,
        "Metadata": {
            "IconUrl": "https://scan.dioxide.network/img/overview3.png",
            "Name": "test",
            "Description": "Token For Test",
            "Website": "www.baidu.com",
            "Social": {
                "GitHub": "https://github.com",
                "Discord": "https://discord.com",
                "Twitter": "https://twitter.com",
                "Telegram": "https://telegram.org",
                "Facebook": "https://www.facebook.com"
            }
        }
    }
}

Contract

Get a list of Contracts.

Returns a list of all contracts for this Dapp, with pagination.

Endpoint: /api?module=contract&action=listcontract

Parameters:

Parameter	Description
pos	the amount of newest DApp to skip. Defaults to 0
limit	the maximum amount of DApp to be returned. Defaults to 20

Sample request:

{{api_get_url}}/api?module=contract&action=listcontract&pos=0&limit=8&address=TestDapp:dapp

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "TotalNum": 2,
        "ListData": [
            {
                "Contract": "TestDapp.IFungibleToken",
                "CID": 287763857408,
                "LastCVID": 287763857410,
                "LastVersion": "v2",
                "LastDeployment": 1694391790177
            },
            {
                "Contract": "TestDapp.IWallet",
                "CID": 287764905984,
                "LastCVID": 287764905985,
                "LastVersion": "v1",
                "LastDeployment": 1694391559743
            }
        ]
    }
}

Get information of Contract.

Returns the basic information of a contract.

Endpoint: /api?module=contract&action=baseinfo

Parameters:

Parameter	Description
contract	Mandatory. the name of Contract

Sample request:

{{api_get_url}}/api?module=contract&action=baseinfo&contract=TestDapp.IFungibleToken

Sample response:

{
    "Status": 0,
    "Message": "success",
    "Result": {
        "DappAddress": "TestDapp:dapp",
        "Contract": "TestDapp.IFungibleToken",
        "CID": 287763857408,
        "LastCVID": 287763857410,
        "LastVersion": "v2",
        "LastDeployment": 1694391790177,
        "Height": 26,
        "SourceCode": "contract IFungibleToken {\\n    interface FungibleTokenInterface {\\n        // Mint the amount of tokens\\n        @address function token mint(bigint amount);\\n        // Burn the amount of tokens\\n        @address function burn(token t);\\n        // Get the amount of token supply\\n        @global function bigint getSupply() const;\\n        // Get the token name\\n        @global function const string getName() const;\\n        // Get the token symbol\\n        @global function const string getSymbol() const;\\n        // Get the token decimals\\n        @global function uint32 getDecimals() const;\\n        // Get the token owner\\n        @global function address getOwner() const;\\n    }\\n}"
    }
}

Chain​

Get all shard information​

Get chain information​

Account​

Get transactions related to an address​

Get balance related to an address​

Get the status of a contract of an address​

Get the detailed information of an address​

Get tokens of an address​

Get contracts of an address​

Get the basic information of an address​

Get DApps of an address​

Transactions​

Get pending transactions​

Get confirmed transactions​

Get detailed information of a transaction​

Block​

Get master blocks​

Get detailed information of a header block​

Get transaction blocks​

Get detailed information of a block​

Get executed transactions already included in shard blocks​

Get emitted transactions already included in shard blocks​

Token​

Get a list of tokens.​

Get information of token by Symbol.​

DApp​

Get a list of DApps.​

Get information of DApp by Symbol.​

Contract​

Get a list of Contracts.​

Get information of Contract.​

Chain

Get all shard information

Get chain information

Account

Get transactions related to an address

Get balance related to an address

Get the status of a contract of an address

Get the detailed information of an address

Get tokens of an address

Get contracts of an address

Get the basic information of an address

Get DApps of an address

Transactions

Get pending transactions

Get confirmed transactions

Get detailed information of a transaction

Block

Get master blocks

Get detailed information of a header block

Get transaction blocks

Get detailed information of a block

Get executed transactions already included in shard blocks

Get emitted transactions already included in shard blocks

Token

Get a list of tokens.

Get information of token by Symbol.

DApp

Get a list of DApps.

Get information of DApp by Symbol.

Contract

Get a list of Contracts.

Get information of Contract.