内容
ge/whale-data
MCP 服务器，暴露 **Predge Whale Data** x402 API（Pol 鲸鱼交易 +资金信号）作为工具在**后台处理**付费工具调用都402 客户端签署 US支付 — 代理只需调用获取数据。您需要提供一个已充值的买家密钥。
> **默认为 Base 主实时 Predge API 仅网）。付费工具花费**真实 USDC** — 通常为.005–$0.03/次调用，硬上限为_PRICE_USD`（默认为 $0.05）**在任何之前**。请使用专余额的买家钱包。
## 安装（一条命令）
**Claude 代码：**
```bash
claude mcp add predge-whale-data \
-e BUYER_PRIVATE_KEY=0x您的已充值_Base_主网密钥 \
-e X402_NETWORK=base \
-- npx -y @predge/whale-data-mcp
```
**Claude Desktop / Cursor / 任意 MCP 客户端** — 将以下内容添加到客户端的 MCP 配置中：
```json
{
"mcpServers": {
"predge-whale-data": {
"command": "npx",
"args": ["-y", "@predge/whale-data-mcp"],
"env": {
"BUYER_PRIVATE_KEY": "0x您的已充值_Base_主网密钥",
"X402_NETWORK": "base"
}
}
}
}
```
就这样 — 代理获取 **8 个工具**（7 个付费路由 + 1 个免费发现工具）。无需 API 密钥，无需账户；买家密钥按调用次数在 Base 上支付 USDC。用几美元的 USDC 为其充值（促进者支付 gas，因此无需 ETH）。
## 工具列表
| 工具 | 价格 | 返回值 |
|---|---|---|
| `predge_list_endpoints` | **免费 API 描述 + 每个端价格/模式（需先 |
| `predge_latest` | 约 $0 | 最新鲸鱼交易10k（15 分钟参数：`limit`（1-100） |
| `predge_whale_market` | 约 $0.01 | 单个市场的 7 天鲸鱼活动。参数：`condition_id` |
| `predge_signals_daily` | 约 $0.02 | 24 小时摘要：热门市场、净流量、最大赌注 |
| `predge_wallets_leader | 约 $0.01实现胜率排列的钱包。参数：`window`（7d\|30d），`limit` |
| `predge_wallet_profile` | 约 $0.01 |评分、胜率、类别、最近 20 笔交易。参数：`address` |
| `predge_markets_movers` | 约 $0.005 | 最大的 YES 价格变动。参数：`window`（1h\|6h\|24h） |
| `predge_signals_consensus` | 约 $0.03 | 智能资金（评分 > 70）净流量 + 每个市场的方向 |
每个付费结果都包含一个带有链上结算交易哈希的注释 配置（环境变量）
| 变量 | 默认值 | 备注 |
|---|---|---|
| `BUYER_PRIVATE_KEY` | — | **付费工具必填**。已充值的密钥。免费的 `predge_list_endpoints` 工具无需该密钥。 |
| `X402_NETWORK` | `base` | `base` = 主网（真实 USDC）。`base-sepolia` 仅适用于测试网部署（参见 `PREDGE_BASE_URL`）。 |
| `PREDGE_BASE_URL` | 生产 API | `https://x402-api-production-266e.up.railway.app`。覆盖以指向其他部署（例如测试网实例）。 |
| `MAX_PRICE_USD` | `0.05` | 价格高于此在支付前会被 |
| `PREDCP_USER_AGENT` | `predge-whale-data-mcp/0.1.1` | 每次请求都会发送（让 API 归因于 MCP 流量）。 |
### 测试要在无真实资金的情况下流程，请将 `PREDGE_BASE_URL` 指向 Base 部署的 API，并设置402_NETWORK=base-sepol；从 [fauc.com](https://faucet.circle.com) 为买家充值。（公共 仅限主网，因此测试网需要您自己的部署。）
## 安全
- **价格上限** — 在支付选择强制执行 `MAX_PRICE_USD`，因此在任何资金转移之前，超过上限的调用都会被拒绝（不会浪费请求）。
- **网络 客户端仅在网络上支付要求；它不会在测试网模式下意外结算主网要求（或反之亦然）。
- **环境变量之外的密钥处理** — 服务器从环境变量中读取 `BUYER_PRIVATE_KEY`，从不记录它，并且只将其发送到本地签名器。使用专用的低余额钱包，并将密钥排除在版本控制之外。
## 从源码运行
```bash
git clone https://github.com/pAI/whale-data-mcp.git
cd whale-data-mcp && npm install && npm run build
# 然后将您的 MCP 客户端的 "command" 指向 node，参数为abs/path/-mcp/dist/index```
## 在本地验证
```bash
npm run inspect 列出工具（无支付）
node dist/dev-list-tools.js pred_endpoints # 生产环境
# 付费调用（在主网上花费真实 USDC）：
BUYER=0x… X402_NETWORK node dist/dev-list-tools.js predge_whales_latest '{"limit":2}'
```
