> ## 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 个端点

> MetEngine Data Agent 的所有端点，按平台分类，包含定价等级、参数和已知问题。

覆盖三个平台的 74 个端点。每个表格展示 HTTP 方法、路径、定价等级和关键参数。

完整的参数规范、响应结构和回退策略，请参阅[完整技能规范](https://www.metengine.xyz/skill.md)。

## 定价等级

| 等级     | 基础费用   | 说明              |
| ------ | ------ | --------------- |
| 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 个端点）

<Frame>
  <video controls playsInline className="w-full rounded-xl" src="https://metengine-pnl-cards.s3.eu-central-1.amazonaws.com/agent/final-poly.mp4" />
</Frame>

基于 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 已知问题

<Warning>
  **在您的代理中需要处理的已知问题：**

  * `/markets/opportunities` 经常返回 504。回退方案为 `/markets/high-conviction`。
  * `/trades/whales` 包含 REDEEM 交易（结算赔付）。如果只需要活跃交易，请按 `side=BUY` 或 `side=SELL` 过滤。
  * 钱包地址必须为小写十六进制。交易者地址不区分大小写。
</Warning>

***

## Hyperliquid（18 个端点）

<Frame>
  <video controls playsInline className="w-full rounded-xl" src="https://metengine-pnl-cards.s3.eu-central-1.amazonaws.com/agent/hl-new.mp4" />
</Frame>

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 已知问题

<Warning>
  **在您的代理中需要处理的已知问题：**

  * 趋势和信号端点使用 `timeframe=24h` 通常返回空数据。回退方案为 `timeframe=7d`。
  * `/long-short-ratio` 可能返回零值。如需要，可从 `/trades/whales` 重新构建。
  * `/traders/profile` 间歇性出现 500 错误。使用排行榜端点加 `/traders/pnl-by-coin` 作为替代方案。
</Warning>

***

## Meteora（18 个端点）

<Frame>
  <video controls playsInline className="w-full rounded-xl" src="https://metengine-pnl-cards.s3.eu-central-1.amazonaws.com/agent/meteora-demo.mp4" />
</Frame>

覆盖 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 已知问题

<Warning>
  **在您的代理中需要处理的已知问题：**

  * 新上线项目的 DAMM v2 手续费率可能看起来不合理（交易量的 30-50%）。这是数据异常，并非真实手续费。
  * `/pools/trending` 可能返回重复的池子条目。请按 `pool_address` 去重。
  * `/lps/top?sort_by=fees` 可能返回 500。回退方案为 `sort_by=volume`。
  * DLMM 事件使用 PascalCase 字段名；DAMM v2 事件使用 snake\_case。
</Warning>

***

## 性能

| 指标      | 数值       |
| ------- | -------- |
| 中位延迟    | 800ms    |
| p95 延迟  | 3s       |
| p99 延迟  | 8s       |
| 超时      | 60s（不收费） |
| 最大并发请求数 | 50       |

交易数据亚分钟级更新。钱包评分每日重新计算。

## 健康检查

免费，无需付费：

```
GET https://agent.metengine.xyz/health
```

返回服务状态、后端健康状况和 facilitator 运行状态。

## 完整规范

<Card title="skill.md" icon="file-code" href="https://www.metengine.xyz/skill.md">
  包含所有参数、响应结构、回退策略和评分模型详情的完整规范。
</Card>