Skip to main content
Easily fetch detailed wallet activity, including transfers, swaps, and vault operations, using the Mobula API. The Get Wallet Activity endpoint returns a unified activity feed for a wallet, with smart swap detection that automatically groups related transfers into swap transactions. It is ideal for developers building wallet explorers, transaction feeds, portfolio dashboards, trading analytics, and on-chain monitoring tools.

​
What this endpoint does

With this API, you can:
  • Fetch a unified wallet activity feed across supported blockchains
  • Retrieve transfers, swaps, and vault operations in one response
  • Automatically group IN/OUT transfers into swap objects when they happen in the same transaction
  • Filter spam tokens and optionally include unlisted/unverified assets
  • Exclude specific addresses using a blacklist
  • Paginate results using page, offset, or cursor-based navigation
Unlike raw transaction lists, this endpoint returns activity in a cleaner format optimized for UI feeds.

​
What you’ll need

  • Basic knowledge of REST APIs
  • A wallet address
  • A Mobula API key
Note: All Mobula endpoints require an API key.
Get a free API key: Here Optional:
  • A block explorer or DexScreener to find example wallets to test

​
When to use Get Wallet Activity

Use this endpoint when you want to:
  • Build a wallet activity timeline (transfers + swaps + vault actions)
  • Detect swaps without manually reconstructing transfers
  • Monitor wallets across chains for analytics, alerts, or dashboards
  • Filter spam tokens and unlisted assets in wallet feeds
  • Paginate through large activity histories efficiently
If you need token balances and PnL, use wallet/positions or wallet/position.

​
Walkthrough to Get Wallet Activity for a Wallet

​
1. Prepare your query

The wallet/activity endpoint requires one parameter to work:
ParameterDescription
walletWallet address to analyze
Optional parameters you can use to control output:
  • limit (max 1000): number of items returned
  • page / offset: pagination controls (offset is an alternative to page)
  • order: asc or desc by timestamp
  • blacklist: exclude activity involving specific addresses
  • filterSpam: filter out spam tokens
  • unlistedAssets: include unlisted/unverified tokens
  • cursor_hash + cursor_direction: cursor pagination for precise navigation
  • pagination: include pagination metadata
  • backfillTransfers: backfill feature available
  • withTokens: include token list in response
  • backfillStatus: response status for backfill processing

​
2. Find a wallet address to test

To get a real wallet example:
  1. Open a block explorer (Etherscan, Solscan, etc.) or DexScreener
  2. Pick an active wallet (top traders, top holders, or known accounts)
  3. Copy the wallet address
Use that address as the wallet parameter.

​
3. Fill the API form

Once the wallet address is filled (and optional filters are set), click Send to retrieve the wallet’s activity data.

​
Reviewing the wallet activity response

The response returns a unified feed:
  • data[]: the activity items
  • pagination: page/offset info when enabled
  • backfillStatus: processed, processing, or pending
  • tokens[] (optional): enriched token objects when withTokens=true

​
Activity types you’ll see

​
Transfer (model: “transfer”)

  • ERC20 token transfers (IN/OUT)
  • Native transfers (IN/OUT)
  • Vault operations (DEPOSIT/WITHDRAW)

​
Swap (model: “swap”)

  • Automatically detected from combined transfers
  • Includes token pair, base/quote identification, pricing, and amount in USD

​
Try It Live with Mobula Wallet Activity Demo (UI)

You can also test this endpoint using our demo UI: Demo UI Homepage Wallet Activity Demo UI Docs

​
Summary

The Get Wallet Activity endpoint provides a clean, unified wallet activity feed, including:
  • Transfers, swaps, and vault operations
  • Smart swap detection with grouped transfers
  • Spam filtering and optional unlisted asset support
  • Flexible pagination options (page, offset, cursor navigation)
If you’re building wallet explorers, timelines, dashboards, or monitoring tools, this endpoint is a strong foundation for real-time and historical activity tracking.

​
Try Mobula for Free

Try our free API today and start building in minutes.
Get your free API key: Here