📘 第7篇：白名单与黑名单机制：只交易你想要的币

在币圈，交易对多如牛毛，质量却参差不齐。Freqtrade 提供了 pair_whitelist 和 pair_blacklist 两个机制，让你从海量币对中精准筛选出想交易的标的，从而避免交易“空气币”或低流动性币种，提升策略的稳定性与安全性。

这两个参数配置灵活、实用，是每一个量化交易者都必须掌握的核心控制工具。

---

🎯 一句话理解机制原理

配置项	作用
pair_whitelist	只允许交易这些币对，其他币对全部忽略
pair_blacklist	禁止交易这些币对，其他币对都可以（除非在 whitelist 之外）

✅ 同时配置时：最终可交易币对 = pair_whitelist - pair_blacklist
❗ 注意：币对格式必须与交易所一致（如 "BTC/USDT"）

---

🧩 配置结构说明

"exchange": {
  "pair_whitelist": [
    "BTC/USDT",
    "ETH/USDT",
    "SOL/USDT"
  ],
  "pair_blacklist": [
    "DOGE/USDT",
    "LUNC/USDT"
  ]
}

字段名	类型	含义说明
pair_whitelist	Array	允许交易的币对列表
pair_blacklist	Array	禁止交易的币对列表，可与 whitelist 组合使用

---

✅ 常见使用场景

✅ 1. 精准控制交易币对（只交易核心币）

如果你只想交易比特币、以太坊等主流币：

"pair_whitelist": [
  "BTC/USDT",
  "ETH/USDT"
]

🔒 所有其他币对将被忽略，确保策略只聚焦在最具流动性和市场共识的资产上。

---

✅ 2. 排除特定风险币对

当你希望交易多个币种，但想排除某些波动剧烈或曾出过问题的币：

"pair_blacklist": [
  "SHIB/USDT",
  "LUNA/USDT"
]

✅ 这让你避免意外参与高风险币种的交易。

---

✅ 3. 配合自动筛选系统动态管理

你可以通过外部脚本动态生成 whitelist 或 blacklist，结合以下标准：

• 24小时成交量排名
• 市值排名
• 是否上线时间过短
• 是否有监管风险等

这样可实现智能选币 + 黑名单剔除的组合式风控。

---

🔁 白名单 vs 黑名单：详细对比

项目	pair_whitelist	pair_blacklist
控制方式	只允许列出的币对交易	排除列出的币对，其他可交易
使用目的	精选标的，限定策略作用范围	广泛交易但排除个别风险币
灵活性	较低，需人工列出完整币对列表	较高，只需维护要剔除的币对列表
推荐使用场景	稳健策略、回测复现实盘一致性要求高的策略	自动选币策略、大盘动量策略等需要广泛筛选的情形

---

📌 组合使用建议

你可以同时使用白名单和黑名单来实现更细粒度的控制：

"pair_whitelist": [
  "BTC/USDT",
  "ETH/USDT",
  "XRP/USDT"
],
"pair_blacklist": [
  "XRP/USDT"
]

👆 上述配置中，最终实际可交易币对为：BTC/USDT、ETH/USDT
❗ 黑名单的币对（XRP/USDT）即便出现在白名单中，也会被剔除。

---

💡 实战建议与技巧

1. 组合动态管理

   • 白名单：使用自动化脚本定期抓取成交量Top N，生成交易列表
   • 黑名单：人工维护长期问题币（如流动性差、项目方失联等）

2. 定期审查

   • 建议每周或每月检查一次列表，确保符合市场最新行情与偏好

3. 结合限仓机制

   • 白名单设置太宽时，搭配 max_open_trades 控制持仓数量效果更佳

4. 多策略隔离

   • 每个策略可设置不同的币对范围，避免互相干扰（建议独立 config.json）

---

🧠 小结清单

参数名	描述	推荐做法
pair_whitelist	明确允许交易的币对	精选优质币对，或与策略标的一致
pair_blacklist	明确禁止交易的币对	排除风险币、波动异常或低流动性币
同时使用	whitelist - blacklist	用于精确控制核心标的并避免临时风险币

---

通过 pair_whitelist 和 pair_blacklist 的组合使用，Freqtrade 能实现币对级别的精准交易控制，不但提高策略稳定性，也有效避免很多因币对质量问题带来的损失。

📌 下次再也别说“策略亏是因为交易到奇怪币对”了，从配置文件开始规避！