---
title: "Wallet Card | Free React & Tailwind Blocks Component | Motion UI"
canonical: "https://blacknest.dev/motion/c/blocks/wallet-card"
github_source: "https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/wallet-card/index.tsx"
install_command: "npx motion-ui-skill add wallet-card"
dependencies: ["clsx","lucide-react","motion","react","tailwind-merge"]
category: "blocks"
subcategory: "wallet-card"
---

# Wallet Card

> Wallet overview card with an account switcher and search that morph open from their triggers, a cascading balance with a live change pill and privacy toggle, copy-address, and Send / Deposit / Swap / Buy actions.

## Install

```bash
npx motion-ui-skill add wallet-card
```

## Dependencies

- `clsx`
- `lucide-react`
- `motion`
- `react`
- `tailwind-merge`

## Usage

```tsx
"use client";

import { useState } from "react";
import { WalletCard } from "@/components/motion/wallet-card";
import { Button } from "@/components/motion/button";

const ACCOUNTS = [
  { id: "main", name: "Main Wallet", address: "0x8f3Cb1a29e4D7c6F1B2a3E9d0C4b5A6f7D8e9C0b" },
  { id: "trading", name: "Trading", address: "0x1a2B3c4D5e6F7a8B9c0D1e2F3a4B5c6D7e8F9a0B" },
  { id: "cold", name: "Cold Storage", address: "0x9F8e7D6c5B4a3E2d1C0b9A8f7E6d5C4b3A2e1F0d" },
];

const RECENT_SEARCHES = ["vitalik.eth", "0xA0b8…6EB4", "Uniswap", "Send to Trading"];

export function WalletCardPreview() {
  const [balance, setBalance] = useState(12480.32);

  return (
    <div className="flex w-full flex-col items-center gap-4 p-6">
      <WalletCard
        accounts={ACCOUNTS}
        balance={balance}
        defaultChange={124.5}
        searchRecent={RECENT_SEARCHES}
        hasNotifications
      />
      <Button
        variant="ghost"
        size="sm"
        onClick={() => setBalance((b) => b + (Math.random() > 0.5 ? 1 : -1) * (50 + Math.random() * 400))}
      >
        Simulate balance change
      </Button>
    </div>
  );
}
```

## API Reference

### WalletCard

| Prop | Type | Default | Required | Description |
| --- | --- | --- | --- | --- |
| `accounts` | `WalletAccount[]` | — | Yes | — |
| `accountId` | `string` | — | No | — |
| `defaultAccountId` | `string` | — | No | — |
| `onAccountChange` | `((id: string) => void)` | — | No | — |
| `balance` | `number` | — | Yes | — |
| `balancePrefix` | `string` | `$` | No | — |
| `defaultChange` | `number` | — | No | Initial balance change shown in the pill before any live change. |
| `defaultBalanceHidden` | `boolean` | `false` | No | Start with the balance hidden behind dots. |
| `onSend` | `(() => void)` | — | No | — |
| `onDeposit` | `(() => void)` | — | No | — |
| `onSwap` | `(() => void)` | — | No | — |
| `onBuy` | `(() => void)` | — | No | — |
| `searchPlaceholder` | `string` | — | No | — |
| `searchRecent` | `string[]` | — | No | Recent searches shown in the expanded search panel. |
| `onSearchChange` | `((value: string) => void)` | — | No | — |
| `onSearchSubmit` | `((value: string) => void)` | — | No | — |
| `hasNotifications` | `boolean` | `false` | No | Show an unread pulse on the notifications bell. |
| `onNotifications` | `(() => void)` | — | No | — |
| `className` | `string` | — | No | — |

## Source Files

- [components/motion/wallet-card/index.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/wallet-card/index.tsx)
- [components/motion/action-swap.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/action-swap.tsx)
- [components/motion/button/base.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/button/base.tsx)
- [components/motion/button/index.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/button/index.tsx)
- [components/motion/button/magnetic.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/button/magnetic.tsx)
- [components/motion/button/metallic.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/button/metallic.tsx)
- [components/motion/button/stateful.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/button/stateful.tsx)
- [components/motion/magnetic.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/magnetic.tsx)
- [components/motion/wallet-card/account-avatar.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/wallet-card/account-avatar.tsx)
- [components/motion/wallet-card/account-switcher.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/wallet-card/account-switcher.tsx)
- [components/motion/wallet-card/actions.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/wallet-card/actions.tsx)
- [components/motion/wallet-card/balance-delta.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/wallet-card/balance-delta.tsx)
- [components/motion/wallet-card/constants.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/wallet-card/constants.ts)
- [components/motion/wallet-card/copy-button.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/wallet-card/copy-button.tsx)
- [components/motion/wallet-card/search-bar.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/wallet-card/search-bar.tsx)
- [components/motion/wallet-card/types.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/wallet-card/types.ts)
- [components/motion/wallet-card/utils.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/wallet-card/utils.ts)
- [lib/ease.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/lib/ease.ts)
- [lib/hooks/use-dismiss.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/lib/hooks/use-dismiss.ts)
- [lib/hooks/use-hover-capable.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/lib/hooks/use-hover-capable.ts)
- [lib/utils.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/lib/utils.ts)
