Documentation Index
Fetch the complete documentation index at: https://docs.metengine.xyz/llms.txt
Use this file to discover all available pages before exploring further.
覆盖三个平台的 74 个端点。每个表格展示 HTTP 方法、路径、定价等级和关键参数。
完整的参数规范、响应结构和回退策略,请参阅完整技能规范。
定价等级
| 等级 | 基础费用 | 说明 |
|---|
| Light | $0.01 | 简单查询和搜索 |
| Medium | $0.02 | 热门趋势、聚合数据、动态信息流 |
| Heavy | $0.05 | 评分、排行榜、内部人检测 |
| Whale | $0.08 | 多实体对比、机会扫描 |
倍率适用于时间范围(1 小时为 0.5 倍至全部时间为 5.0 倍)、结果数量限制和过滤器移除。每次请求费用在 0.01到0.20 之间。
免费定价端点:GET https://agent.metengine.xyz/api/v1/pricing
Polymarket(38 个端点)
基于 Polygon 的预测市场情报。钱包地址必须为小写。condition_id 标识市场;token_id 标识结果。价格表示隐含概率(0 到 1)。
市场发现
| 方法 | 路径 | 等级 | 说明 |
|---|
| GET | /api/v1/markets/trending | Medium | 近期交易量最高的市场 |
| GET | /api/v1/markets/search | Light | 按关键词、分类、状态搜索市场 |
| GET | /api/v1/markets/categories | Light | 列出分类及可选的交易量统计 |
| GET | /api/v1/markets/similar | Whale | 与指定 condition_id 相似的市场 |
| GET | /api/v1/markets/resolutions | Light | 最近已结算的市场 |
| GET | /api/v1/markets/closing-soon | Light | 在指定时间窗口内即将关闭的市场(1-72 小时) |
聪明钱情报
| 方法 | 路径 | 等级 | 说明 |
|---|
| POST | /api/v1/markets/intelligence | Heavy | 市场的完整聪明钱分析 |
| POST | /api/v1/markets/insiders | Heavy | 检测市场上的内部人模式钱包 |
| GET | /api/v1/markets/high-conviction | Heavy | 聪明钱包集中的市场 |
| GET | /api/v1/markets/opportunities | Whale | 多信号机会扫描器(上限 $0.15) |
| GET | /api/v1/markets/dumb-money | Medium | 低评分钱包在市场上的活动 |
交易与资金流
| 方法 | 路径 | 等级 | 说明 |
|---|
| GET | /api/v1/markets/trades | Light | 市场交易流 |
| GET | /api/v1/trades/whales | Medium | 所有市场的大额交易 |
| GET | /api/v1/markets/capital-flow | Medium | 按分类的资金流向 |
| GET | /api/v1/markets/volume-heatmap | Medium | 各市场的交易量分布 |
价格与情绪
| 方法 | 路径 | 等级 | 说明 |
|---|
| GET | /api/v1/markets/price-history | Light | 市场的 OHLCV 时间序列 |
| POST | /api/v1/markets/sentiment | Medium | 随时间变化的买卖情绪 |
| POST | /api/v1/markets/participants | Medium | 市场参与者分析 |
钱包画像
| 方法 | 路径 | 等级 | 说明 |
|---|
| POST | /api/v1/wallets/profile | Heavy | 完整档案:PnL、持仓、活动 |
| POST | /api/v1/wallets/activity | Medium | 钱包的近期交易 |
| POST | /api/v1/wallets/pnl-breakdown | Medium | 钱包按市场的 PnL 明细 |
| POST | /api/v1/wallets/compare | Whale | 钱包并排对比 |
| POST | /api/v1/wallets/copy-traders | Whale | 查找跟单指定钱包的钱包(上限 $0.12) |
信号与资金流
| 方法 | 路径 | 等级 | 说明 |
|---|
| GET | /api/v1/markets/smart-signals | Heavy | 每个市场的聪明钱包聚合方向信号 |
| POST | /api/v1/markets/smart-flow | Medium | 聪明钱累积与分配时间序列 |
| GET | /api/v1/markets/new-smart-interest | Heavy | 首次出现聪明钱包持仓的市场 |
| GET | /api/v1/markets/dumb-consensus | Heavy | 全局愚蠢资金共识(反向指标) |
| GET | /api/v1/markets/capital-flow-comparison | Medium | 多时间框架资金流对比(板块轮动) |
| GET | /api/v1/markets/early-movers | Medium | 市场的最早买入者 |
| GET | /api/v1/markets/ownership | Medium | 市场的代币所有权分布 |
| GET | /api/v1/markets/volume-by-group | Medium | 按分类、小时或天分组的交易量及周期对比 |
排行榜
| 方法 | 路径 | 等级 | 说明 |
|---|
| GET | /api/v1/wallets/top-performers | Heavy | 按夏普比率、ROI、胜率排名 |
| GET | /api/v1/wallets/niche-experts | Heavy | 特定分类中的顶级钱包 |
| GET | /api/v1/wallets/alpha-callers | Heavy | 在后续热门市场中提前交易的钱包 |
| GET | /api/v1/wallets/insiders | Heavy | 具有内部人模式行为的钱包 |
| GET | /api/v1/wallets/insiders/trend | Medium | 内部人活动随时间的趋势 |
| POST | /api/v1/wallets/portfolio | Whale | 监控钱包列表的聚合投资组合视图 |
| GET | /api/v1/platform/stats | Light | 平台级别的交易量和市场数量 |
Polymarket 已知问题
在您的代理中需要处理的已知问题:
/markets/opportunities 经常返回 504。回退方案为 /markets/high-conviction。
/trades/whales 包含 REDEEM 交易(结算赔付)。如果只需要活跃交易,请按 side=BUY 或 side=SELL 过滤。
- 钱包地址必须为小写十六进制。交易者地址不区分大小写。
Hyperliquid(18 个端点)
Hyperliquid L1 上的永续合约分析。PnL 仅为已实现(不含未实现)。聪明钱评分阈值为 85+(比 Polymarket 的 60 更严格)。币种符号为大写基础币种(BTC,而非 BTC-USDC)。
平台与币种
| 方法 | 路径 | 等级 | 说明 |
|---|
| GET | /api/v1/hl/platform/stats | Light | 平台级别统计 |
| GET | /api/v1/hl/coins/trending | Medium | 交易量飙升最多的币种 |
| GET | /api/v1/hl/coins/list | Light | 所有追踪的币种 |
| GET | /api/v1/hl/coins/volume-heatmap | Medium | 各币种的交易量分布 |
交易者情报
| 方法 | 路径 | 等级 | 说明 |
|---|
| GET | /api/v1/hl/traders/leaderboard | Heavy | 按 PnL、ROI、交易量、胜率排名的交易者 |
| POST | /api/v1/hl/traders/profile | Heavy | 完整交易者档案及交易历史 |
| POST | /api/v1/hl/traders/compare | Whale | 交易者并排对比 |
| GET | /api/v1/hl/traders/daily-pnl | Medium | 每日 PnL 时间序列 |
| POST | /api/v1/hl/traders/pnl-by-coin | Medium | 按币种的 PnL 明细 |
| GET | /api/v1/hl/traders/fresh-whales | Heavy | 新的大额账户(潜在内部人) |
交易与压力
| 方法 | 路径 | 等级 | 说明 |
|---|
| GET | /api/v1/hl/trades/whales | Medium | 所有币种的大额交易 |
| GET | /api/v1/hl/trades/feed | Light | 特定币种的近期交易流 |
| GET | /api/v1/hl/trades/long-short-ratio | Medium | 多空交易量比率随时间变化 |
| GET | /api/v1/hl/pressure/pairs | Heavy | 特定币种的买卖压力 |
| GET | /api/v1/hl/pressure/summary | Medium | 全市场压力概览 |
聪明钱包
| 方法 | 路径 | 等级 | 说明 |
|---|
| GET | /api/v1/hl/smart-wallets/list | Light | 所有追踪的聪明钱包 |
| GET | /api/v1/hl/smart-wallets/activity | Medium | 近期聪明钱包交易 |
| GET | /api/v1/hl/smart-wallets/signals | Heavy | 按币种的聚合方向信号 |
Hyperliquid 已知问题
在您的代理中需要处理的已知问题:
- 趋势和信号端点使用
timeframe=24h 通常返回空数据。回退方案为 timeframe=7d。
/long-short-ratio 可能返回零值。如需要,可从 /trades/whales 重新构建。
/traders/profile 间歇性出现 500 错误。使用排行榜端点加 /traders/pnl-by-coin 作为替代方案。
Meteora(18 个端点)
覆盖 DLMM 和 DAMM v2 池类型的 Solana LP 分析。地址为 base58 格式的 Solana 公钥(区分大小写)。在适用的地方指定 pool_type=dlmm 或 pool_type=damm_v2。
池子发现
| 方法 | 路径 | 等级 | 说明 |
|---|
| GET | /api/v1/meteora/pools/trending | Medium | 交易量飙升最多的池子 |
| GET | /api/v1/meteora/pools/top | Medium | 按流动性、交易量或手续费排名的顶级池子 |
| GET | /api/v1/meteora/pools/search | Light | 按代币名称或地址搜索池子 |
| GET | /api/v1/meteora/pools/detail | Medium | 特定池子的完整详情 |
| GET | /api/v1/meteora/pools/smart-wallet | Heavy | 聪明钱包参与度最高的池子 |
池子分析
| 方法 | 路径 | 等级 | 说明 |
|---|
| GET | /api/v1/meteora/pools/volume-history | Light | 池子的交易量时间序列 |
| GET | /api/v1/meteora/pools/events | Light | 近期存入/提取/领取事件 |
| GET | /api/v1/meteora/pools/fee-analysis | Medium | 手续费领取模式和费率 |
LP 情报
| 方法 | 路径 | 等级 | 说明 |
|---|
| GET | /api/v1/meteora/lps/top | Heavy | 按交易量、事件数或池子数量排名的顶级 LP |
| POST | /api/v1/meteora/lps/profile | Heavy | 完整 LP 档案及持仓和历史 |
| GET | /api/v1/meteora/lps/whales | Medium | 大额 LP 存入和提取 |
| POST | /api/v1/meteora/lps/compare | Whale | LP 并排对比 |
仓位与平台
| 方法 | 路径 | 等级 | 说明 |
|---|
| GET | /api/v1/meteora/positions/active | Medium | 池子或钱包的活跃仓位 |
| GET | /api/v1/meteora/positions/history | Light | 特定仓位的事件历史 |
| GET | /api/v1/meteora/platform/stats | Light | 平台级别 LP 统计 |
| GET | /api/v1/meteora/platform/volume-heatmap | Medium | 各池子的交易量分布 |
| GET | /api/v1/meteora/platform/metengine-share | Light | MetEngine 在平台交易量中的占比 |
| GET | /api/v1/meteora/dca/pressure | Medium | 代币的 DCA 累积强度 |
Meteora 已知问题
在您的代理中需要处理的已知问题:
- 新上线项目的 DAMM v2 手续费率可能看起来不合理(交易量的 30-50%)。这是数据异常,并非真实手续费。
/pools/trending 可能返回重复的池子条目。请按 pool_address 去重。
/lps/top?sort_by=fees 可能返回 500。回退方案为 sort_by=volume。
- DLMM 事件使用 PascalCase 字段名;DAMM v2 事件使用 snake_case。
| 指标 | 数值 |
|---|
| 中位延迟 | 800ms |
| p95 延迟 | 3s |
| p99 延迟 | 8s |
| 超时 | 60s(不收费) |
| 最大并发请求数 | 50 |
交易数据亚分钟级更新。钱包评分每日重新计算。
健康检查
免费,无需付费:
GET https://agent.metengine.xyz/health
返回服务状态、后端健康状况和 facilitator 运行状态。
完整规范
skill.md
包含所有参数、响应结构、回退策略和评分模型详情的完整规范。