Console

POSTGet Token Accounts by Asset Type

Data APIhttps://web3.nodit.io/v1/aptos/mainnet/token/getTokenAccountsByAssetType

Retrieves the list of accounts holding a specific asset type.

Path Parameters
chainstring (enum)required

Parameter to specify the target chain for the query.

networkstring (enum)required

Parameter to specify the network of the target chain. Supported networks may vary depending on the chain.

Request Body
assetTypestring

Parameter specifying the asset type to query. The asset type must be entered as a 64-character hexadecimal string (including "0x") using one of the following formats:

  • Coin: Asset ID in Struct format such as "0x1::aptos_coin::AptosCoin"
  • Fungible Asset: Object address that owns the Token Metadata
linkedAssetTypestring

Common identifier for querying Coin and FA (Fungible Asset) as a single asset unit.

linkedAssetType must contain the Object address of the migrated FA, entered in 64-character hexadecimal format (including "0x").

pageinteger

The page parameter specifies the data page to query. It accepts values up to 100; for pages exceeding 100, use the cursor pagination method.

The page and cursor parameters cannot be used together. If both page and cursor are empty, cursor pagination is used.

rppinteger

rpp stands for results per page and specifies the page size. You can specify a number greater than 0 and up to 100.

cursorstring

The cursor parameter supports pagination and data navigation between pages. Provide the cursor value from the previous page in the next request to load the next page of data.

The page and cursor parameters cannot be used together. If both page and cursor are empty, cursor pagination is used.

withCountboolean

Parameter specifying whether to include the count field in the response. The count field indicates the total number of requested data items. When set to true, the count field is included and response speed may be slower.

Responses
pageinteger

Field representing the page number specified in the page parameter. This field is only included in the response when a value greater than 0 is specified for the page parameter.

rppinteger

Field representing the number of results per page specified in the rpp parameter.

cursorstring

A field for cursor pagination. This value must be provided in the next request to load the next page of data.

countinteger

Field representing the total count of requested data. This field is only included in the response when true is set for the withCount parameter.

ownerAddressstringrequired

A field that represents the address of the account holding the asset. Provided as a 64-character hexadecimal string prefixed with 0x; identifies the actual owner of the asset. For Coin: the holding account address; for Fungible Asset: the Object owner's address.

예: 0x948592877d14d0fde0a42e2fc15a56959f30ea35d0b87c7ee8e98e0cce756f1a

objectAddressstringrequired

A field that represents the address of the Object where the asset is stored. Provided depending on storage location:

  • Coin: empty string ("") as it is stored directly in the account
  • Fungible Asset: Object address where the token is stored (64-character hexadecimal string prefixed with 0x)

예: 0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b

valuestringrequired

A field that represents the quantity of the held asset. Provided as a string in integer form; decimals are not included. The asset's decimals must be considered when calculating the actual value.

예: 1000000

isFrozenbooleanrequired

A field that indicates whether the asset can be transferred. true means the asset is frozen and cannot be transferred. Used to check the transfer restriction status of the asset.

예: false

isPrimarybooleanrequired

A field that indicates whether this Object is the representative Object for the Owner address. true means this Object is the representative Object for the Owner address.

예: true

assetTypestringrequired

A field that represents the unique identifier of the asset. Provided in one of two formats:

  • Coin: Asset ID in Move struct format (e.g., 0x1::aptos_coin::AptosCoin)
  • Fungible Asset: Object address that owns the metadata of the asset

예: 0x1::aptos_coin::AptosCoin

tokenStandardstringrequired

A field that represents the standard the asset follows.

  • v1: Assets following the Coin standard
  • v2: Assets following the Fungible Asset standard

예: v1

linkedAssetTypestringrequired

A common identifier that links Coin and Fungible Asset when they have been migrated. This field serves as a unified key that groups Coin/Fungible Asset into a single asset unit for identification and retrieval, providing the Object address where the migrated Fungible Asset's Metadata is stored.

예: 0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b

X-API-KEY
RequestCU150
cURL
curl -X POST "https://web3.nodit.io/v1/aptos/mainnet/token/getTokenAccountsByAssetType" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "assetType": "0x1::aptos_coin::AptosCoin",
  "linkedAssetType": "0x000000000000000000000000000000000000000000000000000000000000000a",
  "page": 1,
  "rpp": 10
}'
Response
Example · 200
{
  "page": 0,
  "rpp": 0,
  "cursor": "string",
  "count": 0,
  "items": [
    {
      "ownerAddress": "0x948592877d14d0fde0a42e2fc15a56959f30ea35d0b87c7ee8e98e0cce756f1a",
      "objectAddress": "0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b",
      "value": "1000000",
      "isFrozen": false,
      "isPrimary": true,
      "assetType": "0x1::aptos_coin::AptosCoin",
      "tokenStandard": "v1",
      "linkedAssetType": "0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b"
    }
  ]
}

Last updated