Accounts

Get Metadium Balance for a Single Address

Returns the Metadium balance of a given address.

POST https://testnetapi.metadium.com/v1/accounts/balance
api-key: Your API Key
Content-Type: application/json

{
    "addresses" : [
                "0xcB24fBed8597dd1ff71daBB56b939Ec440a5041E",
                "0xa5eb6c837FA2123b8d3749F85061Efd7471E9352"
    ]
}

Request

Query Parameters

Parameter	Description
addresses	type: List<String> value: Address of account (min: 1, max: 20) required: true

Response

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "data": [
            {
                "address": "0xcb24fbed8597dd1ff71dabb56b939ec440a5041e",
                "balance": "10000023751520000000000000"
            },
            {
                "address": "0xa5eb6c837fa2123b8d3749f85061efd7471e9352",
                "balance": "10000010000000000000000000"
            }
        ]
    }
}

---

Get a list of 'Normal' Transactions by Address.

Returns the list of transactions performed by an address, with optional pagination.

GET https://testnetapi.metadium.com/v1/accounts/{address_hash}/transactions
api-key: Your API Key

Request

Query Parameters

Parameter	Description
address_hash	type: String value: Address (sender/receiver/contract) required: true
limit	type: Integer value: Maximum number of record will retrieve (Default: 50, Max: 1000) required: false
offset	type: Integer value: Start retrieve record (Default: 0) required: false
startBlock	type: String value: Start block (Default: null) required: false
endBlock	type: String value: End block (Default: null) required: false
input	type: Boolean value: Include input data (true/false[Default]) required: false
simple	type: Boolean value: Include data simple (true/false[Default]) required: false
condition	type: String value: Address condition (all[Default]/to/from/contract) required: false

Response

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "2",
        "data": [
            {
                "timestamp": "2020-04-26T07:52:21Z",
                "sender": "0x5e7dcedce34f001f3b50691909a60493befe6e0e",
                "receiver": "0xa5eb6c837fa2123b8d3749f85061efd7471e9352",
                "value": "10000000000000000000",
                "confirmations": "37604809",
                "transaction_hash": "0x1060fc6746ea273310dc5183284522e6dc1a441b3a627734800da592dfe255f4",
                "block_hash": "0x22753ebf9aabf0ec0c0572de32bc6de70a4ec6ab0732393174f2cb6fe66f5557",
                "transaction_index": "5",
                "tx_status": "1",
                "block_number": "7020231",
                "gas_price": "80000000000",
                "cumulative_gas_used": "126000",
                "gas_used": "21000",
                "max_fee_per_gas": "0",
                "max_priority_fee_per_gas": "0"
            },
            ...
        ]
    }
}

Response (Simple Transaction)

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "2",
        "data": [
            {
                "sender": "0x5e7dcedce34f001f3b50691909a60493befe6e0e",
                "receiver": "0xa5eb6c837fa2123b8d3749f85061efd7471e9352",
                "value": "10000000000000000000",
                "transaction_hash": "0x1060fc6746ea273310dc5183284522e6dc1a441b3a627734800da592dfe255f4",
                "tx_status": "1",
                "tx_fee": "1680000000000000",
                "block_number": "7020231",
                "gas_price": "80000000000",
                "gas_used": "21000"
            },
            ...
        ],
        "to_block": "44625066"
    }
}

---

Get a list of 'Internal' Transactions by Address

Returns the list of internal transactions performed by an address, with optional pagination.

GET https://testnetapi.metadium.com/v1/accounts/{address_hash}/internal-transactions
api-key: Your API Key

Request

Query Parameters

Parameter	Description
address_hash	type: String value: Address (sender/receiver/contract) required: true
limit	type: Integer value: Maximum number of record will retrieve (Default: 50, Max: 1000) required: false
offset	type: Integer value: Start retrieve record (Default: 0) required: false
startBlock	type: String value: Start block (Default: null) required: false
endBlock	type: String value: End block (Default: null) required: false
input	type: Boolean value: Include input data (true/false[Default]) required: false

Response

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "94",
        "data": [
            {
                "timestamp": "2021-08-02T11:21:07Z",
                "sender": "0xe08ebedb48bb74a2ee8795df89b1120f6961aae1",
                "receiver": "0xc27344926ddf38206f25c67aaa95d765f5152c9f",
                "value": "0",
                "status": "1",
                "message": null,
                "transaction_hash": "0x38731e9fe92018bdc1b7f7677957d22ce25da9c518eb07f8965b50db670dd662",
                "block_number": "15051540",
                "contract_address": null,
                "trace_address": [
                    "0",
                    "1",
                    "1",
                    "1"
                ],
                "trace_type": "call",
                "sub_traces": "0",
                "transaction_index": "0",
                "gas_used": "2214",
                "gas_limit": "9045055",
                "external_receiver": false
            },
            ...
        ]
    }
}

---

Get a list of 'MRC20 - Token Transfer Events' by Address

Returns the list of MRC-20 tokens transferred by an address, with optional filtering by token contract.

GET https://testnetapi.metadium.com/v1/accounts/{address_hash}/token-transfer/mrc20
api-key: Your API Key

Request

Query Parameters

Parameter	Description
address_hash	type: String value: Address (sender/receiver/contract) or Transaction Address required: true
limit	type: Integer value: Maximum number of record will retrieve (Default: 50, Max: 1000) required: false
offset	type: Integer value: Start retrieve record (Default: 0) required: false
startBlock	type: String value: Start block (Default: null) required: false
endBlock	type: String value: End block (Default: null) required: false

Response

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "7",
        "data": [
            {
                "timestamp": "2020-02-05T14:38:27Z",
                "sender": "0x0000000000000000000000000000000000000000",
                "receiver": "0x47f7b1714603beebf0643e7ba5c7d7c9b7ef7d27",
                "value": "100000000000000000000000000",
                "confirmations": "39020970",
                "block_number": "5609795",
                "transaction_hash": "0x45fe883911454250848a3cbba887765560ac52c081a5ba8bdfb17f3004b35fe0",
                "block_hash": "0x3c633068bc59eaabafef553c4b460b30a23c47afc731096ea23d9c6fa90465dc",
                "token_address": "0x8b77b325d3866c1dcedd128bae7f7192af1e3807",
                "token_name": "metaSAFE Token",
                "token_symbol": "MESA",
                "token_decimals": "18",
                "transaction_index": "0"
            },
            ...
        ]
    }
}

---

Get a list of 'MRC721 - Token Transfer Events' by Address

Returns the list of MRC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract.

GET https://testnetapi.metadium.com/v1/accounts/{address_hash}/token-transfer/mrc721
api-key: Your API Key

Request

Query Parameters

Parameter	Description
address_hash	type: String value: Address (sender/receiver/contract) or Transaction Address required: true
limit	type: Integer value: Maximum number of record will retrieve (Default: 50, Max: 1000) required: false
offset	type: Integer value: Start retrieve record (Default: 0) required: false
startBlock	type: String value: Start block (Default: null) required: false
endBlock	type: String value: End block (Default: null) required: false

Response

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "1",
        "data": [
            {
                "timestamp": "2019-12-13T19:02:39Z",
                "sender": "0x0000000000000000000000000000000000000000",
                "receiver": "0xbc557b421d6702d6206ecedd7e2fb7b8c3a47611",
                "confirmations": "39955328",
                "block_number": "4675503",
                "transaction_hash": "0x49bc8b60a3fb1b3ede5940eed1926eed9a9c2bc4b36275b921bf6f3140e63b3a",
                "block_hash": "0x6fd8aaf37112eeb8b908d912ab9887c8309687380fafc7578542cff6f0cad154",
                "token_address": "0xe70311a482c6675f4e4a49c1e36e4e4b658c3813",
                "token_name": "BC",
                "token_symbol": "",
                "token_decimals": null,
                "transaction_index": "0"
            }
        ]
    }
}

---

Get MRC20/MRC721 Token List for a Single Address

Returns the list of MRC-20/MRC-721 tokens held in a single address.

GET https://testnetapi.metadium.com/v1/accounts/{address_hash}/tokens
api-key: Your API Key

Request

Query Parameters

Parameter	Description
address_hash	type: String value: Address of token holder required: true
limit	type: Integer value: Maximum number of record will retrieve (Default: 50, Max: 1000) required: false
offset	type: Integer value: Start retrieve record (Default: 0) required: false

Response

//Response Sample Result
{
    "mrc_20": {
        "count": "1",
        "results": [
            {
                "balance": "509619999999999998500",
                "token_address": "0x62d1940f082e89a5f94d9a4d726545f1209657e4",
                "token_symbol": "TPL",
                "token_name": "The poll coin",
                "holder_address": "0xacb1ff4404cc500d9ed782fd7a040e0baa641650",
                "holder_type": "0",
                "token_decimals": "18"
            }
        ]
    },
    "mrc_721": {
        "count": "1",
        "results": [
            {
                "balance": "1",
                "token_address": "0xCB9df5F64456C20feA6729416337B0b782507Be3",
                "holder_address": "0xacb1ff4404cc500d9ed782fd7a040e0baa641650"
            }
        ]
    }
}

---

Get MRC20 Token List for a Single Address

Returns the list of MRC-20 tokens held in a single address.

GET https://testnetapi.metadium.com/v1/accounts/{address_hash}/tokens/mrc20
api-key: Your API Key

Request

Query Parameters

Parameter	Description
address_hash	type: String value: Address of token holder required: true
limit	type: Integer value: Maximum number of record will retrieve (Default: 50, Max: 1000) required: false
offset	type: Integer value: Start retrieve record (Default: 0) required: false

Response

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "1",
        "data": [
            {
                "token_address": "0x62d1940f082e89a5f94d9a4d726545f1209657e4",
                "token_name": "The poll coin",
                "token_symbol": "TPL"
            }
        ]
    }
}

---

Get MRC721 Token List for a Single Address

Returns the list of MRC-721 tokens held in a single address.

GET https://testnetapi.metadium.com/v1/accounts/{address_hash}/tokens/mrc721
api-key: Your API Key

Request

Query Parameters

Parameter	Description
address_hash	type: String value: Address of token holder required: true
limit	type: Integer value: Maximum number of record will retrieve (Default: 50, Max: 1000) required: false
offset	type: Integer value: Start retrieve record (Default: 0) required: false

Response

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "1",
        "data": [
            {
                "token_address": "0xcb9df5f64456c20fea6729416337b0b782507be3",
                "token_name": "복숭아",
                "token_symbol": ""
            }
        ]
    }
}

---

Get MRC721 Token Inventory of a Specific MRC721 Contract

Returns the MRC-721 token inventory of a specific MRC721 contract and a list of specific tokens owned.

GET https://testnetapi.metadium.com/v1/accounts/{contract_address}/tokens/inventory
api-key: Your API Key

Request

Query Parameters

Parameter	Description
contract_address	type: String value: Contract address requiring inventory list required: true
token_address	type: String value: Specific token address required: false
limit	type: Integer value: Maximum number of record will retrieve (Default: 50, Max: 1000) required: false
offset	type: Integer value: Start retrieve record (Default: 0) required: false

Response

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "1",
        "data": [
            {
                "contract_address": "0xcb9df5f64456c20fea6729416337b0b782507be3",
                "token_id": "165418202197237747081907",
                "token_uri": "",
                "token_name": "복숭아",
                "token_symbol": ""
            }
        ]
    }
}

---

Get list of Blocks Mined by address

Returns the list of blocks created by the miner.

GET https://testnetapi.metadium.com/v1/accounts/{address_hash}/mined-blocks
api-key: Your API Key

Request

Query Parameters

Parameter	Description
address_hash	type: String value: Address of miner required: true
limit	type: Integer value: Maximum number of record will retrieve (Default: 50, Max: 1000) required: false
offset	type: Integer value: Start retrieve record (Default: 0) required: false

Response

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "727802",
        "data": [
            {
                "timestamp": "2023-09-25T03:00:58Z",
                "miner": "0x378360d4f25e6377f3da53f8cf09e9a258118528",
                "reward": "0",
                "fees": "0",
                "block_number": "44631328",
                "gas_used": "0",
                "gas_limit": "268435456",
                "transaction_count": "0",
                "mining_reward": "0"
            },
            ...
        ]
    }
}