> 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 * **Run pipeline** 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](/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](/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](/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](/thecontentforge-docs/web3-intelligence/token-intelligence.md) - track tokens alongside the wallets that hold them * [DeFi Intelligence](/thecontentforge-docs/web3-intelligence/defi-intelligence.md) - vault and lending positions for tracked wallets * [Execution Intelligence](/thecontentforge-docs/web3-intelligence/execution-intelligence.md) - quality-check swaps before posting about them * [Content Forge](/thecontentforge-docs/feature-guides/content-studio.md) - destination for events, alerts, and analysis reports * [My Account](/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](/thecontentforge-docs/reference/faq.md#web3-safety) for the full set of guarantees that apply across every Intelligence module. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://thecontentforge.gitbook.io/thecontentforge-docs/web3-intelligence/wallet-intelligence.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.