> For the complete documentation index, see [llms.txt](https://docs.metadium.com/en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.metadium.com/en/api-reference/explorer-api/accounts.md).

# Accounts

### Get Metadium Balance for a Single Address <a href="#balance" id="balance"></a>

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"
    ]
}
```

{% tabs %}
{% tab title="Request" %}
Query Parameters

<table data-header-hidden><thead><tr><th width="209"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Description</strong></td></tr><tr><td><em>addresses</em></td><td><p>type: List&#x3C;String></p><p>value: Address of account (min: 1, max: 20)</p><p>required: true</p></td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

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

{% endtab %}
{% endtabs %}

***

### Get a list of 'Normal' Transactions by Address. <a href="#transaction-list" id="transaction-list"></a>

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
```

{% tabs %}
{% tab title="Request" %}
Query Parameters

<table data-header-hidden><thead><tr><th width="209"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Description</strong></td></tr><tr><td><em>address_hash</em></td><td><p>type: String</p><p>value: Address (sender/receiver/contract)</p><p>required: true</p></td></tr><tr><td><em>limit</em></td><td><p>type: Integer</p><p>value: Maximum number of record will retrieve (Default: 50, Max: 1000)</p><p>required: false</p></td></tr><tr><td><em>offset</em></td><td><p>type: Integer</p><p>value: Start retrieve record (Default: 0)</p><p>required: false</p></td></tr><tr><td><em>startBlock</em></td><td><p>type: String</p><p>value: Start block (Default: null)</p><p>required: false</p></td></tr><tr><td><em>endBlock</em></td><td><p>type: String</p><p>value: End block (Default: null)</p><p>required: false</p></td></tr><tr><td><em>input</em></td><td><p>type: Boolean</p><p>value: Include input data (true/false[Default])</p><p>required: false</p></td></tr><tr><td><em>simple</em></td><td><p>type: Boolean</p><p>value: Include data simple (true/false[Default])</p><p>required: false</p></td></tr><tr><td><em>condition</em></td><td><p>type: String</p><p>value: Address condition (all[Default]/to/from/contract)</p><p>required: false</p></td></tr></tbody></table>
{% endtab %}

{% tab title="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"
            },
            ...
        ]
    }
}
```

{% endtab %}

{% tab title="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"
    }
}
```

{% endtab %}
{% endtabs %}

***

### Get a list of 'Internal' Transactions by Address <a href="#internal-transaction-list" id="internal-transaction-list"></a>

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
```

{% tabs %}
{% tab title="Request" %}
Query Parameters

<table data-header-hidden><thead><tr><th width="209"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Description</strong></td></tr><tr><td><em>address_hash</em></td><td><p>type: String</p><p>value: Address (sender/receiver/contract)</p><p>required: true</p></td></tr><tr><td><em>limit</em></td><td><p>type: Integer</p><p>value: Maximum number of record will retrieve (Default: 50, Max: 1000)</p><p>required: false</p></td></tr><tr><td><em>offset</em></td><td><p>type: Integer</p><p>value: Start retrieve record (Default: 0)</p><p>required: false</p></td></tr><tr><td><em>startBlock</em></td><td><p>type: String</p><p>value: Start block (Default: null)</p><p>required: false</p></td></tr><tr><td><em>endBlock</em></td><td><p>type: String</p><p>value: End block (Default: null)</p><p>required: false</p></td></tr><tr><td><em>input</em></td><td><p>type: Boolean</p><p>value: Include input data (true/false[Default])</p><p>required: false</p></td></tr></tbody></table>
{% endtab %}

{% tab title="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
            },
            ...
        ]
    }
}
```

{% endtab %}
{% endtabs %}

***

### Get a list of 'MRC20 - Token Transfer Events' by Address <a href="#mrc20-token-transfer-events" id="mrc20-token-transfer-events"></a>

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
```

{% tabs %}
{% tab title="Request" %}
Query Parameters

<table data-header-hidden><thead><tr><th width="209"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Description</strong></td></tr><tr><td><em>address_hash</em></td><td><p>type: String</p><p>value: Address (sender/receiver/contract)</p><p>required: true</p></td></tr><tr><td><em>limit</em></td><td><p>type: Integer</p><p>value: Maximum number of record will retrieve (Default: 50, Max: 1000)</p><p>required: false</p></td></tr><tr><td><em>offset</em></td><td><p>type: Integer</p><p>value: Start retrieve record (Default: 0)</p><p>required: false</p></td></tr><tr><td><em>startBlock</em></td><td><p>type: String</p><p>value: Start block (Default: null)</p><p>required: false</p></td></tr><tr><td><em>endBlock</em></td><td><p>type: String</p><p>value: End block (Default: null)</p><p>required: false</p></td></tr></tbody></table>
{% endtab %}

{% tab title="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"
            },
            ...
        ]
    }
}
```

{% endtab %}
{% endtabs %}

***

### Get a list of 'MRC721 - Token Transfer Events' by Address <a href="#mrc721-token-transfer-events" id="mrc721-token-transfer-events"></a>

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
```

{% tabs %}
{% tab title="Request" %}
Query Parameters

<table data-header-hidden><thead><tr><th width="209"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Description</strong></td></tr><tr><td><em>address_hash</em></td><td><p>type: String</p><p>value: Address (sender/receiver/contract)</p><p>required: true</p></td></tr><tr><td><em>limit</em></td><td><p>type: Integer</p><p>value: Maximum number of record will retrieve (Default: 50, Max: 1000)</p><p>required: false</p></td></tr><tr><td><em>offset</em></td><td><p>type: Integer</p><p>value: Start retrieve record (Default: 0)</p><p>required: false</p></td></tr><tr><td><em>startBlock</em></td><td><p>type: String</p><p>value: Start block (Default: null)</p><p>required: false</p></td></tr><tr><td><em>endBlock</em></td><td><p>type: String</p><p>value: End block (Default: null)</p><p>required: false</p></td></tr></tbody></table>
{% endtab %}

{% tab title="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"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

***

### Get MRC20/MRC721 Token List for a Single Address <a href="#token-list" id="token-list"></a>

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
```

{% tabs %}
{% tab title="Request" %}
Query Parameters

<table data-header-hidden><thead><tr><th width="209"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Description</strong></td></tr><tr><td><em>address_hash</em></td><td><p>type: String</p><p>value: Address of token holder</p><p>required: true</p></td></tr><tr><td><em>limit</em></td><td><p>type: Integer</p><p>value: Maximum number of record will retrieve (Default: 50, Max: 1000)</p><p>required: false</p></td></tr><tr><td><em>offset</em></td><td><p>type: Integer</p><p>value: Start retrieve record (Default: 0)</p><p>required: false</p></td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

<pre><code>//Response Sample Result
<strong>{
</strong>    "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"
            }
        ]
    }
}
</code></pre>

{% endtab %}
{% endtabs %}

***

### Get MRC20 Token List for a Single Address <a href="#mrc20-token-list" id="mrc20-token-list"></a>

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
```

{% tabs %}
{% tab title="Request" %}
Query Parameters

<table data-header-hidden><thead><tr><th width="209"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Description</strong></td></tr><tr><td><em>address_hash</em></td><td><p>type: String</p><p>value: Address of token holder</p><p>required: true</p></td></tr><tr><td><em>limit</em></td><td><p>type: Integer</p><p>value: Maximum number of record will retrieve (Default: 50, Max: 1000)</p><p>required: false</p></td></tr><tr><td><em>offset</em></td><td><p>type: Integer</p><p>value: Start retrieve record (Default: 0)</p><p>required: false</p></td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

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

{% endtab %}
{% endtabs %}

***

### Get MRC721 Token List for a Single Address <a href="#mrc721-token-list" id="mrc721-token-list"></a>

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
```

{% tabs %}
{% tab title="Request" %}
Query Parameters

<table data-header-hidden><thead><tr><th width="209"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Description</strong></td></tr><tr><td><em>address_hash</em></td><td><p>type: String</p><p>value: Address of token holder</p><p>required: true</p></td></tr><tr><td><em>limit</em></td><td><p>type: Integer</p><p>value: Maximum number of record will retrieve (Default: 50, Max: 1000)</p><p>required: false</p></td></tr><tr><td><em>offset</em></td><td><p>type: Integer</p><p>value: Start retrieve record (Default: 0)</p><p>required: false</p></td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

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

{% endtab %}
{% endtabs %}

***

### Get MRC721 Token Inventory of a Specific MRC721 Contract <a href="#token-inventory" id="token-inventory"></a>

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
```

{% tabs %}
{% tab title="Request" %}
Query Parameters

<table data-header-hidden><thead><tr><th width="209"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Description</strong></td></tr><tr><td><em>contract_address</em></td><td><p>type: String</p><p>value: Contract address requiring inventory list</p><p>required: true</p></td></tr><tr><td><em>token_address</em></td><td><p>type: String</p><p>value: Specific token address</p><p>required: false</p></td></tr><tr><td><em>limit</em></td><td><p>type: Integer</p><p>value: Maximum number of record will retrieve (Default: 50, Max: 1000)</p><p>required: false</p></td></tr><tr><td><em>offset</em></td><td><p>type: Integer</p><p>value: Start retrieve record (Default: 0)</p><p>required: false</p></td></tr></tbody></table>
{% endtab %}

{% tab title="Response" %}

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

{% endtab %}
{% endtabs %}

***

### Get list of Blocks Mined by address <a href="#block-mined-list" id="block-mined-list"></a>

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
```

{% tabs %}
{% tab title="Request" %}
Query Parameters

<table data-header-hidden><thead><tr><th width="209"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Description</strong></td></tr><tr><td><em>address_hash</em></td><td><p>type: String</p><p>value: Address of miner</p><p>required: true</p></td></tr><tr><td><em>limit</em></td><td><p>type: Integer</p><p>value: Maximum number of record will retrieve (Default: 50, Max: 1000)</p><p>required: false</p></td></tr><tr><td><em>offset</em></td><td><p>type: Integer</p><p>value: Start retrieve record (Default: 0)</p><p>required: false</p></td></tr></tbody></table>
{% endtab %}

{% tab title="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"
            },
            ...
        ]
    }
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.metadium.com/en/api-reference/explorer-api/accounts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.