全部文档 Nebula 文档 所有端点 交互式文档 Markdown OpenAPI JSON
  1. REST API
  2. 其他

预测市场

GET /predictions
ListPredictionMarkets

浏览 Polymarket 和 Kalshi 合约。价格是各平台的结果概率，而非社交情绪。成交量保留其平台单位。等价合约共享同一市场；相关合约保持独立。主体指标使用现有的主体和资产端点。

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/predictions 使用。无需 Nebula 账户或 API key；签名前请先查看支付报价。x402 支付指南。

参数

query string QUERY

跨公开标识符和名称进行不区分大小写的搜索。

Example:NVIDIA

provider string QUERY

可选平台

允许的值
polymarketkalshi

Example:polymarket

status string QUERY

默认为 open

允许的值
openclosedresolveddisputedall

Default:open

subject_id string QUERY

由 /subjects 或 /search 返回的规范非资产标识符，例如 text:jensen huang 或 handle:elonmusk。不区分大小写。不能与 asset_id 或 asset_class 组合使用。

Example:text:jensen huang

limit integer QUERY

返回的最大结果数。

Default:25

offset integer QUERY

分页偏移量

Default:0

cURL 示例

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/predictions' \
  --header 'X-API-Key: YOUR_API_KEY'

响应

200 OK
400 错误请求
401 未授权
402 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额
403 禁止访问
404 未找到
405 方法不被允许；Allow 响应头列出了支持的方法
429 请求过多
500 内部服务器错误
503 服务不可用

媒体类型 application/json

has_more
boolean 必填

返回的记录之后还有可用页面时为 true。

limit
integer 必填

请求的最大记录数。

markets
array<object> 必填

规范市场，按各平台内的最佳活跃度排名排序。平台成交量不进行汇总。
markets[].id
string 必填

此对象类型内的稳定标识。

markets[].listings
array<object> 必填

平台列表，规则和报价分别保留。
markets[].listings[].closes_at
string (date-time) 必填

平台交易收盘时间（UTC）；不一定等于事件发生或结算时间。

markets[].listings[].event_id
string 必填

平台事件标识符，不存在则为空。

markets[].listings[].id
string 必填

此对象类型内的稳定标识。

markets[].listings[].liquidity_usd
number (double) 必填

平台报告的流动性，以美元计；不可用时为 null。

markets[].listings[].market_id
string 必填

规范市场标识；等价的平台列表共享此标识。

markets[].listings[].observed_at
string (date-time) 必填

Nebula 获取此报价的 UTC 时间。比较前请检查时效性。

markets[].listings[].open_interest
number (double) 必填

平台未平仓合约数；不可用时为 null。

markets[].listings[].opens_at
string (date-time) 必填

平台开盘时间（UTC）；不可用时为 null。

markets[].listings[].outcomes
array<object> 必填

有序的原生结果，具有独立的价格证据。

markets[].listings[].provider
string 必填

平台：polymarket 或 kalshi。

markets[].listings[].provider_id
string 必填

原生平台市场标识符。

markets[].listings[].provider_updated_at
string (date-time) 必填

平台元数据更新时间；不可用时为 null。

markets[].listings[].question
string 必填

原始合约问题。

markets[].listings[].resolution_source
string 必填

平台结算来源，不存在则为空。

markets[].listings[].resolves_at
string (date-time) 必填

平台预期结算时间（UTC）；不可用时为 null。

markets[].listings[].result
string 必填

平台结算结果；已知结果之前为空。

markets[].listings[].revision
string 必填

问题、规则、来源、收盘时间和结果方向的 SHA-256 哈希。

markets[].listings[].rules
string 必填

完整平台结算规则。

markets[].listings[].source_url
string 必填

原始平台列表 URL。

markets[].listings[].status
string 必填

上市生命周期：open、closed、resolved 或 disputed。对于主体：resolved 或 pending。

markets[].listings[].volume
number (double) 必填

以 volume_unit 计量的累计场所成交量；不可用时为 null。

markets[].listings[].volume_24h
number (double) 必填

以 volume_unit 计量的最近 24 小时场所成交量；不可用时为 null。

markets[].listings[].volume_unit
string 必填

Polymarket 使用 usd，Kalshi 使用 contracts。这些数量不能相加。

markets[].question
string 必填

原始合约问题。

markets[].subjects
array<object> 必填

关联主体。请分别使用其现有的分析端点；不推断任何市场情绪。
markets[].subjects[].fallback_image_urls
array<string> 必填

按后端解析顺序排列的回退图标候选。

markets[].subjects[].image_url
string 必填

后端解析出的首选主体图标候选；为空时使用回退项。

markets[].subjects[].name
string 必填

规范的主体显示名称。

markets[].subjects[].role
string 必填

问题附件角色：entity、topic 或 place。

markets[].subjects[].status
string 必填

上市生命周期：open、closed、resolved 或 disputed。对于主体：resolved 或 pending。

markets[].subjects[].subject_id
string 必填

规范的注册表主体标识符；保留现有的资产或主题资格。

markets[].subjects[].types
array<string> 必填

来自现有身份解析器的规范主体类型。

offset
integer 必填

跳过的匹配记录数。

{
  "has_more": false,
  "limit": 50,
  "markets": [
    {
      "id": "polymarket:123",
      "listings": [
        {
          "closes_at": "2026-10-07T20:00:00Z",
          "event_id": "event-123",
          "id": "polymarket:123",
          "liquidity_usd": 5000,
          "market_id": "polymarket:123",
          "observed_at": "2026-10-06T12:00:00Z",
          "open_interest": 100,
          "opens_at": "2026-10-01T00:00:00Z",
          "outcomes": [],
          "provider": "polymarket",
          "provider_id": "123",
          "provider_updated_at": "2026-10-06T12:00:00Z",
          "question": "Will NVIDIA close above $200 on October 7?",
          "resolution_source": "Official exchange close",
          "resolves_at": "2026-10-08T00:00:00Z",
          "result": "yes",
          "revision": "revision-hash",
          "rules": "Resolves Yes if the official closing price exceeds $200.",
          "source_url": "https://polymarket.com/event/example",
          "status": "open",
          "volume": 10000,
          "volume_24h": 1000,
          "volume_unit": "usd"
        }
      ],
      "question": "Will NVIDIA close above $200 on October 7?",
      "subjects": [
        {
          "fallback_image_urls": [],
          "image_url": "https://example.com/nvda.png",
          "name": "NVIDIA",
          "role": "entity",
          "status": "open",
          "subject_id": "eq:NVDA",
          "types": []
        }
      ]
    }
  ],
  "offset": 0
}