Daily Yields

This guide outlines how to retrieve daily yield accrual data for various stablecoins using our GraphQL API. Depending on the stablecoin, yield values can be queried as aggregated data for specific stablecoins or for individual holders.

Aggregated Yield Data by Stablecoin

For most of our stablecoins, we provide aggregated yield and supply data per chain. This includes chain-specific queries with a prefix for other stablecoins.

The snippets below use Metamask USD (mUSD) as an example. You can find all supported stablecoins and chain prefixes below

Aggregated data

# Fetches aggregated data for mUSD on Mainnet, Linea, and BSC
query GetMusdStablecoin {
  mainnet: musd_mainnet_stablecoins {
    id
    claimed
    minted
    accruedYield
    supply
    lastUpdate
  }
  linea: musd_linea_stablecoins {
    id
    claimed
    minted
    accruedYield
    supply
    lastUpdate
  }
  bsc: musd_bsc_stablecoins {
    id
    claimed
    minted
    accruedYield
    supply
    lastUpdate
  }
}

You can also get daily snapshots for yield and supply for these stablecoins.

Daily Yield Snapshots

# Fetches daily yield snapshots for mUSD on Mainnet
query GetMusdDailyYields {
  musd_mainnet_yieldStats_collection(interval: day) {
    id
    timestamp
    amount
    blockNumber
  }
}

Daily Supply Snapshots

# Fetches daily supply snapshots for mUSD on Mainnet
query GetMusdDailySupply {
  musd_mainnet_supplyStats_collection(interval: day) {
    id
    timestamp
    amount
    blockNumber
  }
}

Supported Stablecoins and Prefixes

The following table lists the stablecoins that support prefixed queries and the corresponding prefixes for each chain.

Stablecoin	Ticker	Prefixes
USDhl	USDHL	`usdhl_hyperevm_`
Braid Dollar	USDZ	`usdz_mainnet_`, `usdz_arbitrum_`
Dfns Rewards	0fns	`dfns_mainnet_`
Startale USD	USDSC	`usdsc_soneium_`
MANTRA USD	mantraUSD	`mantrausd_mantra_`
Metamask USD	mUSD	`musd_mainnet_`, `musd_linea_`, `musd_binance_`
Daylight USD	GRID	`grid_plasma_`

Yield Snapshots for Individual Holders

For stablecoins like Noble Dollar (USDN), Wrapped M ($wM), Usual (UsualM), and USDai, you can get daily snapshots of accrued yield for a specific holder address.

For Noble Dollar (USDN)

This query returns daily snapshots of accrued yield for a given USDN holder. You can specify a starting date with the from parameter. If from is omitted, it defaults to the last 30 days.

# Fetches daily yield snapshots for a USDN holder
query UsdnYieldSnapshots($address: String!, $from: String) {
  MHolderSnapshots(address: $address, from: $from) {
    balance
    accruedYield
    timestamp
    principal
  }
}

Example: Get accrued yield snapshots for a USDN holder since April 1st, 2025.

{
  "address": "0x83Ae82Bd4054e815fB7B189C39D9CE670369ea16",
  "from": "2025-04-01"
}

To get only the current values for USDN holders, you can use the MHolders query.

# Fetches current yield values for the top 100 USDN holders
query GetUsdnHolders {
  MHolders(first: 100) {
    address
    balance
    accruedYield
  }
}

For Wrapped M ($wM) / Usual (UsualM)

This query returns daily snapshots of accrued yield for a given wM holder. Like the previous query, it supports the from parameter and defaults to the last 30 days if omitted.

# Fetches daily yield snapshots for a wM holder
query WmYieldSnapshots($address: String!, $from: String) {
  WMHolderSnapshots(address: $address, from: $from) {
    balance
    accruedYield
    timestamp
    principal
  }
}

Example: Get accrued yield snapshots for a wM holder since April 1st, 2025.

{
  "address": "0x4Cbc25559DbBD1272EC5B64c7b5F48a2405e6470",
  "from": "2025-04-01"
}

For USDai on Arbitrum

This query retrieves current yield values for USDai holders on Arbitrum.

# Fetches current yield values for USDai holders on Arbitrum
query GetUsdaiArbitrumData {
  WMHoldersArbitrum {
    address
    balance
    accruedYield
    claimedYield
    unclaimedYield
  }
}