Skip to content

liji3597/nancy-alpha

Repository files navigation

Nancy's Alpha - 南希严选

Polymarket 政治预测市场链上大单监控与 AI 内幕分析系统

项目简介

Nancy's Alpha 是一个实时监控 Polymarket 政治预测市场的 Web3 应用,通过链上数据分析和 AI 画像系统,帮助用户发现聪明钱动向和潜在内幕交易信号。

技术架构

┌─────────────────────────────────────────────────────────────────┐
│                        Nancy's Alpha                             │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌──────────────────────┐     ┌──────────────────────────────┐  │
│  │      Frontend        │     │         Backend              │  │
│  │   (Next.js 14)       │────▶│      (FastAPI + Python)      │  │
│  │                      │     │                              │  │
│  │  • Dashboard         │     │  • REST API                  │  │
│  │  • Markets View      │     │  • AI Analyzer (Claude API)  │  │
│  │  • Traders Profile   │     │  • Chain Listener            │  │
│  │  • Whale Alerts      │     │  • Insider Detection         │  │
│  └──────────────────────┘     └──────────────────────────────┘  │
│           │                              │                       │
│           ▼                              ▼                       │
│  ┌──────────────────────┐     ┌──────────────────────────────┐  │
│  │   Vercel (前端)       │     │   Railway/Render (后端)      │  │
│  │   + Edge Functions   │     │   + PostgreSQL               │  │
│  └──────────────────────┘     └──────────────────────────────┘  │
│                                          │                       │
│                                          ▼                       │
│                              ┌──────────────────────────────┐   │
│                              │     External Services        │   │
│                              │  • Polygon RPC (链上数据)     │   │
│                              │  • Gamma API (市场元数据)     │   │
│                              │  • DeepSeek API (AI分析)       │   │
│                              └──────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘

技术栈

层级 技术
Frontend Next.js 14, Tailwind CSS, RainbowKit, Recharts
Backend FastAPI, SQLAlchemy (Async), Web3.py
Database PostgreSQL
AI DeepSeek API
Blockchain Polygon RPC, Polymarket CTF Exchange

快速开始

环境要求

  • Python 3.11+
  • Node.js 18+
  • PostgreSQL 14+
  • 有效的 Polygon RPC URL
  • DeepSeek API Key (用于 AI 分析)

安装步骤

1. 克隆仓库

git clone https://github.com/liji3597/nancy-alpha.git
cd nancy-alpha

2. 后端设置

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 填入配置

# 启动数据库 (Docker)
docker-compose up -d

# 同步市场数据
python -m src.main sync-markets

# 启动后端服务
python -m src.main serve

3. 前端设置

cd src/frontend

# 安装依赖
npm install

# 配置环境变量
cp .env.example .env.local
# 设置 NEXT_PUBLIC_API_URL=http://localhost:8000

# 启动开发服务器
npm run dev

运行命令

# 后端 (在根目录)
python -m src.main serve              # 启动 API 服务 (端口 8000)
python -m src.main sync-markets       # 同步市场数据
python -m src.main listen             # 启动链上监听
python -m src.main fast-backfill 5000 # 快速回填交易数据
python -m src.main ai-profile 50      # 批量 AI 画像分析

# 前端 (在 src/frontend 目录)
npm run dev      # 开发模式 (端口 3000)
npm run build    # 生产构建

功能说明

核心功能

功能 描述
🐋 巨鲸监控 实时追踪 >$10,000 的大单交易
🧠 AI 交易者画像 智能分析交易者行为模式和风险偏好
📊 市场情报 政治预测市场实时价格和趋势
🚨 内幕分析 结合新闻时间线的异常交易检测
💼 聪明钱追踪 高胜率交易者识别与跟单参考

API 端点

端点 方法 描述
/api/health GET 健康检查
/api/whales/live GET 实时巨鲸交易
/api/markets GET 市场列表
/api/traders/leaderboard GET 交易者排行榜
/api/traders/{address}/ai-analyze POST AI 画像分析
/api/insider/alerts GET 内幕警报列表

数据来源

数据类型 来源 获取方式
链上交易 Polygon Chain Web3.py + RPC 轮询 OrderFilled 事件
市场元数据 Gamma API REST API 获取 clobTokenIds 等
市场价格 Polymarket CLOB Gamma API 实时价格
AI 分析 Claude API Anthropic SDK 调用

关键合约

  • CTF Exchange: 0x4bFb41d5B3570DeFd03C39a9A4D8dE6Bd8B8982E
  • 监听事件: OrderFilled(bytes32,address,address,uint256,uint256,uint256,uint256,uint256)

项目结构

nancy-alpha/
├── README.md              # 项目说明文档
├── DEMO.md                # 演示说明和截图
├── src/                   # 源代码目录
│   ├── api/               # REST API 路由
│   ├── indexer/           # 链上监听模块
│   │   ├── listener.py    # 交易监听器
│   │   ├── discovery.py   # 市场发现
│   │   └── decoder.py     # 事件解码
│   ├── profiler/          # 画像分析模块
│   │   ├── analyzer.py    # 基础画像
│   │   └── ai_analyzer.py # AI 画像
│   ├── agent/             # 内幕分析模块
│   ├── frontend/          # Next.js 前端
│   │   ├── app/           # 页面路由
│   │   ├── components/    # React 组件
│   │   ├── lib/           # API 客户端
│   │   └── package.json   # 前端依赖
│   ├── models.py          # 数据模型
│   ├── db.py              # 数据库连接
│   └── main.py            # 入口文件
├── requirements.txt       # Python 依赖
├── .env.example           # 环境变量示例
├── docker-compose.yml     # Docker 配置
├── data/                  # 示例数据
└── screenshots/           # 运行截图

团队成员

  • Jese li
  • Axon
  • 短毛熊233
  • Denice

License

MIT License - Copyright (c) 2026 liji3597

About

Nancy's Alpha 是一个实时监控 Polymarket 政治预测市场的 Web3 应用,通过链上数据分析和 AI 画像系统,帮助用户发现聪明钱动向和潜在内幕交易信号。

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors