---
title: Polymarket
description: 访问 Polymarket 的预测市场数据
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="polymarket"
  color="#4C82FB"
/>

{/* MANUAL-CONTENT-START:intro */}
[Polymarket](https://polymarket.com) 是一个去中心化的预测市场平台，用户可以利用区块链技术交易未来事件的结果。Polymarket 提供了一个全面的 API，使开发者和代理能够访问实时市场数据、事件列表、价格信息和订单簿统计数据，以支持数据驱动的工作流和 AI 自动化。

通过 Polymarket 的 API 和 Sim 集成，您可以让代理以编程方式检索预测市场信息，探索开放市场及相关事件，分析历史价格数据，并访问订单簿和市场中点。这为研究、自动化分析以及开发能够根据市场价格得出的实时事件概率做出反应的智能代理创造了新的可能性。

Polymarket 集成的主要功能包括：

- **市场列表与筛选：** 列出所有当前或历史预测市场，可按标签筛选、排序并分页查看结果。
- **市场详情：** 通过市场 ID 或 slug 检索单个市场的详细信息，包括其结果和状态。
- **事件列表：** 访问 Polymarket 事件列表及详细事件信息。
- **订单簿与价格数据：** 分析订单簿，获取最新市场价格，查看中点，或获取任何市场的历史价格信息。
- **自动化准备：** 构建能够以编程方式对市场动态、赔率变化或特定事件结果做出反应的代理或工具。

通过使用这些文档化的 API 端点，您可以将 Polymarket 丰富的链上预测市场数据无缝集成到您自己的 AI 工作流、仪表盘、研究工具和交易自动化中。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Polymarket 预测市场集成到工作流程中。可以获取市场、单个市场、事件、单个事件、标签、系列、订单簿、价格、中点、价格历史、最后交易价格、价差、最小变动单位、持仓、交易以及搜索功能。

## 工具

### `polymarket_get_markets`

从 Polymarket 检索预测市场列表，并可选择进行筛选

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `closed` | string | 否 | 按关闭状态筛选 \(true/false\)。使用 false 仅显示活跃市场。 |
| `order` | string | 否 | 排序字段 \(例如，volumeNum, liquidityNum, startDate, endDate, createdAt\) |
| `ascending` | string | 否 | 排序方向 \(true 为升序，false 为降序\) |
| `tagId` | string | 否 | 按标签 ID 筛选 |
| `limit` | string | 否 | 每页结果数量 \(最大 50\) |
| `offset` | string | 否 | 分页偏移量 \(跳过此数量的结果\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `markets` | array | 市场对象数组 |

### `polymarket_get_market`

通过 ID 或 slug 检索特定预测市场的详细信息

#### 输入

| 参数 | 类型 | 是否必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `marketId` | 字符串 | 否 | 市场 ID。如果未提供 slug，则必需。 |
| `slug` | 字符串 | 否 | 市场 slug \(例如，"will-trump-win"\)。如果未提供 marketId，则必需。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `market` | object | 包含详细信息的市场对象 |

### `polymarket_get_events`

从 Polymarket 检索事件列表，可选过滤

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `closed` | string | 否 | 按关闭状态筛选 \(true/false\)。使用 false 仅显示活跃事件。 |
| `order` | string | 否 | 排序字段 \(例如，volume, liquidity, startDate, endDate, createdAt\) |
| `ascending` | string | 否 | 排序方向 \(true 为升序，false 为降序\) |
| `tagId` | string | 否 | 按标签 ID 筛选 |
| `limit` | string | 否 | 每页结果数量 \(最大 50\) |
| `offset` | string | 否 | 分页偏移量 \(跳过此数量的结果\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `events` | 数组 | 事件对象的数组 |

### `polymarket_get_event`

通过 ID 或 slug 检索特定事件的详细信息

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `eventId` | string | 否 | 事件 ID。如果未提供 slug，则必需。 |
| `slug` | string | 否 | 事件 slug \(例如，"2024-presidential-election"\)。如果未提供 eventId，则必需。 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `event` | 对象 | 包含详细信息的事件对象 |

### `polymarket_get_tags`

从 Polymarket 获取用于筛选市场的可用标签

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `limit` | 字符串 | 否 | 每页结果数量 \(最多 50\) |
| `offset` | 字符串 | 否 | 分页偏移量 \(跳过此数量的结果\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `tags` | 数组 | 包含 id、标签和 slug 的标签对象数组 |

### `polymarket_search`

在 Polymarket 上搜索市场、事件和个人资料

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `query` | 字符串 | 是 | 搜索查询词 |
| `limit` | 字符串 | 否 | 每页结果数量 \(最多 50\) |
| `offset` | 字符串 | 否 | 分页偏移量 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `results` | 对象 | 包含市场、事件和个人资料数组的搜索结果 |

### `polymarket_get_series`

从 Polymarket 获取系列（相关市场组）

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `limit` | 字符串 | 否 | 每页结果数量 \(最多 50\) |
| `offset` | 字符串 | 否 | 分页偏移量 \(跳过此数量的结果\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `series` | 数组 | 系列对象的数组 |

### `polymarket_get_series_by_id`

通过 ID 从 Polymarket 检索特定系列（相关市场组）

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `seriesId` | string | 是 | 系列 ID |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `series` | 对象 | 包含详细信息的系列对象 |

### `polymarket_get_orderbook`

检索特定代币的订单簿摘要

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `orderbook` | 对象 | 包含买入和卖出数组的订单簿 |

### `polymarket_get_price`

检索特定代币和方向的市场价格

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |
| `side` | string | 是 | 订单方向：买或卖 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `price` | 字符串 | 市场价格 |

### `polymarket_get_midpoint`

检索特定代币的中间价

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `midpoint` | 字符串 | 中点价格 |

### `polymarket_get_price_history`

检索特定市场代币的历史价格数据

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |
| `interval` | string | 否 | 截止到当前时间的持续时间 \(1m, 1h, 6h, 1d, 1w, max\)。与 startTs/endTs 互斥。 |
| `fidelity` | number | 否 | 数据分辨率（以分钟为单位）\(例如，60 表示每小时\) |
| `startTs` | number | 否 | 开始时间戳 \(Unix 秒 UTC\) |
| `endTs` | number | 否 | 结束时间戳 \(Unix 秒 UTC\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `history` | 数组 | 包含时间戳 \(t\) 和价格 \(p\) 的价格历史条目数组 |

### `polymarket_get_last_trade_price`

检索特定代币的最新交易价格

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `price` | 字符串 | 最新交易价格 |

### `polymarket_get_spread`

检索特定代币的买卖价差

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `spread` | 对象 | 包含买价和卖价的买卖价差 |

### `polymarket_get_tick_size`

检索特定代币的最小跳动单位

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `tokenId` | string | 是 | CLOB 代币 ID \(来自市场 clobTokenIds\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `tickSize` | 字符串 | 最小价格变动单位 |

### `polymarket_get_positions`

从 Polymarket 检索用户持仓

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `user` | string | 是 | 用户钱包地址 |
| `market` | string | 否 | 可选的市场 ID，用于筛选持仓 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `positions` | 数组 | 持仓对象的数组 |

### `polymarket_get_trades`

从 Polymarket 获取交易历史

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `user` | 字符串 | 否 | 用于筛选交易的用户钱包地址 |
| `market` | 字符串 | 否 | 用于筛选交易的市场 ID |
| `limit` | 字符串 | 否 | 每页结果数量 \(最多 50\) |
| `offset` | 字符串 | 否 | 分页偏移量 \(跳过此数量的结果\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `trades` | 数组 | 交易对象的数组 |

## 注意事项

- 类别: `tools`
- 类型: `polymarket`

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `user` | string | 是 | 用户钱包地址（以 0x 开头） |
| `limit` | string | 否 | 返回的最大结果数（例如："50"）。默认值：100，最大值：500。 |
| `offset` | string | 否 | 分页时跳过的结果数（例如："100"）。默认值：0，最大值：10000。 |
| `market` | string | 否 | 以逗号分隔的条件 ID（例如："0x1234...abcd,0x5678...efgh"）。与 eventId 互斥。 |
| `eventId` | string | 否 | 以逗号分隔的事件 ID（例如："12345,67890"）。与 market 互斥。 |
| `type` | string | 否 | 活动类型筛选：TRADE、SPLIT、MERGE、REDEEM、REWARD、CONVERSION、MAKER_REBATE |
| `start` | number | 否 | 起始时间戳（Unix 秒） |
| `end` | number | 否 | 结束时间戳（Unix 秒） |
| `sortBy` | string | 否 | 排序字段：TIMESTAMP、TOKENS 或 CASH（默认：TIMESTAMP） |
| `sortDirection` | string | 否 | 排序方向：ASC 或 DESC（默认：DESC） |
| `side` | string | 否 | 交易方向筛选：BUY 或 SELL（仅适用于交易） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `activity` | array | 活动条目数组 |
|   ↳ `proxyWallet` | string | 用户代理钱包地址 |
|   ↳ `timestamp` | number | 活动的 Unix 时间戳 |
|   ↳ `conditionId` | string | 市场条件 ID |
|   ↳ `type` | string | 活动类型（TRADE、SPLIT、MERGE、REDEEM、REWARD、CONVERSION） |
|   ↳ `size` | number | 代币数量 |
|   ↳ `usdcSize` | number | USDC 数量 |
|   ↳ `transactionHash` | string | 区块链交易哈希 |
|   ↳ `price` | number | 价格（仅限交易） |
|   ↳ `asset` | string | 资产/代币 ID |
|   ↳ `side` | string | 交易方向（BUY/SELL） |
|   ↳ `outcomeIndex` | number | 结果索引 |
|   ↳ `title` | string | 市场标题 |
|   ↳ `slug` | string | 市场 slug |
|   ↳ `icon` | string | 市场图标 URL |
|   ↳ `eventSlug` | string | 事件 slug |
|   ↳ `outcome` | string | 结果名称 |
|   ↳ `name` | string | 用户显示名 |
|   ↳ `pseudonym` | string | 用户昵称 |
|   ↳ `bio` | string | 用户简介 |
|   ↳ `profileImage` | string | 用户头像 URL |
|   ↳ `profileImageOptimized` | string | 优化后的头像 URL |

### `polymarket_get_leaderboard`

按盈亏或成交量获取交易员排行榜排名

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `category` | string | 否 | 分类筛选：OVERALL、POLITICS、SPORTS、CRYPTO、CULTURE、MENTIONS、WEATHER、ECONOMICS、TECH、FINANCE（默认：OVERALL） |
| `timePeriod` | string | 否 | 时间周期：DAY、WEEK、MONTH、ALL（默认：DAY） |
| `orderBy` | string | 否 | 排序方式：PNL 或 VOL（默认：PNL） |
| `limit` | string | 否 | 返回结果数量（如 "10"）。范围：1-50，默认：25。 |
| `offset` | string | 否 | 分页跳过的结果数量（如 "25"）。范围：0-1000，默认：0。 |
| `user` | string | 否 | 按指定用户钱包地址筛选 |
| `userName` | string | 否 | 按用户名筛选 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `leaderboard` | 数组 | 排行榜条目数组 |
|   ↳ `rank` | string | 排行榜排名 |
|   ↳ `proxyWallet` | string | 用户代理钱包地址 |
|   ↳ `userName` | string | 用户显示名称 |
|   ↳ `vol` | number | 交易量 |
|   ↳ `pnl` | number | 盈亏 |
|   ↳ `profileImage` | string | 用户头像 URL |
|   ↳ `xUsername` | string | Twitter/X 用户名 |
|   ↳ `verifiedBadge` | boolean | 用户是否有认证徽章 |

### `polymarket_get_holders`

获取特定市场代币的持有者排行榜

#### 输入

| 参数 | 类型 | 是否必填 | 描述 |
| --------- | ---- | -------- | ----------- |
| `market` | string | 是 | 以逗号分隔的条件 ID 列表（例如："0x1234...abcd" 或 "0x1234...abcd,0x5678...efgh"）。 |
| `limit` | string | 否 | 返回的持有者数量（例如："10"）。范围：0-20，默认值：20。 |
| `minBalance` | string | 否 | 最小持仓门槛（默认值：1） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `holders` | 数组 | 按代币分组的市场持有者数组 |
