How to Build a Multi-Chain Wallet Tracker in 10 Minutes

npm install @mobula_labs/sdk

import { MobulaClient } from "@mobula_labs/sdk";

const client = new MobulaClient({
  apiKey: process.env.MOBULA_API_KEY,
});

async function getWalletPortfolio(address: string) {
  const { data } = await client.wallet.portfolio({
    wallet: address,
  });

  return data;
}

async function main() {
  const address = process.argv[2];
  if (!address) {
    console.error("Usage: ts-node tracker.ts <wallet-address>");
    process.exit(1);
  }

  console.log(`\nFetching portfolio for ${address}...\n`);

  const portfolio = await getWalletPortfolio(address);

  // Total portfolio value
  console.log(`Total Value: $${portfolio.total_wallet_balance.toFixed(2)}`);
  console.log(`24h PnL: $${portfolio.total_realized_pnl.toFixed(2)}\n`);

  // Top holdings
  console.log("Holdings:");
  console.log("─".repeat(60));

  const sorted = portfolio.assets
    .filter((a) => a.estimated_balance > 1)
    .sort((a, b) => b.estimated_balance - a.estimated_balance)
    .slice(0, 20);

  for (const asset of sorted) {
    const pnl = asset.realized_pnl ?? 0;
    const pnlStr = pnl >= 0 ? `+$${pnl.toFixed(2)}` : `-$${Math.abs(pnl).toFixed(2)}`;
    console.log(
      `${asset.asset.symbol.padEnd(12)} $${asset.estimated_balance.toFixed(2).padStart(12)}  ${pnlStr.padStart(12)}  ${asset.asset.blockchains?.[0] ?? "unknown"}`
    );
  }
}

main().catch(console.error);

MOBULA_API_KEY=your_key ts-node tracker.ts 0xYourWalletAddress

Fetching portfolio for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045...

Total Value: $4,821,334.12
24h PnL: +$142,891.44

Holdings:
────────────────────────────────────────────────────────────
ETH          $2,341,200.00    +$89,200.00   ethereum
USDC           $812,450.00          $0.00   base
ARB            $234,100.00    +$12,400.00   arbitrum
...

const history = await client.wallet.history({
  wallet: address,
  from: Date.now() - 30 * 24 * 60 * 60 * 1000, // 30 days
  to: Date.now(),
});

// history.data is an array of { timestamp, balance } points

import express from "express";
const app = express();

app.get("/portfolio/:address", async (req, res) => {
  const portfolio = await getWalletPortfolio(req.params.address);
  res.json(portfolio);
});

app.listen(3000);