Skip to main content
Your agent’s watchlist is the set of token pairs it monitors for signals and trades. If a token isn’t on your watchlist, your agent won’t look at it, won’t generate signals for it, and won’t trade it — the watchlist is the entire scope of what your agent does. Getting this right from the start matters: the same watchlist drives both your forward-testing (paper) period and live trading, so the track record your agent builds in paper mode is a genuine representation of how it would perform live.

​
How to choose tokens

When you spawn a new agent, the dashboard presents ranked token candidates from the eligible universe, sorted by liquidity. Halyrd recommends the most liquid options because higher liquidity means tighter spreads, more reliable price data, and a smaller gap between the price your agent expects and the price it actually gets.
The dashboard defaults to a sensible starting selection — ETH, CAKE, LINK, and AVAX against USDT — so you can get going with a single click. You don’t need to pick tokens manually unless you want to.
Recommended: pick 3–5 tokens. A focused watchlist gives your strategy enough opportunities without spreading attention across tokens that may not suit your rules. You can expand later once you have a live track record.
1

Review the ranked candidates

The dashboard shows tokens ranked by liquidity, with a recommended preset for each. Tokens outside the eligible universe don’t appear.
2

Select your tokens

Click the one-click defaults or manually check 3–5 tokens from the list.
3

Confirm the selection

Confirming saves your watchlist as part of your agent’s config and automatically syncs the TWAK signer allowlist. No restart is required.

​
Spot mode: always token/USDT pairs

In spot mode, all pairs are TOKEN/USDT. Your agent buys a token with USDT when a signal fires, and sells back to USDT when the exit rules trigger. Sitting in USDT between trades is intentional — it’s your agent’s natural drawdown protection.

​
The watchlist and the TWAK allowlist

Your agent executes swaps through the TWAK signing layer, which maintains its own token allowlist — a list of tokens the signer is permitted to sign transactions for. There is a hard invariant that must always hold: the TWAK allowlist must be a superset of your watchlist. If a token is on your watchlist but not on the TWAK allowlist, the signer will refuse to sign the transaction — the trade physically cannot happen. Halyrd handles this for you automatically. When you update your watchlist through the dashboard, the TWAK allowlist updates at runtime with no restart required. You never need to configure the signer separately.

​
The watchlist is versioned

Your watchlist is part of your agent’s versioned config. Every time you change it, Halyrd creates a new config version with a timestamp and an audit log entry. You can review the full history of watchlist changes in Settings → Config Versions.

​
Editing the watchlist at runtime

You can update your watchlist while your agent is running — you don’t need to stop it or wait for a restart.
1

Open Settings

Navigate to Settings → Edit watchlist & allowlist.
2

Make your changes

Add or remove tokens. The dashboard shows the current allowlist state and will flag any inconsistencies before you save.
3

Confirm the update

Confirm the change. Halyrd saves it as a new config version, writes an audit log entry, and re-configures the TWAK signer with the updated allowlist. The change takes effect immediately.
Narrowing your watchlist removes tokens from active trading immediately — your agent won’t open new positions in removed tokens, and any open positions in those tokens will follow your normal exit rules. Widening the watchlist adds new tokens to your agent’s scope. Always confirm the allowlist update before promoting to live: if the TWAK allowlist doesn’t include a token your agent wants to trade, the transaction will be blocked at the signing layer.

​
Paper and live use the same watchlist

The watchlist your agent forward-tests on is the same watchlist it will trade on when you promote to live. This is not an accident — it means the paper track record your agent builds is a genuine record of how it would have performed on the same tokens, under the same market conditions, with the same signal rules. Swapping the watchlist at promotion time would make that track record meaningless. If you want to add tokens for live trading, do it before you promote, so the paper period covers the full set.
If you change your watchlist after promoting to live, Halyrd creates a new config version and treats the change as the start of a new evaluation run on that version. Your previous track record is preserved under the old version.