Skip to main content
GET
/
erc20
/
{token_address}
/
owners
Get ERC20 token owners by contract
curl --request GET \
  --url https://deep-index.moralis.io/api/v2.2/erc20/{token_address}/owners \
  --header 'X-API-Key: <api-key>'
{
  "result": [
    {
      "owner_address": "0x244...",
      "owner_address_label": "Coinbase 1",
      "balance": "57888888888888888888880",
      "balance_formatted": "5.78",
      "usd_value": "57888888888888888888880",
      "is_contract": true,
      "percentage_relative_to_total_supply": 10,
      "entity": "Opensea",
      "entity_logo": "https://opensea.io/favicon.ico"
    }
  ],
  "page": "2",
  "page_size": "100",
  "cursor": "<string>",
  "total_supply": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.moralis.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
default:test
required

Path Parameters

​
token_address
string
required

The address of the token contract

Example:

"0x6982508145454ce325ddbe47a25d4ec3d2311933"

Query Parameters

​
chain
enum<string>
default:eth

The chain to query

Available options:
eth,
0x1,
sepolia,
0xaa36a7,
polygon,
0x89,
bsc,
0x38,
bsc testnet,
0x61,
avalanche,
0xa86a,
fantom,
0xfa,
cronos,
0x19,
arbitrum,
0xa4b1,
chiliz,
0x15b38,
chiliz testnet,
0x15b32,
gnosis,
0x64,
gnosis testnet,
0x27d8,
base,
0x2105,
base sepolia,
0x14a34,
optimism,
0xa,
polygon amoy,
0x13882,
linea,
0xe708,
moonbeam,
0x504,
moonriver,
0x505,
moonbase,
0x507,
linea sepolia,
0xe705,
flow,
0x2eb,
flow-testnet,
0x221,
ronin,
0x7e4,
ronin-testnet,
0x31769,
lisk,
0x46f,
lisk-sepolia,
0x106a,
pulse,
0x171,
sei-testnet,
0x530,
sei,
0x531,
monad,
0x8f
Example:

"eth"

​
limit
integer

The desired page size of the result.

Required range: x >= 0
​
cursor
string

The cursor returned in the previous response (used for getting the next page).

​
order
enum<string>
default:DESC

The order of the result, in ascending (ASC) or descending (DESC)

Available options:
ASC,
DESC
Example:

"DESC"

Response

200 - application/json

Returns a collection of owners of an ERC20 token

​
result
object[]
required
​
page
integer

The current page of the result

Example:

"2"

​
page_size
integer

The number of results per page

Example:

"100"

​
cursor
string

The cursor to get to the next page

​
total_supply
string

The total supply of the token