mrvlyouknowwho/ton-jetton-risk-api
GitHub: mrvlyouknowwho/ton-jetton-risk-api
TON 链上 Jetton 代币风险快照 API，通过单次 HTTP 调用输出 rug pull、蜜罐和增发风险评分，供交易机器人和交易员在购买前筛查代币。
Stars: 0 | Forks: 0
# TON Jetton 风险 API
一个为 TON jettons (代币) 提供的按次调用风险快照服务。在购买**之前**对代币进行筛查——揪出流动性撤离 (rug)、蜜罐 (honeypot) 和增发陷阱。专为 TON 上的狙击机器人 (sniper bots)、交易机器人 (trading bots) 和交易员打造。
一次 HTTP 调用 → 确定性的风险评分。无需 SDK，无需注册。**前 5 次调用免费。**
📖 **指南：** [如何在购买前识别 TON jetton 流动性撤离 (rug pull)](./GUIDE.md)
## 快速开始
```
# 免费试用（5 次调用，无需支付）：选择任意 secret 字符串作为你的 API key
curl -H "X-Api-Key: my-secret-key" \
"https://mathematical-alice-occupations-permissions.trycloudflare.com/v1/jetton/risk?address=EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs"
```
响应：
```
{
"address": "EQCxE6mU...",
"symbol": "USD₮",
"mintRevoked": false,
"holdersCount": 3305827,
"holders": { "top1Pct": 53.79, "top10Pct": 78.15 },
"liquidity": { "listed": true, "liquidityTier": "very_high", "taxable": false, "blacklisted": false },
"honeypot": { "risk": "low" },
"score": 40,
"flags": ["mint_not_revoked", "admin_present", "holder_concentration_high"],
"_billing": { "mode": "trial", "trialRemaining": 4 }
}
```
`score`：0 (安全) → 100 (危险)。`flags` 解释了具体原因。
## 从 AI agent (MCP) 中使用
有一个 [MCP](https://modelcontextprotocol.io) 服务器将此 API 封装为单个工具，
`assess_jetton_risk(address)` —— 直接将其放入 Claude Desktop、Claude Code 或 Cursor 中：
```
{
"mcpServers": {
"ton-jetton-risk": {
"command": "npx",
"args": ["-y", "github:mrvlyouknowwho/ton-jetton-risk-mcp"],
"env": { "JETTON_RISK_API_KEY": "pick-any-string-for-your-free-trial" }
}
}
}
```
然后只需让你的 agent 根据地址评估 jetton 即可。享受与 HTTP API 相同的免费试用和按次付费。
服务器：**[ton-jetton-risk-mcp](https://github.com/mrvlyouknowwho/ton-jetton-risk-mcp)**。
## 检查项目
| 信号 | 来源 | 重要性说明 |
|---|---|---|
| 增发权限已撤销 | jetton master contract | 如果未撤销，开发者可以无限增发并稀释你的资产 |
| 持有者集中度 (前 1% / 10%) | 链上持有者 | 少数钱包持有大部分供应量 = 存在砸盘风险 |
| 持有者数量 | 链上 | 持有者极少 = 全新/流动性稀薄的代币 |
| DEX 流动性及层级 | STON.fi | 无流动性池/流动性稀薄 = 你可能无法卖出 |
| 可扣税转账 | STON.fi | 隐藏的转账税 = 极有可能是蜜罐 (honeypot) |
| 已被列入黑名单 | STON.fi | 已被 DEX 标记 |
| 蜜罐风险 (启发式算法) | 推导得出 | 根据上述信息得出低/高/未知风险；精确的卖出模拟 (sell-emulation) 已在路线图中 |
## 定价
- **免费：** 每个 API key 前 5 次调用——先试用，后付费。
- **付费：** 每次调用 $0.001 USDT，预付费余额。无需订阅，无需信用卡。
### 如何付费 (TON 网络上的 USDT)
将 USDT (TON 网络) 发送到下方的地址，并在**转账备注 (memo) 中附上你的 API key**。余额会在约 20 秒内自动入账；每次调用扣除 $0.001。
```
Network: TON
Asset: USDT (USD₮, Tether on TON)
Address: UQD6z4gLZ7HQXu3YGF6sre0uZaIsffUflKYJKEyLx8AYj1TN
Comment: ← required: this links the deposit to your key
```
每个响应中的 `_billing` 字段会显示你剩余的试用次数或付费余额。
## Endpoint
`GET /v1/jetton/risk?address=`
- Header：`X-Api-Key: ` (你可以自定义任意密钥字符串)
- `address`：格式规范的 jetton master 地址，采用 `EQ…` / `UQ…` 形式
在任何操作之前都会检查付款状态：未付费/额度用尽的 key 将收到 HTTP `402` 状态码及充值说明——失败不扣费，也不返回数据。
## 示例
请查看 [`examples/`](./examples) 获取 `curl` 和 Python 客户端。
## 状态
公测中。上述信号均已生效。路线图：精确的蜜罐卖出模拟 (sell-simulation)、TRON-USDT 支付、稳定的自定义域名。欢迎提交 Issue 或功能请求。
标签：API, MCP, Python脚本, TON, 加密货币, 区块链安全, 智能合约审计, 逆向工具