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

# Wallet detector for financial monitoring

> Track native coin and token balances of a wallet or contract address, generating info events on balance changes and alerts on configured conditions.

**Behavior**\
Detector monitors Address (Wallet or Contract) balances (native and tokens).

Detector checks balances on any transaction which references Address:

* Native transfer (from/to)
* ERC20 transfer (from/to)
* Transaction Events which has Address in its fields

If ERC-20 token is added to conditions, it will generate Alerts on condition match.

Detector will generate *INFO* events on any token balance changes unless history tracking is disabled.

**Use cases**

* Hot Wallet Security: keeps track of the balance of these wallets across native coins and tokens. Notice an unexpected balance change – like a large outflow of ETH that wasn't initiated by the system – monitor immediately alerts the security team. This rapid notification could indicate a potential compromise or unauthorized withdrawal, allowing to quickly freeze transactions and investigate, minimizing loss.
* Smart Contract Treasury Tracking: monitor to its key smart contract addresses, such as liquidity pools or treasury contracts. The detector will generate events for any significant balance shifts involving those contracts. For instance, if an exploit is draining funds from a liquidity pool (reflected as a rapid drop in the pool's token balances), the monitor will catch the change. It can then alert the protocol administrators and even trigger automated safety measures (like pausing the contract or halting withdrawals) to prevent further damage.

**Detector Configuration**

<Steps>
  <Step title="Name">
    Enter a descriptive name for your monitor, for example: "Wallet".
  </Step>

  <Step title="Token">
    Configure the token to monitor.
  </Step>

  <Step title="Track any change">
    Enable tracking of any balance change.
  </Step>

  <Step title="Start block">
    Leave empty to track from latest block. *This option is used only by Admins for replays and will have no effect for real-time on-chain streams.*
  </Step>
</Steps>

<img src="https://mintcdn.com/hacken-38641811/PuGWKoMIhOOPrmx1/assets/wallet_faq.png?fit=max&auto=format&n=PuGWKoMIhOOPrmx1&q=85&s=bd103a23569d9c779be22120d806ed3c" alt="" width="3419" height="1749" data-path="assets/wallet_faq.png" />

**Alert example**

<img src="https://mintcdn.com/hacken-38641811/PuGWKoMIhOOPrmx1/assets/wallet_alert.png?fit=max&auto=format&n=PuGWKoMIhOOPrmx1&q=85&s=4625a63d92675f5f4dce14f59ac77cbe" alt="" width="1076" height="1752" data-path="assets/wallet_alert.png" />