> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Track Wallet Activity Across Ethereum, Solana, BNB, Base & More

> Easily fetch detailed wallet activity, including transfers, swaps, and vault operations, using the Mobula API.

Easily fetch detailed wallet activity, including transfers, swaps, and vault operations, using the Mobula API.

The [**Get Wallet Activity**](https://docs.mobula.io/rest-api-reference/endpoint/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**.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/tdKWGT4YkU0" title="YouTube video player" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />
</div>

***

## What this endpoint does

With this API, you can:

* Fetch a unified wallet activity feed across supported blockchains like [Solana](https://docs.mobula.io/blockchains/solana), [Ethereum](https://docs.mobula.io/blockchains/ethereum) and more

* 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](https://admin.mobula.io/)

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](https://docs.mobula.io/rest-api-reference/endpoint/wallet-positions) or [wallet/position](https://docs.mobula.io/rest-api-reference/endpoint/wallet-position).

***

## Walkthrough to Get Wallet Activity for a Wallet

### 1. Prepare your query

The `wallet`/`activity` endpoint requires one parameter to work:

| Parameter | Description               |
| --------- | ------------------------- |
| `wallet`  | Wallet 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](https://mobula-demo-endpoint-production.up.railway.app/)

[Wallet Activity Demo UI](https://mobula-demo-endpoint-production.up.railway.app/wallet-activity)

[Docs](https://docs.mobula.io/rest-api-reference/endpoint/wallet-activity)

***

## Summary

The [**Get Wallet Activity**](https://docs.mobula.io/rest-api-reference/endpoint/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](https://admin.mobula.io/)