Skip to main content
GET
/
2
/
wallet
/
holdings
Get Wallet Holdings
curl --request GET \
  --url https://demo-api.mobula.io/api/2/wallet/holdings
{
  "data": {
    "totalWalletBalanceUsd": 123,
    "wallets": [
      "<string>"
    ],
    "holdings": [
      {
        "token": {
          "address": "<string>",
          "chainId": "<string>",
          "symbol": "<string>",
          "name": "<string>",
          "priceTokenString": "<string>",
          "approximateReserveTokenRaw": "<string>",
          "logo": "<string>",
          "bondedAt": "<string>",
          "createdAt": "<string>",
          "latestTradeDate": "<string>",
          "description": "<string>",
          "socials": {
            "twitter": "<string>",
            "website": "<string>",
            "telegram": "<string>",
            "others": {},
            "uri": "<string>"
          },
          "security": {
            "buyTax": "<string>",
            "sellTax": "<string>",
            "transferPausable": true,
            "top10Holders": "<string>",
            "isBlacklisted": true,
            "noMintAuthority": true,
            "isFreezable": true,
            "balanceMutable": true,
            "lowLiquidity": "<string>",
            "burnRate": "<string>",
            "liquidityBurnPercentage": 123,
            "transferTax": "<string>",
            "isHoneypot": true,
            "isNotOpenSource": true,
            "renounced": true,
            "locked": "<string>",
            "isWhitelisted": true,
            "isMintable": true,
            "modifyableTax": true,
            "selfDestruct": true
          },
          "liveStatus": "<string>",
          "liveThumbnail": "<string>",
          "livestreamTitle": "<string>",
          "liveReplyCount": 123,
          "decimals": 0,
          "id": null,
          "priceUSD": 0,
          "priceToken": 0,
          "approximateReserveUSD": 0,
          "approximateReserveToken": 0,
          "totalSupply": 0,
          "circulatingSupply": 0,
          "marketCapUSD": 0,
          "marketCapDilutedUSD": 0,
          "originLogoUrl": "<string>",
          "rank": null,
          "cexs": [],
          "exchange": {
            "name": "<string>",
            "logo": "<string>"
          },
          "factory": "<string>",
          "source": "<string>",
          "sourceFactory": "<string>",
          "sourceMetadata": {
            "name": "<string>",
            "logo": "<string>"
          },
          "sourceFactoryMetadata": {
            "name": "<string>",
            "logo": "<string>"
          },
          "liquidityUSD": 123,
          "liquidityMaxUSD": 123,
          "bonded": true,
          "bondingPercentage": 123,
          "migrating": true,
          "bondingCurveAddress": "<string>",
          "preBondingFactory": "<string>",
          "poolAddress": "<string>",
          "blockchain": "<string>",
          "type": "<string>",
          "deployer": "<string>",
          "athUSD": 123,
          "atlUSD": 123,
          "athDate": "<string>",
          "atlDate": "<string>",
          "priceChange1minPercentage": 0,
          "priceChange5minPercentage": 0,
          "priceChange1hPercentage": 0,
          "priceChange4hPercentage": 0,
          "priceChange6hPercentage": 0,
          "priceChange12hPercentage": 0,
          "priceChange24hPercentage": 0,
          "poolPriceChange1minPercentage": 0,
          "poolPriceChange5minPercentage": 0,
          "poolPriceChange1hPercentage": 0,
          "poolPriceChange4hPercentage": 0,
          "poolPriceChange6hPercentage": 0,
          "poolPriceChange12hPercentage": 0,
          "poolPriceChange24hPercentage": 0,
          "liquidityBurnPercentage": 123,
          "volume1minUSD": 0,
          "volume5minUSD": 0,
          "volume15minUSD": 0,
          "volume1hUSD": 0,
          "volume4hUSD": 0,
          "volume6hUSD": 0,
          "volume12hUSD": 0,
          "volume24hUSD": 0,
          "volumeBuy1minUSD": 0,
          "volumeBuy5minUSD": 0,
          "volumeBuy15minUSD": 0,
          "volumeBuy1hUSD": 0,
          "volumeBuy4hUSD": 0,
          "volumeBuy6hUSD": 0,
          "volumeBuy12hUSD": 0,
          "volumeBuy24hUSD": 0,
          "volumeSell1minUSD": 0,
          "volumeSell5minUSD": 0,
          "volumeSell15minUSD": 0,
          "volumeSell1hUSD": 0,
          "volumeSell4hUSD": 0,
          "volumeSell6hUSD": 0,
          "volumeSell12hUSD": 0,
          "volumeSell24hUSD": 0,
          "trades1min": 0,
          "trades5min": 0,
          "trades15min": 0,
          "trades1h": 0,
          "trades4h": 0,
          "trades6h": 0,
          "trades12h": 0,
          "trades24h": 0,
          "buys1min": 0,
          "buys5min": 0,
          "buys15min": 0,
          "buys1h": 0,
          "buys4h": 0,
          "buys6h": 0,
          "buys12h": 0,
          "buys24h": 0,
          "sells1min": 0,
          "sells5min": 0,
          "sells15min": 0,
          "sells1h": 0,
          "sells4h": 0,
          "sells6h": 0,
          "sells12h": 0,
          "sells24h": 0,
          "buyers1min": 0,
          "buyers5min": 0,
          "buyers15min": 0,
          "buyers1h": 0,
          "buyers4h": 0,
          "buyers6h": 0,
          "buyers12h": 0,
          "buyers24h": 0,
          "sellers1min": 0,
          "sellers5min": 0,
          "sellers15min": 0,
          "sellers1h": 0,
          "sellers4h": 0,
          "sellers6h": 0,
          "sellers12h": 0,
          "sellers24h": 0,
          "traders1min": 0,
          "traders5min": 0,
          "traders15min": 0,
          "traders1h": 0,
          "traders4h": 0,
          "traders6h": 0,
          "traders12h": 0,
          "traders24h": 0,
          "feesPaid1minUSD": 0,
          "feesPaid5minUSD": 0,
          "feesPaid15minUSD": 0,
          "feesPaid1hUSD": 0,
          "feesPaid4hUSD": 0,
          "feesPaid6hUSD": 0,
          "feesPaid12hUSD": 0,
          "feesPaid24hUSD": 0,
          "totalFeesPaidUSD": 0,
          "totalFeesPaidNativeRaw": "0",
          "organicTrades1min": 0,
          "organicTrades5min": 0,
          "organicTrades15min": 0,
          "organicTrades1h": 0,
          "organicTrades4h": 0,
          "organicTrades6h": 0,
          "organicTrades12h": 0,
          "organicTrades24h": 0,
          "organicTraders1min": 0,
          "organicTraders5min": 0,
          "organicTraders15min": 0,
          "organicTraders1h": 0,
          "organicTraders4h": 0,
          "organicTraders6h": 0,
          "organicTraders12h": 0,
          "organicTraders24h": 0,
          "organicVolume1minUSD": 0,
          "organicVolume5minUSD": 0,
          "organicVolume15minUSD": 0,
          "organicVolume1hUSD": 0,
          "organicVolume4hUSD": 0,
          "organicVolume6hUSD": 0,
          "organicVolume12hUSD": 0,
          "organicVolume24hUSD": 0,
          "organicVolumeBuy1minUSD": 0,
          "organicVolumeBuy5minUSD": 0,
          "organicVolumeBuy15minUSD": 0,
          "organicVolumeBuy1hUSD": 0,
          "organicVolumeBuy4hUSD": 0,
          "organicVolumeBuy6hUSD": 0,
          "organicVolumeBuy12hUSD": 0,
          "organicVolumeBuy24hUSD": 0,
          "organicVolumeSell1minUSD": 0,
          "organicVolumeSell5minUSD": 0,
          "organicVolumeSell15minUSD": 0,
          "organicVolumeSell1hUSD": 0,
          "organicVolumeSell4hUSD": 0,
          "organicVolumeSell6hUSD": 0,
          "organicVolumeSell12hUSD": 0,
          "organicVolumeSell24hUSD": 0,
          "organicBuys1min": 0,
          "organicBuys5min": 0,
          "organicBuys15min": 0,
          "organicBuys1h": 0,
          "organicBuys4h": 0,
          "organicBuys6h": 0,
          "organicBuys12h": 0,
          "organicBuys24h": 0,
          "organicSells1min": 0,
          "organicSells5min": 0,
          "organicSells15min": 0,
          "organicSells1h": 0,
          "organicSells4h": 0,
          "organicSells6h": 0,
          "organicSells12h": 0,
          "organicSells24h": 0,
          "organicBuyers1min": 0,
          "organicBuyers5min": 0,
          "organicBuyers15min": 0,
          "organicBuyers1h": 0,
          "organicBuyers4h": 0,
          "organicBuyers6h": 0,
          "organicBuyers12h": 0,
          "organicBuyers24h": 0,
          "organicSellers1min": 0,
          "organicSellers5min": 0,
          "organicSellers15min": 0,
          "organicSellers1h": 0,
          "organicSellers4h": 0,
          "organicSellers6h": 0,
          "organicSellers12h": 0,
          "organicSellers24h": 0,
          "holdersCount": 123,
          "twitterReusesCount": 0,
          "twitterRenameCount": 0,
          "twitterRenameHistory": [],
          "deployerMigrationsCount": 0,
          "deployerTokensCount": 0,
          "securityScore": null,
          "securityScoreUpdatedAt": null,
          "dexscreenerListed": false,
          "dexscreenerHeader": null,
          "dexscreenerAdPaid": false,
          "dexscreenerAdPaidDate": null,
          "dexScreenerEnhanced": null,
          "dexscreenerPendingAt": null,
          "dexscreenerSocialPaid": false,
          "dexscreenerSocialPaidDate": null,
          "dexscreenerBoosted": false,
          "dexscreenerBoostedDate": null,
          "dexscreenerBoostedAmount": 0,
          "trendingScore1min": 0,
          "trendingScore5min": 0,
          "trendingScore15min": 0,
          "trendingScore1h": 0,
          "trendingScore4h": 0,
          "trendingScore6h": 0,
          "trendingScore12h": 0,
          "trendingScore24h": 0,
          "surgeScore": null,
          "isMayhemMode": null,
          "isCashbackCoin": null,
          "isAgentMode": null,
          "isOGCoin": null,
          "top10HoldingsPercentage": 123,
          "top50HoldingsPercentage": 123,
          "top100HoldingsPercentage": 123,
          "top200HoldingsPercentage": 123,
          "devHoldingsPercentage": 123,
          "insidersHoldingsPercentage": 123,
          "bundlersHoldingsPercentage": 123,
          "snipersHoldingsPercentage": 123,
          "proTradersHoldingsPercentage": 123,
          "freshTradersHoldingsPercentage": 123,
          "smartTradersHoldingsPercentage": 123,
          "insidersCount": 123,
          "bundlersCount": 123,
          "snipersCount": 123,
          "freshTradersCount": 123,
          "proTradersCount": 123,
          "smartTradersCount": 123,
          "freshTradersBuys": 123,
          "proTradersBuys": 123,
          "smartTradersBuys": 123
        },
        "amount": 123,
        "amountUsd": 123,
        "allocation": 123,
        "priceUsd": 123,
        "priceChange24h": 123,
        "liquidityUsd": 123,
        "marketCapUsd": 123,
        "crossChainBalances": {},
        "contractBalances": [
          {
            "chainId": "<string>",
            "address": "<string>",
            "amount": 123,
            "amountRaw": "<string>",
            "decimals": 123,
            "amountUsd": 123,
            "liquidityUsd": 123,
            "priceUsd": 123,
            "security": {
              "buyTax": "<string>",
              "sellTax": "<string>",
              "transferPausable": true,
              "top10Holders": "<string>",
              "isBlacklisted": true,
              "noMintAuthority": true,
              "isFreezable": true,
              "balanceMutable": true,
              "lowLiquidity": "<string>",
              "burnRate": "<string>",
              "liquidityBurnPercentage": 123,
              "transferTax": "<string>",
              "isHoneypot": true,
              "isNotOpenSource": true,
              "renounced": true,
              "locked": "<string>",
              "isWhitelisted": true,
              "isMintable": true,
              "modifyableTax": true,
              "selfDestruct": true,
              "frozen": true
            },
            "lamports": "<string>",
            "tokenAccount": "<string>"
          }
        ],
        "wallets": [
          "<string>"
        ]
      }
    ],
    "holdingsCount": 123,
    "balancesLength": 123
  }
}

Query Parameters

wallet

Wallet address

wallets

Comma-separated wallet addresses

portfolio

Portfolio ID

blockchains

Comma-separated blockchain IDs

asset

Filter by specific asset

from

Start date

to

End date

portfolio_settings

Portfolio display settings

unlistedAssets

Include unlisted assets

period

Time period

accuracy

Data accuracy level

testnet

Include testnet data

minLiquidity

Minimum liquidity threshold in USD

filterSpam

Filter spam tokens

pnl

Include PnL data

rpc

Response

200 - application/json

Wallet holdings response

data
object
required
backfillStatus
enum<string>
Available options:
processed,
processing,
pending