Tokens

Get MRC20-Token Total Supply by Contract's Address

Returns the total MRC20 token supply of the contract's address.

GET https://testnetapi.metadium.com/v1/tokens/{contract_hash/total-supply
api-key: Your API Key

Request

Query Parameters

Parameter	Description
contract_hash	type: String value: Address of contract required: true

Response

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "data": {
            "total_supply": "100000000000000000000000000"
        }
    }
}

---

Get MRC20-Token Account Balance

Returns the balance of the MRC20 token account.

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

Request

Query Parameters

Parameter	Description
contract_hash	type: String value: Address of contract required: true
address_hash	type: String value: Address (sender/receiver/contract) required: true

Response

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "data": {
            "balance": "461538000000000"
        }
    }
}

---

Get MRC-721 Token Held by Holder Inventory

Returns the list of MRC721 held by the holder.

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

Request

Query Parameters

Parameter	Description
contract_hash	type: String value: Address of contract required: true
address_hash	type: String value: Address (sender/receiver/contract) required: true

Response

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "1",
        "data": [
            {
                "holder_address": "0xcf48564c80a7dd2f4c76ea24f83d35f072bb6481",
                "token_id": "216075950392623962897824347046195959403",
                "token_uri": ""
            }
        ],
        "token_name": "save the earth",
        "token_symbol": null
    }
}

{
    "status": "200",
    "message": "success",
    "results": {
        "count": "1",
        "data": [
            {
                "holder_address": "0xcf48564c80a7dd2f4c76ea24f83d35f072bb6481",
                "token_id": "216075950392623962897824347046195959403",
                "token_uri": ""
            }
        ],
        "token_name": "save the earth",
        "token_symbol": null
    }
}

---

Token Holder count lookup

Returns the number of holders holding the token.

GET https://testnetapi.metadium.com/v1/tokens/{contract_hash}/holder-count
api-key: Your API Key

Request

Query Parameters

Parameter	Description
contract_hash	type: String value: Address of contract required: true

Response

//Response Sample Result
{
    "status": "200",
    "message": "success",
    "results": {
        "data": {
            "holder_count": "1"
        }
    }
}