GET
/
1
/
market
/
token
/
holders
Get market token holders
curl --request GET \
  --url https://api.mobula.io/api/1/market/token/holders
{
  "data": [
    {
      "address": "<string>",
      "tag": "<string>",
      "amountRaw": "<string>",
      "amount": 123,
      "chainId": "<string>",
      "totalSupplyShare": 123,
      "amountUSD": 123
    }
  ],
  "total_count": 123
}

​
Query quick start

Input in “asset” the name of the asset you want to query, or the contract address while adding the blockchain as a second parameter. The market data asset query pattern is explained in great details here, with blockchain format, etc.

​
Response Details

The response includes detailed information about each token holder:

  • address: The wallet address of the holder
  • amountRaw: The raw token amount (before decimal adjustment)
  • amount: The formatted token amount
  • chainId: The blockchain identifier
  • totalSupplyShare: Percentage of total supply held by this address
  • amountUSD: USD value of the holdings
  • tag: Identifies the type of holder with labels such as:
    • dev: Developer/team wallet (token deployer address)
    • LP {SYMBOL0}/{SYMBOL1}: Liquidity pool addresses (e.g., “LP ETH/USDC”)
    • holder: Regular token holders

​
Usage Examples

# Get top holders for a token by contract address
GET /api/1/market/token/holders?asset=0x...&blockchain=1

# Get top holders for a token by name
GET /api/1/market/token/holders?asset=Bitcoin&limit=50

# Get holders with pagination
GET /api/1/market/token/holders?asset=Ethereum&limit=20&offset=20

Query Parameters

​
blockchain
string
​
asset
string
​
symbol
string
​
limit
number | null
default:20
Required range: x <= 100
​
offset
number | null
default:0

Response

200 - application/json

Market token holders response

The response is of type object.