USDT Wallet Monitor

钱包管理

不填多维表格链接会自动创建。填了则自动识别，如: https://xxx.larksuite.com/base/L7Zxxx?table=tblYyy

ID 链类型 钱包地址 备注 多维表格 添加时间 操作
4 TRC20 TUrdV2aN1UMbPThis9qdqnGTqZidnwddTY - 已关联 2026-06-19 04:32:26 进入

📘 使用指南 & 功能说明

▼

🎯 项目概述

本项目是一个 USDT 链上交易监控系统，支持 TRC20（波场） 和 ERC20（以太坊） 两条链。核心功能是 实时拉取链上交易数据，自动同步到 飞书多维表格，并通过 Telegram 发送交易通知。

链上API→ 本地DB→ 飞书多维表格→ Telegram通知

📋 首页 — 钱包管理

进入系统后默认显示 钱包管理页，所有操作从这里开始。

1 添加钱包：选择链类型（TRC20/ERC20），输入钱包地址。系统会 自动创建飞书多维表格 并配置好字段，无需手动操作。也可以粘贴已有的多维表格链接。

2 进入按钮：点击任意钱包的 进入 按钮，跳转到该钱包的 交易详情页（仪表盘 / 交易记录 / 日报查询）。

3 同步功能：

  • 同步当天 — 拉取该钱包今天的链上交易并同步到飞书
  • 同步指定日期 — 弹窗选择日期范围，按时间段拉取数据
  • 同步条数 — 指定拉取最近 N 笔交易，适合首次导入历史数据

4 编辑：修改钱包备注或更新多维表格链接。

5 删除：删除钱包时会 同步删除飞书中的多维表格文档，请谨慎操作。

提示 多维表格链接格式：https://xxx.larksuite.com/base/L7Zxxx?table=tblYyy，系统自动识别 app_token 和 table_id。

📊 仪表盘

选择钱包后第一个 Tab，展示该钱包的 6 个统计卡片：

总记录数数据库中该钱包的交易总数
总收入笔数入账（in）方向的交易笔数
总转出笔数出账（out）方向的交易笔数
总收入金额所有入账 USDT 的总和
总转出金额所有出账 USDT 的总和
净流入收入 - 转出，正数绿色，负数红色

下方 最近交易 表格显示最近 50 笔记录，每条后面有 飞书同步状态：✓ 绿色打钩 表示已同步，同步按钮 可手动补推单条。

📝 交易记录

该钱包的 全部交易明细，支持按日期范围筛选。每行显示完整时间、方向、金额、完整地址（发送方/接收方）、状态（已确认/待确认）、交易哈希（可点击跳转区块链浏览器）。

提示 交易哈希可点击，TRC20 跳转到 tronscan.org，ERC20 跳转到 etherscan.io。

📅 日报查询

按指定日期查看该钱包的交易汇总：

  • 当天 收入 笔数与金额
  • 当天 转出 笔数与金额
  • 合计 总笔数 与 净金额（正数绿色 / 负数红色）
  • 下方列出当天全部交易明细

🔄 交易监控（每60秒自动执行）

系统每隔约 60 秒自动轮询所有已添加钱包的链上交易，发现新交易后：

遍历所有钱包→ 拉取最近50笔交易→ 新交易写入DB→ 同步到飞书→ TG通知

去重机制 同一笔交易哈希不会重复写入；飞书写入前也会检查哈希是否已存在，已存在则跳过。

业务价值 无需手动操作，确保链上交易能 实时 被捕获并同步到飞书，同时通过 Telegram 即时推送交易提醒。

📊 每日报表（每天凌晨自动发送）

每天凌晨 0:01 自动生成 前一天的 USDT 交易汇总报表，并发送到 Telegram 群，内容包括：

  • 当天 收入 笔数与金额
  • 当天 转出 笔数与金额
  • 合计 总笔数、净收益（盈利/亏损）
  • 按 链类型 分类统计（TRC20 / ERC20）
  • 最多 20 笔 交易明细

业务价值 无需登录系统，每天早上打开 Telegram 即可快速了解前一天的整体资金变动情况。

🔔 Telegram 通知

每当一条交易 首次成功同步到飞书多维表格，系统会向配置的 TG 群发送实时通知，内容包括：

  • 交易方向（收入 / 转出）
  • 金额 (USDT)
  • 链类型（波场TRC20 / 以太坊ERC20）
  • 交易时间
  • 监控钱包地址
  • 发送方和接收方地址
  • 交易哈希

配置项在 .env 中：TELEGRAM_BOT_TOKEN、TELEGRAM_CHAT_ID。

🏗️ 飞书开发者配置（必读）

本系统需要调用飞书开放平台 API 来创建多维表格、写入数据 和 转移文档所有权。以下是完整开通步骤：

1 进入飞书开发者后台

打开 https://open.feishu.cn/app，登录你的飞书账号，点击 「创建企业自建应用」。

2 获取 App ID 和 App Secret

创建应用后，在应用首页的 「凭证与基础信息」 中可看到：

App ID填入 .env 的 FEISHU_APP_ID
App Secret填入 .env 的 FEISHU_APP_SECRET

3 开通权限（关键步骤）

进入应用左侧菜单 「权限管理」，搜索并开通以下权限：

权限名称 用途 重要程度
bitable:app 创建 / 管理多维表格 必须
docs:permission.member:create 添加协作者到文档 必须
docs:permission.setting 读取文档权限设置 必须
docs:permission.setting:write_only 修改文档权限设置（转移所有者） 必须
drive:drive 在云空间创建文件夹 必须

注意 开通后需要 点击「批量开通」，然后 发布新版本 才能生效！否则 API 会返回 no permission 错误。

4 发布应用

左侧菜单 「应用发布」 → 「创建版本」 并提交审核。企业自建应用通常 自动通过，无需等待。