Polymarket
Prediction-market discovery and market data.
取得 Polymarket 錢包活動
取得預測市場活動。使用 condition-ID 值篩選市場，以 start 與 end 指定時間範圍，並以 limit 與 offset 分頁。其他選擇器包括 eventId、type、side、sortBy 與 sortDirection。成功回應是頂層的活動記錄陣列。
定價參考
- 計量方式：以成功請求為固定成本基礎。
- 參考請求預估：USD 0.012。
僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: integerend最小值:0
活動時間範圍的上界時間戳（epoch 秒）。省略則使用預設值（目前時間）；比
end更新的資料列會被排除。 - 類型: array integer[]event
Id 最小值:1以逗號分隔的事件 ID 清單。與 market 互斥。
- 類型: booleanexclude
Deposits Withdrawals 排除存款與提款記錄。預設值
true即使type請求了這些記錄仍會生效，因此要取得存款與提款記錄必須傳入false。 - 類型: integerlimit最小值:0最大值:500
每頁大小。超過上限的值會被限制為 500。
- 類型: array string[]market
以逗號分隔的條件 ID 清單。與 eventId 互斥。
- 類型: integeroffset最小值:0最大值:5000
分頁起始索引。超過上限的請求會以 400 拒絕（絕不會靜默截斷）。若要讀取超過 offset 5000 的歷史資料，請在
start/end時間範圍內分頁——每個時間範圍都有各自的 offset 預算。 - 類型: string 列舉side值
- B
U Y - S
E L L
- 類型: string 列舉sort
By 值- T
I M E S T A M P - T
O K E N S - C
A S H
- 類型: string 列舉sort
Direction DESC（預設）最先傳回最新的資料列，ASC最先傳回最舊的資料列。兩種排序都是穩定的——同一查詢在任意limit/offset下都會傳回相同的資料列，因此各頁可以無縫拼接，不會出現缺口或重複。值- A
S C - D
E S C
- 類型: integerstart最小值:0
活動時間範圍的下界時間戳（epoch 秒）。省略或傳入
0使用預設範圍（最近約 3 年）；傳入正數 epoch（例如1）可取得完整歷史。當sortDirection=ASC時，省略start即從帳戶歷史起點讀取（無預設範圍）。 - 類型: array string[] 列舉type
以逗號分隔的活動類型清單。DEPOSIT 與 WITHDRAWAL 記錄還需要
excludeDepositsWithdrawals=false。值- T
R A D E - S
P L I T - M
E R G E - R
E D E E M - R
E W A R D
- 類型: stringuser必填
使用者檔案地址（0x 前置，40 個十六進位字元）
- 類型: array object[] · Response65D835437A58_Activity[]200
成功
- asset類型: string
此列所指的代幣 ID。在
REDEEM列中填入該列結算的代幣。當該列並非針對特定代幣時為空。 - bio類型: string
- condition類型: string · Response65D835437A58_Hash64
Id 以 0x 開頭的 64 位十六進位字串
- event類型: string
Slug - icon類型: string
市場主視覺圖。當市場沒有自己的圖示時，會依序退回市場圖片，再退回父活動的圖示與圖片。在
CONVERSION列中為空。 - is類型: boolean
Combo 當此列屬於組合（多市場）部位時為 true。僅為旗標——此處不內嵌組合詳細資料。該列的 conditionId 等於組合的 combo_condition_id；可透過 market_id 將其傳給 /v1/activity/combos 或 /v1/positions/combos，以取得各腿與詳細資料。非組合列會省略此欄位。
- name類型: string
- outcome類型: string
- outcome類型: integer
Index 此列結果在市場
outcomes陣列中的從零開始索引，因此outcome一律等於outcomes[outcomeIndex]。在REDEEM列中，它識別該列結算的結果，而非市場的獲勝結果。999表示無法判定結果，此時outcome為空。 - price類型: number
- profile類型: string
Image - profile類型: string
Image Optimized - proxy類型: string · Response65D835437A58_Address
Wallet 使用者檔案地址（0x 前置，40 個十六進位字元）
- pseudonym類型: string
- side類型: string 列舉值
- B
U Y - S
E L L
- size類型: number
此列的代幣數量。在
REDEEM列中，它是為該列結果銷毀的代幣數量，因此贖回市場的雙方會為每個結果各傳回一列，而不是傳回單一合併列。 - slug類型: string
- timestamp類型: integer 格式: int64
Signed 64-bit integers (long type).
- title類型: string
- transaction類型: string
Hash - type類型: string 列舉值
- T
R A D E - S
P L I T - M
E R G E - R
E D E E M - R
E W A R D
- usdc類型: number
Size 此列的 USDC 數量。在
REDEEM列中，它是該列結果的賠付金額，落敗結果為0；一次贖回的各列合計為總賠付金額。
application/json - 400
無法處理該要求。請檢查請求參數。
- 401
需要有效的 Felo API 金鑰。
- 402
由於未符合計費要求，要求無法繼續。
- 403
該帳戶無權執行此操作。
- 429
已達到要求或支出上限。
- 502
服務無法完成該要求。
- 503
API 或計費服務暫時無法使用。
- 504
服務在處理要求時逾時。
- default
錯誤回應；上游透傳回應可能採用供應商格式
application/json
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
}
]