Friends Data API独立数据服务

DECISION MODEL DATA · 金融市场与预测市场

Polymarket

预测市场合约、赔率和部分结算状态记录。

API 调用说明

能回答的问题

  • 某个合约的选项和报价是什么?
  • 合约关闭状态与正式结算证据有什么区别?

状态与已知缺口

部分可用

已有合约目录和赔率数据,另有部分原始结算记录;不宣称完整争议与撤销历史。

  • 关闭标志和极端赔率不等于正式结算。
  • 部分目录归档暂不提供逐行读取。
  • 指定历史事件的逐条件结算记录尚未全部提供。

提供方

PRODUCT

Polymarket CLOB 结算状态样本

polymarket_clob_resolution

每行是 CLOB 接口中的合约对象,结果代币信息位于 tokens;不依据赔率补造结算。

粒度
每条件每快照一行
时间范围
2026-10-04 ~ 2026-10-04 · 合约结束时间及原始状态
采集时间
2026-10-04T07:55:33.836353Z ~ 2026-10-04T07:55:33.836353Z
记录数
1

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=polymarket_clob_resolution&limit=100

字段表 · 29 个字段

字段名中文说明
accepting_order_timestamp原始开始接单时间
accepting_orders是否接受订单
active平台活跃状态标记
archived平台归档状态标记
closed原始合约关闭标记,不单独证明正式结算
condition_id预测合约条件标识
description原始描述或摘要
enable_order_book是否启用订单簿
end_date_iso原始结束时间标签
fpmm原始 FPMM 属性
game_start_time原始赛事开始时间
icon图标链接
image图片链接
is_50_50_outcome平台原始 50/50 结果标记
maker_base_fee原始挂单方基础费率
market_slug合约短名
minimum_order_size最小订单规模
minimum_tick_size价格最小变动单位
neg_risk平台原始负风险属性
neg_risk_market_id负风险市场标识
neg_risk_request_id负风险请求标识
notifications_enabled通知启用标记
question原始预测问题
question_id问题标识
rewards原始奖励规则对象
seconds_delay原始延迟秒数参数
tags原始标签
taker_base_fee原始成交方基础费率
tokens结果代币数组,包含可用 token_id、outcome、price 与 winner 字段

PRODUCT

Polymarket 已关闭合约样本

polymarket_closed_contracts

每行是一份已关闭合约的原始对象,含问题、选项、价格和状态;关闭标志不等于正式结算。

粒度
每合约每快照一行
时间范围
2020-10-02 ~ 2024-04-26 · 合约时间字段;采集时间另列
采集时间
2026-10-04T07:55:20.601900Z ~ 2026-10-04T12:03:10.348687Z
记录数
20

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=polymarket_closed_contracts&limit=100

字段表 · 79 个字段

字段名中文说明
active平台活跃状态标记
approved原始批准状态标记
archived平台归档状态标记
bestAsk原始最佳卖价
bestBid原始最佳买价
category原始分类
clearBookOnStart开始时清空订单簿标记
clobTokenIds原始结果代币标识数组或其 JSON 文本
closed原始合约关闭标记,不单独证明正式结算
closedTime原始关闭时间文本
comboStatus原始组合合约状态
competitive原始竞争指标,保留平台口径
conditionId预测合约条件标识
createdAt原始创建时间
creator原始创建者标识
cyom提供方原始属性「cyom」;其具体含义按原始记录说明解读
deploying原始部署中标记
description原始描述或摘要
endDate原始合约结束时间
endDateIso原始结束日期标签
events关联事件原始对象数组
feeType原始费率类型
feesEnabled原始启用手续费标记
formatType原始结果格式类型
fpmmLive原始 FPMM 活跃标记
funded原始资金就绪标记
hasReviewedDates原始日期审核标记
holdingRewardsEnabled持有奖励启用标记
icon图标链接
id提供方原始记录标识
image图片链接
lastTradePrice原始最近成交价
liquidity原始流动性指标,保留提供方口径
liquidityAmmAMM 流动性指标
liquidityNum原始数值流动性指标
lowerBound原始指标下界
mailchimpTag平台原始邮件订阅标签
manualActivation原始人工激活标记
marketMakerAddress原始做市地址
marketType合约类型
negRiskOther平台原始其他负风险属性
notificationsEnabled通知启用标记
oneDayPriceChange原始一日价格变动指标
oneHourPriceChange原始一小时价格变动指标
oneMonthPriceChange原始一月价格变动指标
oneWeekPriceChange原始一周价格变动指标
oneYearPriceChange原始一年价格变动指标
outcomePrices原始选项价格数组或其 JSON 文本
outcomes原始结果选项数组或其 JSON 文本
pendingDeployment原始等待部署标记
question原始预测问题
ready原始就绪标记
readyForCron平台原始定时任务就绪标记
resolutionSource合约指定的结果判定来源
restricted平台限制标记
rewardsMaxSpread奖励规则中最大价差参数
rewardsMinSize奖励规则中最小规模参数
rfqEnabled原始报价请求机制启用标记
slug提供方问题短名
spread原始利差或价差,按对应产品口径解释
startDate原始开始时间
twitterCardImage平台社交分享图链接
umaResolutionStatuses原始 UMA 判定状态数组或其 JSON 文本
updatedAt原始更新时间
updatedBy原始更新者标识
upperBound原始指标上界
version提供方原始版本标记
volume原始交易量,单位依交易场所或市场定义
volume1mo一个月成交量指标
volume1moAmm一个月 AMM成交量指标
volume1moClob一个月 CLOB成交量指标
volume1wk一周成交量指标
volume1wkAmm一周 AMM成交量指标
volume1wkClob一周 CLOB成交量指标
volume1yr一年成交量指标
volume1yrAmm一年 AMM成交量指标
volume1yrClob一年 CLOB成交量指标
volume24hr24 小时成交量指标
volumeNum原始数值成交量指标

PRODUCT

预测市场合约目录

polymarket_existing_catalog

关联现有预测市场合约目录;以 source=polymarket 及日期窗口定位。每行是一份合约观察,关闭状态不能单独证明正式结算。

粒度
每合约观察一行
时间范围
未提供 · observed_at 观察时间
采集时间
未提供
记录数
未提供
已有数据集
见交易数据板块 · event.prediction_market_catalog

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/event/prediction_market_catalog/rows?limit=100

字段表 · 36 个字段

字段名中文说明
activeSource-normalized field: active.
categorySource-normalized field: category.
clob_token_idsSource-normalized field: clob token ids.
closedSource-normalized field: closed.
condition_idIdentifier for condition.
descriptionHuman-readable description supplied or normalized from the source.
end_dateCalendar date for end date (YYYY-MM-DD).
event_idStable identifier of the normalized event.
ingest_run_idIdentifier of the ingestion run that produced the row.
ingested_atUTC timestamp when the source record entered the warehouse.
license_scopeLicense or redistribution scope attached to the row.
liquidity_numSource-normalized field: liquidity num.
market_idIdentifier for market.
native_observation_jsonSource-normalized field: native observation json.
native_winner_fields_jsonSource-normalized field: native winner fields json.
observed_atUTC timestamp for observed at.
outcome_pricesSource-normalized field: outcome prices.
outcomesSource-normalized field: outcomes.
parser_versionVersion of the parser or normalizer that produced the row.
providerUpstream data provider identifier.
quality_statusMachine-readable data-quality classification.
questionSource-normalized field: question.
raw_payload_hashOpaque fingerprint of the normalized source payload for provenance checks.
resolution_sourceSource-normalized field: resolution source.
slugSource-normalized field: slug.
snapshot_dateCalendar date for snapshot date (YYYY-MM-DD).
sourceNormalized upstream source identifier.
source_record_idProvider-side identifier for the source record.
source_urlURL of the upstream evidence or record when distributable.
tagsSource-normalized field: tags.
uma_resolution_statusSource-normalized field: uma resolution status.
uma_resolution_statusesSource-normalized field: uma resolution statuses.
versionMonotonic row version used for correction-aware reads.
visibility_tierServing visibility tier attached to the row.
volume_24hrSource-normalized field: volume 24hr.
volume_numSource-normalized field: volume num.

PRODUCT

预测市场赔率观察

polymarket_existing_odds

关联现有预测市场赔率;以 source=polymarket、market_id 和时间窗口读取。每行是合约某选项的一次价格观察,赔率不等于最终裁决。

粒度
每合约选项观察一行
时间范围
未提供 · observed_at 观察时间
采集时间
未提供
记录数
未提供
已有数据集
见交易数据板块 · event.prediction_market_odds

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/event/prediction_market_odds/rows?limit=100

字段表 · 29 个字段

字段名中文说明
activeSource-normalized field: active.
best_askSource-normalized field: best ask.
best_bidSource-normalized field: best bid.
categorySource-normalized field: category.
closedSource-normalized field: closed.
end_dateCalendar date for end date (YYYY-MM-DD).
ingest_run_idIdentifier of the ingestion run that produced the row.
ingested_atUTC timestamp when the source record entered the warehouse.
last_trade_pricePrice value for last trade price.
license_scopeLicense or redistribution scope attached to the row.
liquidity_numSource-normalized field: liquidity num.
market_idIdentifier for market.
observed_atUTC timestamp for observed at.
outcomeSource-normalized field: outcome.
outcome_indexSource-normalized field: outcome index.
parser_versionVersion of the parser or normalizer that produced the row.
priceSource-normalized field: price.
providerUpstream data provider identifier.
quality_statusMachine-readable data-quality classification.
raw_payload_hashOpaque fingerprint of the normalized source payload for provenance checks.
slugSource-normalized field: slug.
sourceNormalized upstream source identifier.
source_record_idProvider-side identifier for the source record.
source_urlURL of the upstream evidence or record when distributable.
spreadSource-normalized field: spread.
versionMonotonic row version used for correction-aware reads.
visibility_tierServing visibility tier attached to the row.
volume_24hrSource-normalized field: volume 24hr.
volume_numSource-normalized field: volume num.

PRODUCT

Polymarket Gamma 结算状态样本

polymarket_gamma_resolution

每行是 Gamma 接口中的合约原始对象,保留条件标识、选项和可用结算字段。

粒度
每合约每快照一行
时间范围
2026-10-04 ~ 2026-10-04 · 合约与结算时间字段
采集时间
2026-10-04T07:55:33.978855Z ~ 2026-10-04T12:01:47.135862Z
记录数
6

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=polymarket_gamma_resolution&limit=100

字段表 · 87 个字段

字段名中文说明
acceptingOrders是否接受订单
acceptingOrdersTimestamp原始开始接单时间
active平台活跃状态标记
approved原始批准状态标记
archived平台归档状态标记
automaticallyActive原始自动激活标记
automaticallyResolved原始自动判定标记
bestAsk原始最佳卖价
bestBid原始最佳买价
clearBookOnStart开始时清空订单簿标记
clobTokenIds原始结果代币标识数组或其 JSON 文本
closed原始合约关闭标记,不单独证明正式结算
closedTime原始关闭时间文本
comboStatus原始组合合约状态
competitive原始竞争指标,保留平台口径
conditionId预测合约条件标识
createdAt原始创建时间
customLiveness原始判定等待窗口参数
cyom提供方原始属性「cyom」;其具体含义按原始记录说明解读
deploying原始部署中标记
deployingTimestamp原始部署时间
description原始描述或摘要
enableOrderBook是否启用订单簿
endDate原始合约结束时间
endDateIso原始结束日期标签
events关联事件原始对象数组
featured原始精选内容标记
feeSchedule原始费率设置对象
feeType原始费率类型
feesEnabled原始启用手续费标记
funded原始资金就绪标记
gameStartTime原始赛事开始时间
groupItemThreshold原始分组选项阈值
groupItemTitle原始分组选项标题
hasReviewedDates原始日期审核标记
holdingRewardsEnabled持有奖励启用标记
icon图标链接
id提供方原始记录标识
image图片链接
lastTradePrice原始最近成交价
liquidity原始流动性指标,保留提供方口径
liquidityAmmAMM 流动性指标
liquidityClobCLOB 流动性指标
liquidityNum原始数值流动性指标
makerBaseFee原始挂单方基础费率
manualActivation原始人工激活标记
marketMakerAddress原始做市地址
negRisk平台原始负风险属性
negRiskOther平台原始其他负风险属性
new原始新记录标记
orderMinSize最小订单规模
orderPriceMinTickSize价格最小变动单位
outcomePrices原始选项价格数组或其 JSON 文本
outcomes原始结果选项数组或其 JSON 文本
pendingDeployment原始等待部署标记
question原始预测问题
questionID问题标识
ready原始就绪标记
resolvedBy原始判定者标识
restricted平台限制标记
rewardsMaxSpread奖励规则中最大价差参数
rewardsMinSize奖励规则中最小规模参数
rfqEnabled原始报价请求机制启用标记
slug提供方问题短名
spread原始利差或价差,按对应产品口径解释
startDate原始开始时间
startDateIso原始开始日期标签
submitted_by原始提交者标识
takerBaseFee原始成交方基础费率
umaBond原始 UMA 保证金参数
umaEndDate原始 UMA 结束日期
umaResolutionStatus原始 UMA 判定状态
umaResolutionStatuses原始 UMA 判定状态数组或其 JSON 文本
umaReward原始 UMA 奖励参数
updatedAt原始更新时间
version提供方原始版本标记
volume原始交易量,单位依交易场所或市场定义
volume1mo一个月成交量指标
volume1moClob一个月 CLOB成交量指标
volume1wk一周成交量指标
volume1wkClob一周 CLOB成交量指标
volume1yr一年成交量指标
volume1yrClob一年 CLOB成交量指标
volume24hr24 小时成交量指标
volume24hrClobCLOB 24 小时成交量指标
volumeClobCLOB 成交量指标
volumeNum原始数值成交量指标

数据观测时间 2026-10-06T17:38:47.854586Z