Polymarket API

按关键词和排序检索 Polymarket 的市场与事件，给每个结果的价格（可读作市场给的概率）、成交额、流动性和结算结果，并能按市场列出最近的链上成交。调用 POST /api/v1/social ；返回结构化 JSON，$6.81 / 千次；失败不计费。

免费开始文档

平台运行状态

24h 健康值: 正常

正常

30 天趋势

Polymarket 能力清单

能力	做什么	单价	24 小时运行状态
市场列表`markets`	用 markets 按标题关键词和排序检索 Polymarket 市场，一次最多 100 个。	$6.81 / 千次	正常
事件列表`events`	用 events 检索事件，每个事件带最多 10 个下属市场。	$6.81 / 千次	正常
成交记录`trades`	用 trades 按市场列最近的链上成交，从新到旧、一次最多 100 笔。	$6.81 / 千次	正常

点能力名进它的文档：参数、返回字段、代码示例和试用。

Polymarket 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。请求都发到 POST /api/v1/social，切换 action 时，也要按对应接口调整参数。同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

能力	必填参数	可选参数	单次条数	模式	单价	返回字段
markets	—	keyword, sort, status	默认 20 · 最多 100	同步	$6.81 / 千次	id · condition_id · slug · url · title · description · status · winning_outcome · outcomes · volume_usd · liquidity_usd · volume_24h_usd · volume_7d_usd · trades_24h · tags · event_id · event_slug · event_title · image_url · start_at · end_at · closed_at · created_at · platform
events	—	category, keyword, sort, status	默认 20 · 最多 100	同步	$6.81 / 千次	id · slug · url · title · description · tags · status · market_count · volume_usd · liquidity_usd · open_interest_usd · volume_24h_usd · trade_count · resolution_source · image_url · start_at · end_at · closed_at · created_at · markets · platform
trades	market	—	默认 50 · 最多 100	同步	$6.81 / 千次	tx_hash · order_hash · side · outcome · price · shares · amount_usd · fee_usd · traded_at · market_slug · condition_id · token_id · title · maker_wallet · taker_wallet · platform

怎么调用 Polymarket 市场列表 API？

markets

使用 platform="polymarket"、action="markets" 调用“市场列表”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、condition_id、slug、url、title、description 等 24 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

Polymarket markets 的参数分别是什么意思？

keyword可选: 在市场或事件标题里搜的词，至少 3 个字，例如 bitcoin、election；不传按排序列全站。
sort可选: volume（默认，累计成交额）、open_interest、price_desc、price_asc、expiration（快到期的在前）、created（新建的在前）、volume_1d、volume_7d、trades_1d。
查看全部 9 个允许值
createdexpirationopen_interestprice_ascprice_desctrades_1dvolumevolume_1dvolume_7d
status可选: open（还在交易）或 closed（已结束）；不传两种都有。
查看全部 2 个允许值
closedopen

Polymarket 返回字段与含义（18）

id: 市场或事件的 Polymarket ID（字符串）。
condition_id: 市场在链上的 condition ID（0x 开头）；可作为 trades 的 market。
slug: 市场或事件在 Polymarket 链接里的短名；市场 slug 可作为 trades 的 market。
status: open（还在交易）或 closed（已结束）。
winning_outcome: 已结算市场赢的那一边（如 Yes）；没结算时没有。
outcomes: 可买的结果，每项 label、token_id、price（0–1 的价格，可读作市场给的概率；结算后赢的一边为 1）。
volume_usd: 累计成交额，美元。
liquidity_usd: 当前挂单流动性，美元。
volume_24h_usd: 近 24 小时成交额，美元。
volume_7d_usd: 近 7 天成交额，美元（markets）。
trades_24h: 近 24 小时成交笔数（markets）。
event_id: 所属事件 ID（markets）。
event_slug: 所属事件短名（markets）。
event_title: 所属事件标题（markets）。
tags: 标签列表；没有时没有这个字段。
start_at: 开始时间，ISO 8601 UTC。
end_at: 计划结束时间，ISO 8601 UTC。
closed_at: 实际关闭时间，ISO 8601 UTC；没关闭时没有。

怎么调用 Polymarket 事件列表 API？

events

使用 platform="polymarket"、action="events" 调用“事件列表”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、slug、url、title、description、tags 等 21 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

Polymarket events 的参数分别是什么意思？

category可选: 事件分类，例如 Crypto、Sports、Politics（events）。
keyword可选: 在市场或事件标题里搜的词，至少 3 个字，例如 bitcoin、election；不传按排序列全站。
sort可选: created（默认，新建的在前）、start_date、end_date、volume_1d、volume_7d、volume_all_time、open_interest、trades_1d。
查看全部 8 个允许值
createdend_dateopen_intereststart_datetrades_1dvolume_1dvolume_7dvolume_all_time
status可选: open（还在交易）或 closed（已结束）；不传两种都有。
查看全部 2 个允许值
closedopen

Polymarket 返回字段与含义（15）

id: 市场或事件的 Polymarket ID（字符串）。
slug: 市场或事件在 Polymarket 链接里的短名；市场 slug 可作为 trades 的 market。
status: open（还在交易）或 closed（已结束）。
volume_usd: 累计成交额，美元。
liquidity_usd: 当前挂单流动性，美元。
volume_24h_usd: 近 24 小时成交额，美元。
tags: 标签列表；没有时没有这个字段。
start_at: 开始时间，ISO 8601 UTC。
end_at: 计划结束时间，ISO 8601 UTC。
closed_at: 实际关闭时间，ISO 8601 UTC；没关闭时没有。
open_interest_usd: 当前未平仓金额，美元（events）。
trade_count: 累计成交笔数（events）。
market_count: 事件下的市场个数（events）。
markets: 事件下的市场（events，最多 10 个），每项 id、condition_id、slug、title、status、outcomes、volume_usd。
resolution_source: 事件写明的结算依据来源（events）。

怎么调用 Polymarket 成交记录 API？

trades

使用 platform="polymarket"、action="trades" 调用“成交记录”能力；返回列表，默认 50 条、单次最多 100 条，主要包含 tx_hash、order_hash、side、outcome、price、shares 等 16 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

Polymarket trades 的参数分别是什么意思？

market必填: 要看成交的市场：slug、condition_id 或市场链接，取自 markets 返回行；按成交时间从新到旧，一次最多 100 笔。
Polymarket 官方文档说明事件是展示给用户的问题、每个市场是一个可结算的二元条件（Yes / No），市场用 slug 和 condition ID 标识，确认 market 可以填 slug 或 condition_id；成交数据来自链上，不是该文档的内容。官方来源：Polymarket 文档：市场与事件来源核查：2026-11-01

Polymarket 返回字段与含义（14）

condition_id: 市场在链上的 condition ID（0x 开头）；可作为 trades 的 market。
tx_hash: 成交所在的链上交易哈希（trades）。
order_hash: 成交对应的订单哈希（trades）。
side: BUY 或 SELL（trades，挂单方视角）。
outcome: 这笔成交买卖的是哪一边（trades），如 Yes 或球队名。
price: 成交价，0–1（trades）。
shares: 成交份数（trades）。
amount_usd: 成交金额，美元（trades）。
fee_usd: 手续费，美元（trades）。
traded_at: 成交时间，ISO 8601 UTC（trades）。
market_slug: 成交所在市场的 slug（trades）。
token_id: 成交的结果代币 ID（trades）。
maker_wallet: 挂单方钱包地址（链上公开）（trades）。
taker_wallet: 吃单方钱包地址（链上公开）（trades）。

一次 Polymarket markets 调用的全过程：向 POST /api/v1/social 发送 platform="polymarket"、action="markets";返回结构化 JSON，含 id、condition_id、slug、url、title 等字段；返回列表，单次最多 100 条，计费 $6.81 / 千次，失败与空结果不计费。

Polymarket 的独有字段名（当前目录）

全站 106 个平台的当前目录中，这 25 个字段名只在 Polymarket 出现。这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

condition_id
winning_outcome
outcomes
volume_usd
liquidity_usd
volume_7d_usd
trades_24h
event_id
event_slug
market_count
open_interest_usd
trade_count
resolution_source
markets
tx_hash
order_hash
side
shares

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。机器可读版：/api/v1/social/fields

id: 市场或事件的 Polymarket ID（字符串）。
condition_id: 市场在链上的 condition ID（0x 开头）；可作为 trades 的 market。
slug: 市场或事件在 Polymarket 链接里的短名；市场 slug 可作为 trades 的 market。
url: 该记录在原平台上的可访问链接。
title: 标题。平台无标题概念时（如纯文本帖）为 null。
description: 简介或描述，通常比 text 短。
status: open（还在交易）或 closed（已结束）。
winning_outcome: 已结算市场赢的那一边（如 Yes）；没结算时没有。
outcomes: 可买的结果，每项 label、token_id、price（0–1 的价格，可读作市场给的概率；结算后赢的一边为 1）。
volume_usd: 累计成交额，美元。
liquidity_usd: 当前挂单流动性，美元。
volume_24h_usd: 近 24 小时成交额，美元。
volume_7d_usd: 近 7 天成交额，美元（markets）。
trades_24h: 近 24 小时成交笔数（markets）。
tags: 标签列表；没有时没有这个字段。
event_id: 所属事件 ID（markets）。
event_slug: 所属事件短名（markets）。
event_title: 所属事件标题（markets）。
image_url: 图片链接。多图能力可能返回 image_urls 数组。
start_at: 开始时间，ISO 8601 UTC。
end_at: 计划结束时间，ISO 8601 UTC。
closed_at: 实际关闭时间，ISO 8601 UTC；没关闭时没有。
created_at: 创建时间，格式同 posted_at。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
market_count: 事件下的市场个数（events）。
open_interest_usd: 当前未平仓金额，美元（events）。
trade_count: 累计成交笔数（events）。
resolution_source: 事件写明的结算依据来源（events）。
markets: 事件下的市场（events，最多 10 个），每项 id、condition_id、slug、title、status、outcomes、volume_usd。
tx_hash: 成交所在的链上交易哈希（trades）。
order_hash: 成交对应的订单哈希（trades）。
side: BUY 或 SELL（trades，挂单方视角）。
outcome: 这笔成交买卖的是哪一边（trades），如 Yes 或球队名。
price: 成交价，0–1（trades）。
shares: 成交份数（trades）。
amount_usd: 成交金额，美元（trades）。
fee_usd: 手续费，美元（trades）。
traded_at: 成交时间，ISO 8601 UTC（trades）。
market_slug: 成交所在市场的 slug（trades）。
token_id: 成交的结果代币 ID（trades）。
maker_wallet: 挂单方钱包地址（链上公开）（trades）。
taker_wallet: 吃单方钱包地址（链上公开）（trades）。

请求填写示例

markets 不需要必填参数，默认按累计成交额列 Polymarket 市场；可加 keyword 按标题找，outcomes 里的 price 可读作市场给的概率。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

polymarket_markets.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"polymarket","action":"markets","params":{}}'

记录字段预览（非真实响应）

仅展示 markets 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json

{
  "id": null,
  "condition_id": null,
  "slug": null,
  "url": null,
  "title": null,
  "description": null,
  "status": null,
  "winning_outcome": null,
  "outcomes": null,
  "volume_usd": null,
  "liquidity_usd": null,
  "volume_24h_usd": null,
  "volume_7d_usd": null,
  "trades_24h": null,
  "tags": null,
  "event_id": null,
  "event_slug": null,
  "event_title": null,
  "image_url": null,
  "start_at": null,
  "end_at": null,
  "closed_at": null,
  "created_at": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

Polymarket 市场 API 如何按关键词查预测市场和概率？

用 markets 按标题关键词和排序检索 Polymarket 市场，一次最多 100 个。

查看 markets 的 keyword 参数

keyword 至少 3 个字；status 选 open、closed；sort 默认按累计成交额，也可按未平仓、价格、到期、新建、近 1 天 / 7 天成交。
outcomes 里每个结果的 price 在 0–1 之间，可读作市场给的概率；已结算市场有 winning_outcome。

Polymarket 事件 API 如何看一个话题下的全部市场？

用 events 检索事件，每个事件带最多 10 个下属市场。

查看 events 的 keyword 参数

keyword、status、sort、category 都可选；sort 默认按新建时间。
每行有 title、description、volume_usd、liquidity_usd、open_interest_usd、market_count 和 markets（下属市场的价格和成交额）。

Polymarket 成交 API 如何看一个市场最近的成交？

用 trades 按市场列最近的链上成交，从新到旧、一次最多 100 笔。

查看 trades 的 market 参数

market 填市场 slug、0x 开头的 condition_id 或市场链接，取自 markets 返回行；认不出的在扣费前被拒。
每行有 side、outcome、price、shares、amount_usd、fee_usd、traded_at、tx_hash 和双方钱包地址（链上公开）。

Polymarket API 常见问题

Polymarket API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="polymarket"、action 和 params。以 markets 为例，必填无参数，可选 keyword、sort、status。markets 不需要必填参数，默认按累计成交额列 Polymarket 市场；可加 keyword 按标题找，outcomes 里的 price 可读作市场给的概率。 Polymarket 共 3 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

Polymarket API 怎么收费？

$6.81 / 千次，Polymarket 全部 3 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 146 次 Polymarket 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Polymarket API 一次能返回多少条数据？

Polymarket 有 3 个列表接口，包括 markets、events、trades。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Polymarket API 返回哪些字段？

当前目录为 markets 列出 id、condition_id、slug、url、title、description 等 24 个字段名。按全站当前目录统计，25 个字段名只在 Polymarket 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

Polymarket 市场 API 如何按关键词查预测市场和概率？

用 markets 按标题关键词和排序检索 Polymarket 市场，一次最多 100 个。 keyword 至少 3 个字；status 选 open、closed；sort 默认按累计成交额，也可按未平仓、价格、到期、新建、近 1 天 / 7 天成交。 outcomes 里每个结果的 price 在 0–1 之间，可读作市场给的概率；已结算市场有 winning_outcome。

Polymarket 事件 API 如何看一个话题下的全部市场？

用 events 检索事件，每个事件带最多 10 个下属市场。 keyword、status、sort、category 都可选；sort 默认按新建时间。每行有 title、description、volume_usd、liquidity_usd、open_interest_usd、market_count 和 markets（下属市场的价格和成交额）。

Polymarket 成交 API 如何看一个市场最近的成交？

用 trades 按市场列最近的链上成交，从新到旧、一次最多 100 笔。 market 填市场 slug、0x 开头的 condition_id 或市场链接，取自 markets 返回行；认不出的在扣费前被拒。每行有 side、outcome、price、shares、amount_usd、fee_usd、traded_at、tx_hash 和双方钱包地址（链上公开）。

可以先免费试用 Polymarket API 吗？

可以。注册免费，在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星，就能在控制台「余额与充值」领取 $1 额度（≈720 次数据调用），直接进赠送余额，不用输码，24 小⁠时内有效。请先选择 Polymarket 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 3 个能力。无需信用卡。

Apple 地图 API Bing 搜索 API Bing 地图 API 公司数据 API 加密行情 API 加密新闻 API DuckDuckGo 搜索 API DuckDuckGo 地图 API 全部 106 平台 ↗

开始调用 Polymarket API

在 GitHub 给两个仓库点星领 $1 额度，注册后在控制台领取，24 小⁠时内有效，先选一个 Polymarket 接口验证结果。

免费开始

Polymarket API

平台运行状态

Polymarket 能力清单

Polymarket 每个接口分别做什么

怎么调用 Polymarket 市场列表 API？

Polymarket markets 的参数分别是什么意思？

怎么调用 Polymarket 事件列表 API？

Polymarket events 的参数分别是什么意思？

怎么调用 Polymarket 成交记录 API？

Polymarket trades 的参数分别是什么意思？

Polymarket 的独有字段名（当前目录）

返回字段含义

请求填写示例

记录字段预览（非真实响应）

常见用例

Polymarket 市场 API 如何按关键词查预测市场和概率？

Polymarket 事件 API 如何看一个话题下的全部市场？

Polymarket 成交 API 如何看一个市场最近的成交？

Polymarket API 常见问题

Polymarket API 怎么调用？

Polymarket API 怎么收费？

Polymarket API 一次能返回多少条数据？

Polymarket API 返回哪些字段？

Polymarket 市场 API 如何按关键词查预测市场和概率？

Polymarket 事件 API 如何看一个话题下的全部市场？

Polymarket 成交 API 如何看一个市场最近的成交？

可以先免费试用 Polymarket API 吗？

更多全网搜索 API

开始调用 Polymarket API