List token balances for an account (v2)

Polkadot

https://polkadot.api.subscan.io

POST

/api/v2/scan/account/tokens

Last modified:2026-10-20 11:28:04

x-synonyms:["account","token","tokens","wallet","address","asset","coin","balance","balances","token balance","token balances","holdings","portfolio","wallet assets"]

Returns paginated token holdings for one account address, including the native token, built-in assets, and EVM tokens such as ERC-20 and ERC-721 when available on the current network. Use token_type to narrow the token source or class, order_field and order to sort by token, balance, price, or supply, and page/row for pagination (max row 100). This is the primary endpoint for wallet token balances, account asset holdings, and token portfolio lookups.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Account token balancesSort token balances

Return a small page of indexed token balances.

{
    "address": "1jENPtb7x5uaRyKjZ1AtsfZr6MwDhbTNRxFyu8EBf4dQ63T",
    "row": 2,
    "page": 0
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Account token balancesSort token balances

curl --location 'https://polkadot.api.subscan.io/api/v2/scan/account/tokens' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "address": "1jENPtb7x5uaRyKjZ1AtsfZr6MwDhbTNRxFyu8EBf4dQ63T",
    "row": 2,
    "page": 0
}'

Responses

🟢200

application/json

Bodyapplication/json

Examples

Account token balancesSort token balances

{
    "code": 0,
    "message": "Success",
    "generated_at": 1792494070,
    "data": {
        "count": 1,
        "list": [
            {
                "symbol": "DOT",
                "unique_id": "DOT",
                "decimals": 10,
                "balance": "121474220372",
                "lock": "0",
                "reserved": "0",
                "bonded": "0",
                "unbonding": "0",
                "democracy_lock": "0",
                "conviction_lock": "0",
                "election_lock": "0",
                "label": null,
                "price": "1.13",
                "supply": "13.726586902036",
                "category": "Native"
            }
        ],
        "module": [
            "Native"
        ]
    }
}

Modified at 2026-10-20 11:28:04

List token holders

List accounts