Asset API

get_asset_holders(asset_id, start, limit)

Retrieve the information about the holders of the specified asset.

Parameters

Option

Description

asset_id_type asset_id

ID of the asset to retrieve, a string that look like 1.3.

uint32_t start

The acount id to start retrieving from

uint32_t limit

Limit to that much accounts (max 100)

Example

{
"id": 4,
"method": "call",
"params": [
ASSET_API_ID,
"get_asset_holders",
[
"1.3.0",
"10",
"3"
]
]
}

Returns

An array of information about asset holders, that has the following structure:

{
"id": 4,
"jsonrpc": "2.0",
"result": [
{
"name": "name1",
"account_id": "1.2.18",
"amount": "1551589041306"
},
{
"name": "name2",
"account_id": "1.2.468",
"amount": "1505000000000"
},
{
"name": "name3",
"account_id": "1.2.19",
"amount": "1009806000000"
}
]
}

get_asset_holders_count(asset_id)

Retrieve the number of holders of the provided asset.

Parameters

Option

Description

asset_id_type asset_id

ID of the asset to retrieve, a string that look like 1.3.

Example

{
"id": 4,
"method": "call",
"params": [
ASSET_API_ID,
"get_asset_holders_count",
[
"1.3.0"
]
]
}

Returns

Holders count for the specified asset.

{
"id": 4,
"jsonrpc": "2.0",
"result": 1357
}

get_all_asset_holders()

An array of all asset IDs with the number of holders.

Example

{
"id": 4,
"method": "call",
"params": [
ASSET_API_ID,
"get_all_asset_holders",
[]
]
}

Returns

An array of the following structure:

{
"id": 4,
"jsonrpc": "2.0",
"result": [
{
"asset_id": "1.3.0",
"count": 1357
},
{
"asset_id": "1.3.1",
"count": 19
},
{
"asset_id": "1.3.2",
"count": 1
}
]
}