Welcome to our new support center!
We provide 24x7 support by human agents! So if our documentation can’t help you out, feel free to reach out and create a ticket!

Altrady Support Altrady Support

Signal bot whitelists and blacklists: how matching works

Whitelist and blacklist entries are checked against the market name (coin and quote currency, for example SOL/USDT). An entry with no slash, such as SOL, matches any market whose name contains those letters, so it also matches BBSOL. To match exactly one coin, add a slash after it: SOL/ matches SOL and nothing else. This article covers how to write a list, how the lists interact with signals, and what changed from the old matching.

The same rules apply to every type of signal bot, including the white list and black list on a DCA bot that trades several markets. They also apply to the back tester for those bots. The Scanner’s blacklist works differently, see How do I create a scanner?. For the other market filters on that tab, volume, price, success rate and the cool-downs, see How to set up and configure a DCA / signal bot.

How an entry is matched

  • Capitals don’t matter. sol and SOL are the same.
  • No slash: matches anywhere in the market name. SOL matches SOL/USDT and BBSOL/USDT. USDT matches every USDT market.
  • A slash after the coin: matches that whole coin. SOL/ matches SOL/USDT but not BBSOL/USDT.
  • Coin and quote with a slash: matches that market. SOL/USDT matches SOL/USDT only. The quote is matched from the start, so ADA/USD also covers ADA/USDT.
  • A slash before the quote: matches that quote anywhere. /USDT matches every market quoted in USDT.
  • * is a wildcard for any number of characters. *OIL/ matches every coin whose name ends in OIL, such as UKOIL and USOIL. Every other character is taken literally.

Writing a whitelist

  • Separate entries with commas, or put each one on its own line.
  • Add a slash after each coin to keep the match exact. The bot only receives signals for the quote currency it’s set up to trade, so BTC/ is enough: there’s no need to write BTC/USDT.

For example:

BTC/, ETH/, SOL/, AVA/

This tells the bot to trade only BTC, ETH, SOL and AVA against its quote currency, and nothing else. AVA/ doesn’t pull in KAVA or AVAX, and SOL/ doesn’t pull in BBSOL. Without the slashes, AVA would also match KAVA and AVAX.

🔍 Click the image to see a larger version

Blacklists follow the same rules

Blacklists use the same syntax and matching, just in reverse: any market that matches an entry is excluded instead of allowed. An entry of DOGE/ blocks DOGE only. An entry of DOGE also blocks coins such as 1000000BABYDOGE that contain the same letters, which is useful when you want to exclude a whole family of coins. To block every coin with OIL in its name, such as UKOIL and USOIL, use OIL or *OIL/.

🔍 Click the image to see a larger version

Lists written under the old matching

Before Oct 2026, an entry with a slash such as SYN/USDT could also match AIGENSYN/USDT, because the entry was looked for anywhere in the market name. Now an entry with a slash starts at the beginning of the coin name, so it only matches that coin. Entries without a slash still match anywhere, as before. If your list dates from before then:

  • It keeps working. Entries anchored with ^ and /, such as ^BTC/, are still read correctly. You don’t need to rewrite your list.
  • Workaround entries can go. If you blacklisted coins only because a whitelist entry with a slash was matching them by accident, you can remove those blacklist entries.
  • A bot may trade fewer pairs than before. Pairs that only matched because they contained the same letters as a slash entry are no longer included, so the bot acts on fewer signals. That’s expected.

Leaving out your exchange’s fee token

If you pay trading fees with your exchange’s own token (BNB on Binance, for example), think about adding that token to the blacklist of a signal bot that trades spot. A signal bot can open a position on any market that passes its filters, including the token’s own spot pair, such as BNB/USDT. A futures bot isn’t affected: futures positions trade contracts, not the token, so they don’t touch your token balance.

Holding the fee token in a spot bot position has two side effects:

  • An exit can come up short. A trailing take profit or stop loss doesn’t set its coins aside until it fires. Meanwhile, fees from every other fill on the account come out of the same token, so when the exit fires there can be less than the position bought. See trading your exchange’s fee token.
  • Your fees lose the discount. Coins locked in the position’s orders can’t pay fees, so the rest of your trading on that account pays fees in the usual currency instead, at the full rate.

To leave the token out, add BNB/ to the blacklist. BNB/ blocks BNB only, while a bare BNB would also block coins that contain those letters.

How the lists interact with signals

When a signal arrives for a market that isn’t allowed by your whitelist, is excluded by your blacklist, or doesn’t pass another market filter, the bot doesn’t silently ignore it. It logs the signal and records why it was blocked in the Error log, typically something like “Filters did not match”.

If you’re not sure whether your bot is receiving signals at all, or you see them arriving but never turning into positions, check the bot’s error log first. For the full diagnosis flow, including what to check when signals aren’t arriving at all versus arriving but being blocked, see Signal Bot Not Trading? A Troubleshooting Checklist.

Still stuck?

If your bot is trading markets you didn’t intend, check the Error log and your list against the rules above first. If a list still isn’t behaving the way you expect, reach out through support chat with the bot name and the exact whitelist or blacklist text you’re using, and we can check the signal log with you.

Was this article helpful?