Felo API PlatformFelo API Platform
全部 Polymarket 端点
v0.2.0-beta
OpenAPI 3.1.0

获取 Polymarket 钱包活动

Felo API Support
MIT
服务器:https://openapi.felo.ai
客户端库
Shell Curl

Polymarket

​

Prediction-market discovery and market data.

Polymarket 操作

获取 Polymarket 钱包活动

​

获取预测市场活动。使用 condition-ID 值筛选市场，使用 start 和 end 指定时间窗口，使用 limit 和 offset 分页。其他选择器包括 eventId、type、side、sortBy 和 sortDirection。成功响应是顶层的活动记录数组。

计费参考

  • 计量方式：按成功请求的固定成本计费。
  • 参考请求估算：0.012 美元。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

查询参数
  • end
    类型: integer
    最小值:  
    0

    活动时间窗口的上界时间戳（epoch 秒）。省略则使用默认值（当前时间）；比 end 更新的行会被排除。

  • eventId
    类型: array integer[]
    最小值:  
    1

    以逗号分隔的事件 ID 列表。与 market 互斥。

  • excludeDepositsWithdrawals
    类型: boolean

    排除充值和提现记录。默认值 true 即使 type 请求了这些记录也会生效，因此要获取充值和提现记录必须传 false。

  • limit
    类型: integer
    最小值:  
    0
    最大值:  
    500

    每页大小。超过最大值的会被限制为 500。

  • market
    类型: array string[]

    以逗号分隔的条件 ID 列表。与 eventId 互斥。

  • offset
    类型: integer
    最小值:  
    0
    最大值:  
    5000

    分页起始索引。超过上限的请求会以 400 拒绝（绝不会静默截断）。要读取超过 offset 5000 的历史数据，请在 start/end 窗口内分页——每个窗口都有各自的 offset 预算。

  • side
    类型: string 枚举
    值
    • BUY
    • SELL
  • sortBy
    类型: string 枚举
    值
    • TIMESTAMP
    • TOKENS
    • CASH
  • sortDirection
    类型: string 枚举

    DESC（默认）最先返回最新的行，ASC 最先返回最旧的行。两种顺序都是稳定的——同一查询在任意 limit/offset 下返回相同的行，因此各页可以无缝拼接，不会出现空缺或重复。

    值
    • ASC
    • DESC
  • start
    类型: integer
    最小值:  
    0

    活动时间窗口的下界时间戳（epoch 秒）。省略或传 0 使用默认窗口（最近约 3 年）；传入正数 epoch（例如 1）可获取完整历史。当 sortDirection=ASC 时，省略 start 即从账户历史起点读取（无默认窗口）。

  • type
    类型: array string[] 枚举

    以逗号分隔的活动类型列表。DEPOSIT 和 WITHDRAWAL 记录还需要 excludeDepositsWithdrawals=false。

    值
    • TRADE
    • SPLIT
    • MERGE
    • REDEEM
    • REWARD
  • user
    类型: string
    必填

    用户资料地址（0x 前缀，40 个十六进制字符）

响应
  • 200
    类型: array object[] · Response65D835437A58_Activity[]

    成功

    • asset
      类型: string

      此行所指的代币 ID。在 REDEEM 行中填入该行结算的代币。当该行不针对特定代币时为空。

    • bio
      类型: string
    • conditionId
      类型: string · Response65D835437A58_Hash64

      以 0x 开头的 64 位十六进制字符串

    • eventSlug
      类型: string
    • icon
      类型: string

      市场配图。当市场没有自己的图标时，依次回退到市场图片，再回退到父活动的图标和图片。在 CONVERSION 行中为空。

    • isCombo
      类型: boolean

      当此行属于组合（多市场）头寸时为 true。仅作为标志——此处不内嵌组合详情。该行的 conditionId 等于组合的 combo_condition_id；可通过 market_id 将其传给 /v1/activity/combos 或 /v1/positions/combos，以获取各腿和详情。非组合行会省略该字段。

    • name
      类型: string
    • outcome
      类型: string
    • outcomeIndex
      类型: integer

      此行结果在市场 outcomes 数组中的从零开始的索引，因此 outcome 始终等于 outcomes[outcomeIndex]。在 REDEEM 行中，它标识该行结算的结果，而不是市场的获胜结果。999 表示无法确定结果，此时 outcome 为空。

    • price
      类型: number
    • profileImage
      类型: string
    • profileImageOptimized
      类型: string
    • proxyWallet
      类型: string · Response65D835437A58_Address

      用户资料地址（0x 前缀，40 个十六进制字符）

    • pseudonym
      类型: string
    • side
      类型: string 枚举
      值
      • BUY
      • SELL
    • size
      类型: number

      此行的代币数量。在 REDEEM 行中，它是为该行结果销毁的代币数量，因此赎回市场的双方会为每个结果返回一行，而不是返回一行合并记录。

    • slug
      类型: string
    • timestamp
      类型: integer 格式: int64

      Signed 64-bit integers (long type).

    • title
      类型: string
    • transactionHash
      类型: string
    • type
      类型: string 枚举
      值
      • TRADE
      • SPLIT
      • MERGE
      • REDEEM
      • REWARD
    • usdcSize
      类型: number

      此行的 USDC 数量。在 REDEEM 行中，它是该行结果的赔付金额，落败结果为 0；一次赎回的各行合计为总赔付金额。

    application/json
  • 400

    无法处理该请求。请检查请求参数。

  • 401

    需要有效的 Felo API 密钥。

  • 402

    由于未满足计费要求，请求无法继续。

  • 403

    该账户无权执行此操作。

  • 429

    已达到请求或支出限额。

  • 502

    服务无法完成该请求。

  • 503

    API 或计费服务暂时不可用。

  • 504

    服务在处理请求时超时。

  • default

    错误响应；上游透传响应可能采用提供方格式

    application/json
Request Example for get/v1/beta/polymarket/activity
curl 'https://openapi.felo.ai/v1/beta/polymarket/activity?user=0x56687bf447db6ffa42ffe2204a05edaa20f55839' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

[
  {
    "proxyWallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
    "timestamp": 1,
    "conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
    "type": "TRADE",
    "size": 1,
    "usdcSize": 1,
    "transactionHash": "string",
    "price": 1,
    "asset": "string",
    "side": "BUY",
    "outcomeIndex": 1,
    "title": "string",
    "slug": "string",
    "icon": "string",
    "eventSlug": "string",
    "outcome": "string",
    "name": "string",
    "pseudonym": "string",
    "bio": "string",
    "profileImage": "string",
    "profileImageOptimized": "string",
    "isCombo": true
  }
]

成功

Get Polymarket Wallet Activity

需要帮助？