> ## Documentation Index
> Fetch the complete documentation index at: https://base-a060aa97-fix-dead-service-links.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Check Balance & Portfolio

> View your token balances, portfolio value, and wallet details using Base MCP

export const DataFetchingDemo = () => {
  const sans = "ui-sans-serif,system-ui,-apple-system,'Segoe UI',Roboto,sans-serif";
  const serif = "'Tiempos Headline','Iowan Old Style','Source Serif Pro',ui-serif,Georgia,serif";
  const mono = "ui-monospace,'SF Mono','Cascadia Code',Menlo,Monaco,Consolas,monospace";
  const c = {
    bg: "#1f1e1d",
    header: "#262624",
    border: "#34322f",
    inputBg: "#2a2926",
    text: "#f5f4ed",
    body: "#e8e4dc",
    muted: "#a8a39d",
    dim: "#6b6663",
    accent: "#D97757",
    bubble: "#2c2b28",
    bubbleText: "#f5f4ed",
    code: "#e89972",
    codeBg: "rgba(217,119,87,0.12)",
    toolBg: "#272622",
    toolBorder: "#3a3835",
    success: "#a3c585"
  };
  const examples = [{
    prompt: "What's my balance on Base?",
    events: [{
      delay: 380,
      type: "thinking"
    }, {
      delay: 550,
      type: "tool",
      tool: {
        server: "base-mcp",
        action: "get_portfolio",
        args: {
          chain: "base"
        }
      }
    }, {
      delay: 600,
      type: "text",
      text: "Your current portfolio on Base:"
    }, {
      delay: 250,
      type: "rows",
      rows: [{
        token: "USDC",
        amount: "245.80",
        value: "$245.80"
      }, {
        token: "ETH",
        amount: "0.0412",
        value: "$148.33"
      }, {
        token: "WETH",
        amount: "0.0100",
        value: "$36.02"
      }]
    }, {
      delay: 400,
      type: "confirm",
      text: "Total: $430.15 on Base"
    }]
  }, {
    prompt: "What tokens do I have in my wallet?",
    events: [{
      delay: 380,
      type: "thinking"
    }, {
      delay: 550,
      type: "tool",
      tool: {
        server: "base-mcp",
        action: "get_wallets",
        args: {}
      }
    }, {
      delay: 600,
      type: "tool",
      tool: {
        server: "base-mcp",
        action: "get_portfolio",
        args: {
          chain: "base"
        }
      }
    }, {
      delay: 500,
      type: "text",
      text: "Tokens in your wallet on Base:"
    }, {
      delay: 250,
      type: "rows",
      rows: [{
        token: "USDC",
        amount: "245.80",
        value: "$245.80"
      }, {
        token: "ETH",
        amount: "0.0412",
        value: "$148.33"
      }, {
        token: "WETH",
        amount: "0.0100",
        value: "$36.02"
      }]
    }, {
      delay: 400,
      type: "confirm",
      text: "3 tokens found on Base"
    }]
  }, {
    prompt: "What's my total balance across all chains?",
    events: [{
      delay: 380,
      type: "thinking"
    }, {
      delay: 550,
      type: "tool",
      tool: {
        server: "base-mcp",
        action: "get_portfolio",
        args: {}
      }
    }, {
      delay: 500,
      type: "text",
      text: "Your balances across supported networks:"
    }, {
      delay: 250,
      type: "rows",
      rows: [{
        token: "Base",
        amount: "$430.15",
        value: "USDC · ETH · WETH"
      }, {
        token: "Ethereum",
        amount: "$284.20",
        value: "ETH · USDC"
      }]
    }, {
      delay: 400,
      type: "confirm",
      text: "Total: $714.35 across all chains"
    }]
  }];
  const [activeIdx, setActiveIdx] = useState(null);
  const [eventIdx, setEventIdx] = useState(0);
  const scrollRef = useRef(null);
  const timersRef = useRef([]);
  const clearTimers = () => {
    timersRef.current.forEach(clearTimeout);
    timersRef.current = [];
  };
  useEffect(() => {
    if (scrollRef.current) scrollRef.current.scrollTop = scrollRef.current.scrollHeight;
  }, [eventIdx, activeIdx]);
  useEffect(() => () => clearTimers(), []);
  const pick = idx => {
    if (activeIdx !== null) return;
    setActiveIdx(idx);
    setEventIdx(0);
    clearTimers();
    let cumulative = 0;
    examples[idx].events.forEach((e, i) => {
      cumulative += e.delay;
      timersRef.current.push(setTimeout(() => setEventIdx(i + 1), cumulative));
    });
  };
  const reset = () => {
    clearTimers();
    setActiveIdx(null);
    setEventIdx(0);
  };
  const ex = activeIdx !== null ? examples[activeIdx] : null;
  const TrafficLights = () => <div style={{
    display: "flex",
    gap: 6,
    marginRight: 14
  }}>
      <span style={{
    width: 11,
    height: 11,
    borderRadius: "50%",
    background: "#ed6a5e",
    display: "inline-block"
  }} />
      <span style={{
    width: 11,
    height: 11,
    borderRadius: "50%",
    background: "#f5bf4f",
    display: "inline-block"
  }} />
      <span style={{
    width: 11,
    height: 11,
    borderRadius: "50%",
    background: "#61c554",
    display: "inline-block"
  }} />
    </div>;
  const UserBubble = ({children}) => <div style={{
    display: "flex",
    justifyContent: "flex-end",
    marginBottom: 20
  }}>
      <div className="dfd-bubble" style={{
    background: c.bubble,
    color: c.bubbleText,
    padding: "12px 16px",
    borderRadius: 14,
    fontFamily: sans,
    lineHeight: 1.45,
    border: `1px solid ${c.toolBorder}`
  }}>{children}</div>
    </div>;
  const ToolCall = ({tool, completed}) => <div style={{
    marginBottom: 10
  }}>
      <div className="dfd-tool-chip" style={{
    display: "inline-flex",
    alignItems: "flex-start",
    gap: 8,
    background: c.toolBg,
    border: `1px solid ${c.toolBorder}`,
    borderRadius: 8,
    padding: "6px 11px",
    opacity: completed ? 0.85 : 1
  }}>
        <span style={{
    width: 14,
    height: 14,
    display: "inline-flex",
    alignItems: "center",
    justifyContent: "center",
    flexShrink: 0,
    marginTop: 1
  }}>
          {completed ? <svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke={c.success} strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round"><path d="M20 6 9 17l-5-5" /></svg> : <svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke={c.accent} strokeWidth="2.2" strokeLinecap="round" strokeLinejoin="round"><path d="M14.7 6.3a4 4 0 0 0-5.4 0l-7 7a3.5 3.5 0 0 0 5 5l5.5-5.5" /><path d="m11 8 5 5" /></svg>}
        </span>
        <span className="dfd-tool-text" style={{
    fontFamily: mono,
    color: c.muted
  }}>
          <span style={{
    color: c.accent
  }}>{tool.server}</span>
          <span style={{
    color: c.dim
  }}> · </span>
          <span style={{
    color: c.body
  }}>{tool.action}</span>
          <span style={{
    color: c.dim
  }}>(</span>
          {Object.entries(tool.args).map(([k, v], i, arr) => <span key={k}><span style={{
    color: c.muted
  }}>{k}: </span><span style={{
    color: c.code
  }}>"{v}"</span>{i < arr.length - 1 && <span style={{
    color: c.dim
  }}>, </span>}</span>)}
          <span style={{
    color: c.dim
  }}>)</span>
        </span>
      </div>
    </div>;
  const Thinking = () => <div style={{
    display: "flex",
    alignItems: "center",
    gap: 8,
    marginBottom: 14,
    fontFamily: sans,
    fontSize: 13,
    color: c.muted
  }}>
      <span style={{
    display: "inline-flex",
    gap: 3
  }}>
        {[0, 1, 2].map(i => <span key={i} style={{
    width: 5,
    height: 5,
    borderRadius: "50%",
    background: c.muted,
    opacity: 0.4,
    animation: `dfd-pulse 1.2s infinite ${i * 0.18}s`
  }} />)}
      </span>
      <span style={{
    fontStyle: "italic"
  }}>Thinking</span>
    </div>;
  const ResponseText = ({children, top}) => <div style={{
    fontFamily: serif,
    fontSize: 15,
    lineHeight: 1.55,
    color: c.body,
    marginBottom: 12,
    marginTop: top ? 8 : 0
  }}>{children}</div>;
  const ResponseRows = ({rows}) => <div style={{
    marginBottom: 14
  }}>
      {rows.map((r, i) => <div key={i} className="dfd-row" style={{
    display: "flex",
    alignItems: "baseline",
    padding: "5px 0",
    fontFamily: serif,
    fontSize: 14,
    color: c.body
  }}>
          <span style={{
    minWidth: 12,
    color: c.dim,
    flexShrink: 0
  }}>•</span>
          <span className="dfd-row-token" style={{
    fontWeight: 500
  }}>{r.token}</span>
          <span style={{
    fontFamily: mono,
    fontSize: 12.5,
    color: c.code,
    background: c.codeBg,
    padding: "1px 6px",
    borderRadius: 4,
    whiteSpace: "nowrap"
  }}>{r.amount}</span>
          <span style={{
    color: c.muted,
    fontSize: 13
  }}>{r.value}</span>
        </div>)}
    </div>;
  const Confirm = ({text}) => <div style={{
    fontFamily: serif,
    fontSize: 14,
    color: c.success,
    display: "flex",
    alignItems: "center",
    gap: 8,
    marginTop: 4
  }}>
      <svg viewBox="0 0 24 24" width="15" height="15" fill="none" stroke={c.success} strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round"><path d="M20 6 9 17l-5-5" /></svg>
      {text}
    </div>;
  const ChipBtn = ({onClick, children}) => {
    const [hover, setHover] = useState(false);
    return <button onClick={onClick} onMouseEnter={() => setHover(true)} onMouseLeave={() => setHover(false)} className="dfd-chip" style={{
      fontFamily: serif,
      lineHeight: 1.4,
      color: hover ? c.text : c.body,
      background: hover ? c.toolBg : c.header,
      border: `1px solid ${hover ? c.accent : c.toolBorder}`,
      borderRadius: 14,
      textAlign: "left",
      cursor: "pointer",
      transition: "all 0.15s ease",
      display: "flex",
      alignItems: "center",
      justifyContent: "space-between",
      gap: 14,
      width: "100%"
    }}>
        <span style={{
      flex: 1
    }}>{children}</span>
        <svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke={hover ? c.accent : c.dim} strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" style={{
      flexShrink: 0,
      transition: "stroke 0.15s ease, transform 0.15s ease",
      transform: hover ? "translateX(2px)" : "translateX(0)"
    }}><path d="M5 12h14M13 6l6 6-6 6" /></svg>
      </button>;
  };
  const renderEvents = () => {
    if (!ex) return null;
    const shown = ex.events.slice(0, eventIdx);
    return shown.map((event, i) => {
      if (event.type === "thinking") {
        if (i < shown.length - 1) return null;
        return <Thinking key={i} />;
      }
      if (event.type === "tool") {
        const hasLater = shown.slice(i + 1).some(e => e.type !== "thinking");
        return <ToolCall key={i} tool={event.tool} completed={hasLater} />;
      }
      if (event.type === "text") return <ResponseText key={i} top>{event.text}</ResponseText>;
      if (event.type === "rows") return <ResponseRows key={i} rows={event.rows} />;
      if (event.type === "confirm") return <Confirm key={i} text={event.text} />;
      return null;
    });
  };
  return <div style={{
    margin: "28px 0",
    borderRadius: 14,
    overflow: "hidden",
    border: `1px solid ${c.border}`,
    background: c.bg,
    boxShadow: "0 8px 24px rgba(0,0,0,0.25)"
  }}>
      <style>{`
        @keyframes dfd-pulse{0%,100%{opacity:0.3;transform:scale(1)}50%{opacity:1;transform:scale(1.3)}}
        .dfd-chat{height:400px;padding:24px 28px 16px}
        .dfd-input-row{padding:10px 16px 14px}
        .dfd-tool-text{white-space:nowrap;font-size:12px;line-height:1.4}
        .dfd-tool-chip{max-width:100%}
        .dfd-row{gap:12px;flex-wrap:nowrap}
        .dfd-row-token{min-width:120px}
        .dfd-bubble{max-width:78%;font-size:14px}
        .dfd-chip{padding:16px 18px;font-size:15px}
        .dfd-empty-text{font-size:16px}
        .dfd-footnote{font-size:11px}
        @media(max-width:640px){
          .dfd-chat{height:460px;padding:16px 14px 12px}
          .dfd-input-row{padding:8px 10px 10px}
          .dfd-tool-chip{display:block}
          .dfd-tool-text{white-space:normal;word-break:break-word;font-size:11px}
          .dfd-row{flex-wrap:wrap;gap:4px 10px}
          .dfd-row-token{min-width:100%;flex:1 1 100%}
          .dfd-bubble{max-width:88%;font-size:13.5px}
          .dfd-chip{padding:14px 14px;font-size:14px}
          .dfd-empty-text{font-size:14.5px}
          .dfd-footnote{font-size:10.5px}
        }
      `}</style>

      <div style={{
    display: "flex",
    alignItems: "center",
    padding: "11px 14px",
    background: c.header,
    borderBottom: `1px solid ${c.border}`
  }}>
        <TrafficLights />
        <span style={{
    fontFamily: sans,
    fontSize: 13,
    color: c.muted,
    fontWeight: 500
  }}>Base MCP</span>
        <span style={{
    fontFamily: sans,
    fontSize: 12,
    color: c.dim,
    marginLeft: 8
  }}>▾</span>
        <div style={{
    flex: 1
  }} />
        {activeIdx !== null && <button onClick={reset} title="Reset" style={{
    display: "flex",
    alignItems: "center",
    justifyContent: "center",
    width: 28,
    height: 24,
    borderRadius: 6,
    background: "transparent",
    border: "1px solid transparent",
    cursor: "pointer",
    color: c.dim
  }} onMouseEnter={e => {
    e.currentTarget.style.color = c.text;
    e.currentTarget.style.borderColor = c.toolBorder;
  }} onMouseLeave={e => {
    e.currentTarget.style.color = c.dim;
    e.currentTarget.style.borderColor = "transparent";
  }}>
            <svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M21 12a9 9 0 1 1-3-6.7L21 8" /><path d="M21 3v5h-5" /></svg>
          </button>}
      </div>

      <div ref={scrollRef} className="dfd-chat" style={{
    overflowY: "auto"
  }}>
        {!ex && <div>
            <div className="dfd-empty-text" style={{
    fontFamily: serif,
    color: c.muted,
    marginBottom: 20,
    lineHeight: 1.5
  }}>
              Check your wallet balance once <span style={{
    fontFamily: mono,
    fontSize: "0.85em",
    color: c.code,
    background: c.codeBg,
    padding: "1px 6px",
    borderRadius: 4
  }}>mcp.base.org</span> is connected:
            </div>
            <div style={{
    display: "grid",
    gap: 10
  }}>
              {examples.map((e, i) => <ChipBtn key={i} onClick={() => pick(i)}>{e.prompt}</ChipBtn>)}
            </div>
          </div>}
        {ex && <><UserBubble>{ex.prompt}</UserBubble>{renderEvents()}</>}
      </div>

      <div className="dfd-input-row">
        <div style={{
    display: "flex",
    alignItems: "center",
    background: c.inputBg,
    border: `1px solid ${c.toolBorder}`,
    borderRadius: 14,
    padding: "10px 14px"
  }}>
          <button style={{
    display: "flex",
    alignItems: "center",
    justifyContent: "center",
    width: 26,
    height: 26,
    borderRadius: 8,
    border: "none",
    background: "transparent",
    color: c.muted,
    cursor: "default",
    padding: 0,
    flexShrink: 0
  }}>
            <svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M12 5v14M5 12h14" /></svg>
          </button>
          <span style={{
    flex: 1,
    marginLeft: 8,
    fontFamily: sans,
    fontSize: 14,
    color: c.dim,
    overflow: "hidden",
    textOverflow: "ellipsis",
    whiteSpace: "nowrap"
  }}>Write a message...</span>
          <span style={{
    fontFamily: sans,
    fontSize: 13,
    color: c.muted,
    marginRight: 12,
    flexShrink: 0
  }}>Sonnet 4.6 <span style={{
    color: c.dim
  }}>▾</span></span>
          <svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke={c.muted} strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" style={{
    flexShrink: 0
  }}><path d="M12 2a3 3 0 0 0-3 3v6a3 3 0 0 0 6 0V5a3 3 0 0 0-3-3z" /><path d="M19 11a7 7 0 0 1-14 0" /><line x1="12" y1="18" x2="12" y2="22" /></svg>
        </div>
        <div className="dfd-footnote" style={{
    textAlign: "center",
    marginTop: 8,
    fontFamily: sans,
    color: c.dim
  }}>
          Demo · Read-only — no approval required to check balances
        </div>
      </div>
    </div>;
};

<DataFetchingDemo />

## What you can ask

```text theme={null}
Show me my wallets
```

```text theme={null}
What is my USDC balance?
```

```text theme={null}
Show my full portfolio
```

```text theme={null}
What tokens do I have in my wallet?
```

## How it works

**`get_wallets`** — lists your Base Account, any agent wallets, session authorization state, and supported chains.

**`get_portfolio`** — returns portfolio value and per-asset breakdown for your Base Account or an in-session agent wallet.

| Parameter          | What it does                                                                                                                 |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| `address`          | Optional wallet address to query — must be your Base Account or one of your agent wallets                                    |
| `chain`            | Filter by supported chain, e.g. `base`, `ethereum`, `arbitrum`, `optimism`, `polygon`, `bsc`, `avalanche`, or `base-sepolia` |
| `query`            | Filter by token name or symbol (e.g. "USDC")                                                                                 |
| `includePnl`       | Include unrealized/realized P\&L per asset                                                                                   |
| `limit` / `offset` | Paginate the per-asset breakdown                                                                                             |

**`search_tokens`** — resolve a token symbol or name to its contract address and decimals. Useful before sending less common tokens.

## Related guides

<CardGroup cols={2}>
  <Card title="Send tokens" icon="paper-plane" href="/ai-agents/guides/send-tokens">
    Send native tokens or ERC-20s from your connected wallet.
  </Card>

  <Card title="View transaction history" icon="clock-rotate-left" href="/ai-agents/guides/view-history">
    See past sends, swaps, and receives.
  </Card>
</CardGroup>