> ## 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 security monitoring

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

**Behavior**

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

Detector checks balances on any transaction which references the Address:

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

If an 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 – the monitor immediately alerts the security team. This rapid notification could indicate a potential compromise or unauthorized withdrawal, allowing you to quickly freeze transactions and investigate, minimizing loss.

* **Smart Contract Treasury Tracking:** monitor 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.

## Configuration

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

  <Step title="Token">
    Specify the token(s) to monitor (native or ERC-20).
  </Step>

  <Step title="Track any change">
    Enable to generate alerts on any balance change, not just threshold breaches.
  </Step>

  <Step title="Start block">
    Leave empty to track from the 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" />