> For the complete documentation index, see [llms.txt](https://thecontentforge.gitbook.io/thecontentforge-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://thecontentforge.gitbook.io/thecontentforge-docs/web3-intelligence/wallet-intelligence.md).

# Wallet Intelligence

Wallet Intelligence is your on-chain awareness surface. Track Solana wallets, watch their activity in real time, organise them into groups, set alert rules for the moves that matter, and turn on-chain events into ready-to-post content.

Open it from **Intelligence > On-Chain Intelligence > Wallet Intelligence**.

### What you'll see

The page opens on six tabs across the top. Counts on each tab badge tell you how much is in scope.

#### Tracked Wallets

Your watchlist of monitored Solana wallets. Each row shows the label, address, category, group, and a "Live" indicator if real-time monitoring is on.

* Search by label or address; filter by category, chain, or group
* **Add wallet** - paste an address, label it, assign a category, group, and notes
* **Bulk add** - paste up to 1,000 addresses (one per line, or `address,label,tag1|tag2` format) or upload a CSV / TXT file. Client-side validation surfaces invalid rows before submit. Defaults (group, category, visibility, monitoring) apply to every row in the batch.
* **Refresh all (N)** - queues an immediate refresh for every active or paused wallet in your watchlist, bypassing the per-group cadence
* **Backfill all** - bulk-backfill action with a depth picker (500 / 1,000 / 5,000 signatures per wallet). Backfill runs in the background; results appear as they complete.
* Edit a wallet inline to change its label, category, group, or notes
* Toggle **Live monitoring** on a wallet to receive on-chain events for it
* Mark a wallet **Safe for content** when it's appropriate to reference in published posts
* Click a row to open the [Wallet Detail](#wallet-detail-page) page

#### On-Chain Feed

A live stream of transactions from your monitored wallets. Events are enriched with USD valuations and AI-generated summaries.

* **Filters** - five controls let you narrow the feed:
  * **Action** (coarse) - Received, Sent, Swapped, Liquidity, Staking
  * **Event type** (fine) - Transfer In / Out, Token Send, Swap, Staking, Unstaking, NFT operations, Interactions
  * **Wallet** - narrow to a single wallet
  * **Group** - narrow to a wallet group
  * **Token** - search by token symbol or mint address
* Click an event to see the full transaction detail
* This tab is labelled **Activity Log**. A **Wallet Monitoring** toggle strip runs across the top - flip a wallet on or off, and use its per-wallet backfill icon to pull recent history for that wallet
* **Refresh** enriches pending events on demand so they get USD values and AI summaries without waiting for the next automatic refresh
* **Send to Content Studio** turns an event into an intelligence note prefilled in [Content Forge](https://thecontentforge.gitbook.io/thecontentforge-docs/feature-guides/content-studio.md)
* Enrichment also happens automatically, so pending events get USD values and AI summaries on their own

#### Alert Rules

Define what counts as a notable move. Rules trigger alerts that surface in the bell icon at the top right of the page and - optionally - in a Telegram channel.

* Create a rule by picking a target (a single wallet or an entire wallet **group**), a condition (e.g. whale outflow over a threshold, competitor swap, treasury movement), and a severity
* **Group-wide rules** - open the bell icon on a group card in the Groups tab to scope a rule to every wallet in that group. The target locks to the whole group so it can't be overridden per wallet. Group rules can still filter on a specific token mint.
* **Telegram channel delivery** - tick **Telegram channel** on the rule and pick an **Override chat** (optional). The override list is populated from your Telegram bot allowlist; leaving it blank uses the org-wide default chat configured in Settings. Each rule remembers its delivery settings so the in-app bell and the Telegram channel can be enabled together or independently.
* Edit a rule to adjust threshold or scope
* Delete rules you no longer need
* Triggered alerts show severity, title, summary, and timestamp. Mark them read individually or all at once

#### Activity

A manual transaction log kept for legacy data. New work should use the On-Chain Feed; this tab is read-mostly and will be consolidated over time.

#### Groups

Organise wallets into named buckets - for example "Team Wallets", "Whale Watch", or "Treasury". Groups can be coloured and used as a filter throughout the page.

* Create a group with a name, optional category, colour, and visibility
* Edit colour or rename
* Delete a group (members are unassigned, not deleted)
* **Refresh cadence** - each group has its own refresh frequency. Options: **Use org default**, **Every 5 / 15 / 30 minutes**, or **Every hour**. The selected cadence shows on the group card with a clock icon. Manual **Refresh all** / **Backfill all** actions bypass the cadence and run immediately.
* Open the bell icon on a group card to create a **group-wide alert rule** that applies to every wallet in the group (see Alert Rules above).

#### Analysis

AI analysis reports generated on demand for a set of wallets or groups. Each report includes a written summary, a suggested X post, a thread outline, a newsletter angle, and a manual verification checklist.

* **Run Analysis** opens a modal. Pick the wallets or groups you want covered and generate
* Click a report to expand the full output
* **Send to Content Studio** drops the suggested post or thread into [Content Forge](https://thecontentforge.gitbook.io/thecontentforge-docs/feature-guides/content-studio.md)
* Delete reports you don't need

### Header controls

* The bell icon (**Alerts**) shows unread alerts; click to acknowledge
* **Refresh** reloads everything on the page
* **Run Analysis** kicks off a new AI analysis report
* **Refresh all** and **Backfill all** live in the Tracked Wallets tab, not the header
* The stat strip surfaces Total Wallets, Transactions, Inflows (USD), and Outflows (USD)

### Wallet Detail page

Click any tracked wallet to open its detail page. You get three tabs:

* **Overview** - total USD value, token count, tracked transactions, an adaptive net-flow figure (24h, 7d, or all-time depending on activity), and the top counterparties by volume
* **Wallet Chart** - a daily inflow vs outflow timeseries plus a counterparty graph
* **Forge Map** - a network graph of related wallets, counterparties, and DeFi protocols

Header actions:

* **Refresh Balances** pulls live SOL balance, token holdings, and USD valuations, and re-runs enrichment on past events
* **Backfill 1000** imports the last 1,000 transactions, then runs enrichment and alert evaluation
* The address has a copy button and a Solscan link

### Workflow

1. Add the wallets you care about and assign them to groups
2. Turn on **Live monitoring** for the ones you want real-time events from
3. Backfill history so the On-Chain Feed has context
4. Define a few Alert Rules for the moves that matter
5. When something interesting fires, run Analysis or send the event straight to [Content Forge](https://thecontentforge.gitbook.io/thecontentforge-docs/feature-guides/content-studio.md)

### Tips

* Group wallets by intent (Treasury, Competitors, Whales) - it makes Alert Rules and Analysis much sharper
* Mark wallets **Safe for content** only when you're comfortable referencing them publicly
* Use Backfill 1000 the first time you add an important wallet so the feed isn't empty

### Related

* [Token Intelligence](https://thecontentforge.gitbook.io/thecontentforge-docs/web3-intelligence/token-intelligence.md) - track tokens alongside the wallets that hold them
* [DeFi Intelligence](https://thecontentforge.gitbook.io/thecontentforge-docs/web3-intelligence/defi-intelligence.md) - vault and lending positions for tracked wallets
* [Execution Intelligence](https://thecontentforge.gitbook.io/thecontentforge-docs/web3-intelligence/execution-intelligence.md) - quality-check swaps before posting about them
* [Content Forge](https://thecontentforge.gitbook.io/thecontentforge-docs/feature-guides/content-studio.md) - destination for events, alerts, and analysis reports
* [My Account](https://thecontentforge.gitbook.io/thecontentforge-docs/feature-guides/my-account.md) - link a personal Solana wallet via Solflare

### Safety

Wallet Intelligence is read-only. TheContentForge does not custody funds, hold private keys, sign transactions, or move assets - and you never paste a private key anywhere on the platform. See [Web3 safety & guarantees](https://thecontentforge.gitbook.io/thecontentforge-docs/reference/faq.md#web3-safety) for the full set of guarantees that apply across every Intelligence module.
