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"
]
}
Query Parameters
type: List<String>
value: Address of account (min: 1, max: 20)
required: true
//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
Query Parameters
type: String
value: Address (sender/receiver/contract)
required: true
type: Integer
value: Maximum number of record will retrieve (Default: 50, Max: 1000)
required: false
type: Integer
value: Start retrieve record (Default: 0)
required: false
type: String
value: Start block (Default: null)
required: false
type: String
value: End block (Default: null)
required: false
type: Boolean
value: Include input data (true/false[Default])
required: false
type: Boolean
value: Include data simple (true/false[Default])
required: false
type: String
value: Address condition (all[Default]/to/from/contract)
required: false
//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 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
Query Parameters
type: String
value: Address (sender/receiver/contract)
required: true
type: Integer
value: Maximum number of record will retrieve (Default: 50, Max: 1000)
required: false
type: Integer
value: Start retrieve record (Default: 0)
required: false
type: String
value: Start block (Default: null)
required: false
type: String
value: End block (Default: null)
required: false
type: Boolean
value: Include input data (true/false[Default])
required: false
//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
Query Parameters
type: String
value: Address (sender/receiver/contract) or Transaction Address
required: true
type: Integer
value: Maximum number of record will retrieve (Default: 50, Max: 1000)
required: false
type: Integer
value: Start retrieve record (Default: 0)
required: false
type: String
value: Start block (Default: null)
required: false
type: String
value: End block (Default: null)
required: false
//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
Query Parameters
type: String
value: Address (sender/receiver/contract) or Transaction Address
required: true
type: Integer
value: Maximum number of record will retrieve (Default: 50, Max: 1000)
required: false
type: Integer
value: Start retrieve record (Default: 0)
required: false
type: String
value: Start block (Default: null)
required: false
type: String
value: End block (Default: null)
required: false
//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
Query Parameters
type: String
value: Address of token holder
required: true
type: Integer
value: Maximum number of record will retrieve (Default: 50, Max: 1000)
required: false
type: Integer
value: Start retrieve record (Default: 0)
required: false
//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
Query Parameters
type: String
value: Address of token holder
required: true
type: Integer
value: Maximum number of record will retrieve (Default: 50, Max: 1000)
required: false
type: Integer
value: Start retrieve record (Default: 0)
required: false
//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
Query Parameters
type: String
value: Address of token holder
required: true
type: Integer
value: Maximum number of record will retrieve (Default: 50, Max: 1000)
required: false
type: Integer
value: Start retrieve record (Default: 0)
required: false
//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
Query Parameters
type: String
value: Contract address requiring inventory list
required: true
type: String
value: Specific token address
required: false
type: Integer
value: Maximum number of record will retrieve (Default: 50, Max: 1000)
required: false
type: Integer
value: Start retrieve record (Default: 0)
required: false
//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
Query Parameters
type: String
value: Address of miner
required: true
type: Integer
value: Maximum number of record will retrieve (Default: 50, Max: 1000)
required: false
type: Integer
value: Start retrieve record (Default: 0)
required: false
//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"
},
...
]
}
}
