Mobula API provides a convenient way to access wallet balances and asset distributions for EVM-compatible wallets. This guide details the steps to query wallet holdings.

​
What you’ll need

  1. Basic knowledge of RESTful APIs and JavaScript.
  2. An EVM-compatible wallet address.
  3. Optional: Preferences for specific blockchains, cache settings, and stale data handling.

​
Walkthrough

1

Prepare Your Query

Decide on the wallet address to query. You can also specify blockchains, cache options, and staleness parameters according to your needs.
2

Execute the API Call

Make the API call using cURL, Axios, or the Mobula SDK (Beta):Using cURL:
curl --location --request GET 'https://production-api.mobula.io/api/1/wallet/portfolio?wallet=0x77A89C51f106D6cD547542a3A83FE73cB4459135'
Using Axios:
import axios from "axios";
axios.get('https://production-api.mobula.io/api/1/wallet/portfolio?wallet=0x77A89C51f106D6cD547542a3A83FE73cB4459135')
.then(response => console.log(response.data))
.catch(error => console.log(error));
Using Mobula SDK (Beta):
import { Mobula } from "mobula-sdk";
const mobula = new Mobula("YOUR_API_KEY_HERE");
mobula.fetchWalletHoldings({
  wallet: "0x77A89C51f106D6cD547542a3A83FE73cB4459135",
  blockchains: "BLOCKCHAIN_NAMES", // Optional
  cache: true,                     // Optional
  stale: 300                        // Optional
})
.then(response => console.log(response))
.catch(error => console.log(error));
3

Review the Response

The API will return a comprehensive response including the wallet balance, individual asset details, and blockchain information.
{
"data": {
    "total_wallet_balance": 241.03441553241606,
    "wallet": "0x77A89C51f106D6cD547542a3A83FE73cB4459135",
    "assets": [
    {
        "asset": {
        "name": "StaySAFU",
        "symbol": "SAFU",
        "id": 3,
        "contracts": ["0x890cc7d14948478c98a6cd7f511e1f7f7f99f397"],
        "logo": "https://metacore.mobula.io/4ed4daf3f124fae650cfab146ae7348cdb62920bc25bf6408698654835192a1b.png"
        },
        "price": 2.5182506506214875,
        "estimated_balance": 0.19400291001132328,
        "token_balance": 0.077038761,
        "cross_chain_balances": {
        "BNB Smart Chain (BEP20)": {
            "address": "0x890cc7d14948478c98a6cd7f511e1f7f7f99f397",
            "balance": 0.077038761,
            "balanceRaw": "77038761",
            "chainId": 56
        }
        }
    },
    {
        "asset": {
        "name": "Mobula",
        "symbol": "MOBL",
        "id": 222,
        "contracts": [
            "0x33b3a50c766dd3e61b1e90b251390e7c28aefb7c",
            "0xae85d5aa526b1ecc5e90e466cbd2bdec22c606ff",
            "0x5fef39b578deeefa4485a7e5944c7691677d5dd4"
        ],
        "logo": "https://mobula.mypinata.cloud/ipfs/QmTn6CLSsURsMfEwQA4o5SwBJKjrHJrtuYcNKd14kdJ77o?pinataGatewayToken=WQn5Yv-xwpvoa6O4Kc6yMwL4kG-UCFSmo0FL2pcIRAdN-V8XYVaL7udtsC7R3_Nm"
        },
        "price": 0,
        "estimated_balance": 0,
        "token_balance": 7254.324894349606,
        "cross_chain_balances": {
        "BNB Smart Chain (BEP20)": {
            "address": "0x33b3a50c766dd3e61b1e90b251390e7c28aefb7c",
            "balance": 193,
            "balanceRaw": "193000000000000000000",
            "chainId": 56
        },
        "Polygon": {
            "address": "0x5fef39b578deeefa4485a7e5944c7691677d5dd4",
            "balance": 7061.324894349606,
            "balanceRaw": "7.061324894349606e+21",
            "chainId": 137
        }
        }
    }
    // ... other assets ...
    ]
}
}

​
Extending Your Insights

With the retrieved data, you can:
  • Analyze Asset Allocation: Gain insights into how assets are distributed across different blockchains.
  • Monitor Portfolio Performance: Track the total wallet balance and individual asset trends.
  • Develop Financial Applications: Integrate this data into financial management tools or investment analysis platforms.

​
Need Assistance?

Our support team is ready to help you with any questions or integration challenges.

Support

Telegram

Support

Slack

Support

Discord

Email Support

Email