<p align="center"> <img src="https://github.com/tukuaiai.png" alt="TradeCat" width="100px"> </p> <div align="center">

🐱 交易猫

公共服务

预测市场数据警报；https://t.me/predictcat_ai_bot

交易猫行情查询；https://t.me/tradecat_ai_bot

命理agent；https://t.me/cs_cat_bot

本项目ai解读仓库（可能不完全准确）：https://zread.ai/tukuaiai/tradecat

感谢社区捐助的资金，让我去完成我的梦想！！！真心感谢你们！！！

免责声明

1. 开源与非官方声明：本项目为永久开源项目，任何人可在开源许可范围内自由使用、分发与二次开发。本项目不隶属于任何交易所、基金、做市商或官方组织。
2. 非投资建议：本项目及其相关内容仅用于技术研究与社区协作交流，不构成任何形式的投资建议、理财建议或交易建议。数字资产价格波动剧烈，存在归零风险，请自行评估风险并独立决策。
3. 代币无发行/无背书：本项目不发行任何代币；任何以本项目名义发行、宣传、拉盘、募资、承诺收益的行为均与本项目无关。相关链上资产（如有）为第三方行为，风险自担。
4. 捐赠说明（唯一渠道）：本项目目前接受且只接受来自 SOL社区（代币地址，请勿直接转账，否则资产会丢失）(Gysp4iZ6uNuAksAPR37fQwLDRFU9Rz255UjExhiwpump) 与 BSC社区（代币地址，请勿直接转账，否则资产会丢失）(0x8a99b8d53eff6bc331af529af74ad267f3167777) 两个社群的捐赠；捐赠属自愿行为，不提供任何回报或收益承诺。捐赠属自愿行为，不提供任何回报或收益承诺。
5. 公开地址与风险提示：我的地址为公开明牌地址，请务必自行核对链、网络与地址，转账一经发生通常不可撤销，因误转/被骗/盗号/仿冒等导致的损失由转账方自行承担。
6. 责任限制：在法律允许范围内，项目维护者/贡献者不对任何直接或间接损失承担责任，包括但不限于投资亏损、交易损失、合约风险、钓鱼诈骗、智能合约漏洞、第三方服务故障等。
7. 历史情况提示：如涉及原dev或历史资金纠纷等问题，均为历史主体行为，本项目维护者不对第三方过往行为承担责任。

交易市场风云变幻，投资请谨慎，币不是我发的，明牌地址，亏钱请别骂我我害怕，我是玻璃心🙏🙏🙏，原dev已卷款跑路😅😅😅

我的加密货币钱包地址：

sol：HjYhozVf9AQmfv7yv79xSNs6uaEU5oUk2USasYQfUYau

bsc：0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC,0x60c062e7600f74079ea7b5e5568edfb9a3f61f0f

toy-level 数据分析/交易数据平台

全部市场，全部数据，全部方法，分析一切，交易一切，监控一切

English | 简体中文

---

<p> <img src="https://img.shields.io/badge/Python-3.12-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python"> <img src="https://img.shields.io/badge/PostgreSQL-TimescaleDB-4169E1?style=for-the-badge&logo=postgresql&logoColor=white" alt="TimescaleDB"> <img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge" alt="License"> <img src="https://img.shields.io/badge/Pandas-数据处理-150458?style=for-the-badge&logo=pandas&logoColor=white" alt="Pandas"> <img src="https://img.shields.io/badge/NumPy-计算-013243?style=for-the-badge&logo=numpy&logoColor=white" alt="NumPy"> <img src="https://img.shields.io/badge/TA--Lib-技术分析-green?style=for-the-badge" alt="TA-Lib"> <img src="https://img.shields.io/badge/Pydantic-数据验证-E92063?style=for-the-badge&logo=pydantic&logoColor=white" alt="Pydantic"> <img src="https://img.shields.io/badge/CCXT-交易所API-000?style=for-the-badge" alt="CCXT"> <img src="https://img.shields.io/badge/Cryptofeed-WebSocket-purple?style=for-the-badge" alt="Cryptofeed"> <img src="https://img.shields.io/badge/AKShare-A股数据-red?style=for-the-badge" alt="AKShare"> <img src="https://img.shields.io/badge/yfinance-美股数据-7B68EE?style=for-the-badge" alt="yfinance"> <img src="https://img.shields.io/badge/OpenBB-数据聚合-orange?style=for-the-badge" alt="OpenBB"> <img src="https://img.shields.io/badge/QuantLib-衍生品定价-blue?style=for-the-badge" alt="QuantLib"> <img src="https://img.shields.io/badge/FRED_API-宏观经济-1E90FF?style=for-the-badge" alt="FRED"> <img src="https://img.shields.io/badge/Telegram_Bot-机器人-26A5E4?style=for-the-badge&logo=telegram&logoColor=white" alt="Telegram Bot"> <img src="https://img.shields.io/badge/AsyncIO-异步-FF6F00?style=for-the-badge&logo=python&logoColor=white" alt="AsyncIO"> <img src="https://img.shields.io/badge/AIOHTTP-HTTP-2C5BB4?style=for-the-badge&logo=aiohttp&logoColor=white" alt="AIOHTTP"> <img src="https://img.shields.io/badge/HTTPX-HTTP-3d4f5d?style=for-the-badge" alt="HTTPX"> </p> <p> <a href="https://t.me/tradecat_ai_channel"><img src="https://img.shields.io/badge/Telegram-频道-blue?style=for-the-badge&logo=telegram" alt="Telegram"></a> <a href="https://t.me/glue_coding"><img src="https://img.shields.io/badge/Telegram-交流群-blue?style=for-the-badge&logo=telegram" alt="交流群"></a> <a href="https://x.com/123olp"><img src="https://img.shields.io/badge/Twitter-123olp-black?style=for-the-badge&logo=x" alt="Twitter"></a> </p> </div>

---

📖 目录

• 💰 救救孩子
• 🚀 快速开始
• 🏗️ 架构设计
• ✨ 核心特性
• 📊 数据与功能
• 📁 目录结构
• 🔧 运维指南
• 📞 联系方式

🤖 从零开始？ 复制这行到 AI 助手：按照 https://github.com/tukuaiai/tradecat/blob/main/README.md 的说明帮我安装 TradeCat

---

<details open> <summary><strong>点击展开👉 💰 救救孩子</strong></summary>

救救孩子，感谢了，好人一生平安🙏🙏🙏

• 币安 UID: 572155580
• Tron (TRC20): TQtBXCSTwLFHjBqTS4rNUp7ufiGx51BRey
• Solana: HjYhozVf9AQmfv7yv79xSNs6uaEU5oUk2USasYQfUYau
• Ethereum (ERC20): 0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC
• BNB Smart Chain (BEP20): 0xa396923a71ee7D9480b346a17dDeEb2c0C287BBC
• Bitcoin: bc1plslluj3zq3snpnnczplu7ywf37h89dyudqua04pz4txwh8z5z5vsre7nlm
• Sui: 0xb720c98a48c77f2d49d375932b2867e793029e6337f1562522640e4f84203d2e

</details>

---

<details open> <summary><strong>点击展开👉 🚀 快速开始</strong></summary>

🤖 AI 一键安装（推荐）

把下面的提示词复制到 Claude / ChatGPT / Cursor / Kiro，AI 会自动执行安装，零人工介入

方式一：完整部署提示词（推荐）

📄 README.md - 包含详细的 10 步部署流程，支持：

• 系统依赖自动安装
• 服务初始化和配置
• HuggingFace 历史数据自动下载导入
• 守护进程和日志轮转配置
• 完整的故障排查指南

复制该文件内容给 AI 助手即可自动完成全部部署。

<details> <summary><strong>点击展开👉 📋 简化版安装提示词</strong></summary>

按照 https://github.com/tukuaiai/tradecat/blob/main/README.md 的说明帮我安装 TradeCat

要求：
1. 读取文档后直接执行安装命令，不要生成脚本
2. 一步一步执行，每步确认成功后继续
3. 遇到错误自动分析并修复
4. 安装完成后运行 ./scripts/verify.sh 验证
5. 全程零人工介入

</details>

🪟 Windows WSL2 用户

📺 视频教程: WSL2 安装配置教程

先在 Windows 用户目录创建 .wslconfig：

notepad "$env:USERPROFILE\.wslconfig"

写入：

[wsl2]
memory=10GB
processors=6
swap=12GB
networkingMode=mirrored

重启 WSL：wsl --shutdown，然后使用上面的 AI 安装提示词。

⚙️ 最短可跑通三步

# 0) 环境检查（可选，推荐部署前运行）
./scripts/check_env.sh

# 1) 初始化（创建各服务 .venv + 安装依赖）
./scripts/init.sh

# 2) 填写全局配置（含 BOT_TOKEN / DB / 代理 等）
cp assets/config/.env.example assets/config/.env && chmod 600 assets/config/.env
# 端口：默认 LF=5433（K线/指标）、HF=15432（原子事实），见 assets/config/.env.example
vim assets/config/.env

# 3) 启动核心服务（ai + signal + api + telegram + trading）
./scripts/start.sh start
./scripts/start.sh status

说明：顶层 ./scripts/start.sh 默认管理 ai-service、signal-service、api-service、telegram-service、trading-service（ai-service 为子模块，仅做就绪检查，无独立进程；并保证 api-service 先于 telegram/sheets 启动）。
重要：从 2026-03 起，consumption 层（Telegram/Sheets/可视化）不再允许直连数据库，统一通过 Query Service（api-service，/api/v1） 读取数据；因此在运行 Telegram/Sheets 时 不要停掉 api-service。
低频/分时采集服务 data-service：services/ingestion/data-service/（兼容链路，不在默认启动链路）。
可选服务需手动启动：

• cd services/consumption/sheets-service && ./scripts/start.sh start（Google Sheets 公共看板同步，默认 daemon） 可选校验：./scripts/smoke_query_service.sh（验证 Query Service 鉴权与可用性；不回显 token）

⚙️ 配置（必须）

• 路径：assets/config/.env（需手动从 .env.example 复制；或运行 ./scripts/install.sh 自动生成），权限需 600，服务启动脚本会强制校验。
• TimescaleDB 端口说明（重要，按仓库现状）：
  • LF（低频/分时/K线与指标）：DATABASE_URL 默认 localhost:5433/market_data（见 assets/config/.env.example）
  • HF（高频/原子事实）：BINANCE_VISION_DATABASE_URL 默认 localhost:15432/market_data（见 assets/config/.env.example）
  • 若你在私有环境使用其它端口（例如历史文档曾提及 5434）：请全局统一端口与脚本/命令；仓库当前示例以 5433/15432 为准。<!-- TODO: 若仓库正式迁移到其它端口，请补“统一替换列表与执行顺序” -->
• 核心字段：
  • DATABASE_URL（TimescaleDB，见下方端口说明）
  • QUERY_SERVICE_BASE_URL（Query Service 基地址；默认 http://127.0.0.1:8088，见 assets/config/.env.example）
  • QUERY_SERVICE_AUTH_MODE（Query Service 鉴权模式；默认 required；disabled 仅限本地/受控环境调试）
  • QUERY_SERVICE_TOKEN（Query Service 内网 token；Header: X-Internal-Token；required 模式必须设置；/api/v1/indicators/* 调试端点始终要求 token；./scripts/check_env.sh 会将 dev-token-change-me/your_token_here 视为占位值并判定为未配置）
  • QUERY_SERVICE_TIMEOUT_SECONDS（可选：消费端请求超时秒数；默认 8，见 assets/config/.env.example）
  • QUERY_SERVICE_CACHE_TTL_SECONDS（可选：消费端（telegram/sheets）本地缓存 TTL 秒；默认 2）
  • QUERY_SERVICE_STALE_TTL_SECONDS（可选：消费端 stale-if-error 窗口秒；默认 30）
  • QUERY_SERVICE_NET_MAX_RETRIES（可选：消费端网络重试次数；默认 2；总尝试=1+retries）
  • QUERY_SERVICE_NET_RETRY_BASE_SECONDS（可选：消费端重试退避 base 秒；默认 0.2；0=不 sleep）
  • QUERY_MARKET_TABLE_EXISTS_TTL_SEC（可选：market_data 表存在性检查缓存 TTL 秒数；默认 30）
  • QUERY_NUMERIC_MODE（可选：指标数值输出模式；float|string；默认 float；string 保留 Decimal 精度）
  • QUERY_CACHE_MAX_ENTRIES（可选：Query Service 内存缓存最大条数；默认 256）
  • QUERY_DASHBOARD_CACHE_TTL_SEC（可选：dashboard 缓存 TTL 秒；默认 2；0=关闭）
  • QUERY_SNAPSHOT_CACHE_TTL_SEC（可选：snapshot 缓存 TTL 秒；默认 2；0=关闭）
  • 错误语义：Query Service 对齐 CoinGlass 风格：即使失败也返回 HTTP 200；请始终通过响应体的 success/code/msg 判断成功与否。
  • BOT_TOKEN（Telegram Bot Token）
  • TELEGRAM_GROUP_WHITELIST（群聊白名单，逗号分隔；为空仅私聊；群聊仅响应 / 或 ! 开头且需 @bot）
  • HTTP_PROXY / HTTPS_PROXY（需要代理时填写）
  • 外部地址：BINANCE_WEB_BASE、BINANCE_PING_URL、SYMBOLS_ALL_URL、TELEGRAM_API_BASE、POLYMARKET_WEB_BASE、KALSHI_WEB_BASE、OPINION_WEB_BASE、NODEJS_SETUP_URL、NOFX_*
  • 币种/周期：SYMBOLS_GROUPS、SYMBOLS_EXTRA、SYMBOLS_EXCLUDE、INTERVALS、KLINE_INTERVALS、FUTURES_INTERVALS
  • 采集/计算开关：BACKFILL_MODE/BACKFILL_DAYS/BACKFILL_ON_START、MAX_CONCURRENT、RATE_LIMIT_PER_MINUTE
  • 默认值：BACKFILL_MODE=all（全量回填，若设置 BACKFILL_START_DATE 则按起始日计算天数；否则约 10 年）、SYMBOLS_GROUPS=main4（只拉 BTC/ETH/SOL/BNB，如需全市场改为 all 或自定义分组）
  • 计算后端：COMPUTE_BACKEND、MAX_WORKERS、HIGH_PRIORITY_TOP_N、INDICATORS_ENABLED/INDICATORS_DISABLED
  • 展示过滤：BINANCE_API_DISABLED、DISABLE_SINGLE_TOKEN_QUERY、`SNAPSHOT_HIDDEN_FI