Protocol API

Token Holders

Query holder information across different chains in the M0 ecosystem.

This guide explains how to query holder information across different chains in the M0 ecosystem. Each chain features M0-powered stablecoins that are included in the holders response.

Ethereum

Query current $M holders on Ethereum with their balances and accrued yields:

query MHoldersQuery {
  MHolders(first: 100) {
    address
    balance
    accruedYield
  }
}

The holders response includes the following M0-powered stablecoins:

  • $M (Wrapped) (WM) - 0x437cc33344a0b27a429f795ff6b469c72698b291
  • Metamask USD (mUSD) - 0xacA92E438df0B2401fF60dA7E4337B687a2435DA
  • Noble (USDN) - 0x83Ae82Bd4054e815fB7B189C39D9CE670369ea16
  • Usual (UsualM) - 0x4Cbc25559DbBD1272EC5B64c7b5F48a2405e6470

Arbitrum

Query current $M holders on Arbitrum with their balances and accrued yields:

query WMHoldersArbitrumQuery {
  WMHoldersArbitrum(first: 100) {
    address
    balance
    accruedYield
    claimedYield
    unclaimedYield
  }
}

The holders response includes the following M0-powered stablecoins:

  • USDai (USDai) - 0x83Ae82Bd4054e815fB7B189C39D9CE670369ea16

Hyperliquid

Query a specific $M holder on Hyperliquid:

query HyperliquidHolderQuery {
  hyperliquid_holder {
    address
    isEarning
    accruedYield
  }
}

The holders response includes the following M0-powered stablecoins:

  • USDhl (USDhl) - 0xb50A96253aBDF803D85efcDce07Ad8becBc52BD5

Linea

Query a specific $M holder on Linea:

query LineaHolderQuery {
  linea_holders {
    address
    isEarning
    accruedYield
  }
}

The holders response includes the following M0-powered stablecoins:

  • Metamask USD (mUSD) - 0xacA92E438df0B2401fF60dA7E4337B687a2435DA

Solana

Coming soon.

Copyright © M0 Foundation 2026