Watch

A watcher is an address, a rule and somewhere to send the answer. Any ERC-20 on the chain can be watched, not only a listed one, and every alert says what the token is.

Kinds

large_transferAny transfer of the watched token at or above a threshold.
wallet_activityAny transfer of the watched token that one address sends or receives. A threshold of 0 means every one.
token_eventEverything the registry notices about one listed token: pauses, halts, multiplier changes, a stale feed, a supply residual.
registry_eventThe issuer's registry itself: pauses, upgrades, blocked addresses, new listings, chain status. One watcher covers every Stock Token.
new_poolEvery pool that appears on a DEX the registry reads, once the state read has looked at it. One per account, chain-wide.

Watching a token nobody listed

Send an address instead of an asset id. Fletch reads name, symbol and decimals from the contract first, because a threshold needs a scale to be compared against.

curl -X POST https://fletch.now/api/v1/watchers \
  -H "Authorization: Bearer flk_…" \
  -H "content-type: application/json" \
  -d '{"kind":"large_transfer","address":"0x…","threshold":"1000"}'

An address that answers none of the three comes back as a 422 carrying retryWith: "watchAnyway". Send it again with watchAnyway: true and the watcher is created with that acknowledgement recorded on it, so a watcher that never fires can be explained later.

What an alert says about the token

Every alert carries the trust verdict at the moment it was raised. A lookalike alert prints the verified asset's address beside the warning, so the message itself is enough to tell the two apart. The five levels.

Caps

5 watchers per account, 1 of them chain-wide, and 500 across the platform. A new-pool watcher sends at most 20 pools per run, so a launchpad's busy hour arrives as several messages rather than one flood.