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 で拒否されます(暗黙に切り詰められることはありません)。オフセット 5000 より深い履歴を読むには、
start/endの期間内でページングします。各期間には独自のオフセット予算があります。 - 型: 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 桁の 16 進数)
- 型: array object[] · Response65D835437A58_Activity[]200
成功
- asset型: string
この行が参照するトークン ID。
REDEEM行では、その行が決済するトークンが設定されます。行が特定のトークンに固有でない場合は空です。 - bio型: string
- condition型: string · Response65D835437A58_Hash64
Id 0x で始まる 64 桁の 16 進文字列
- 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 桁の 16 進数)
- pseudonym型: string
- side型: string 列挙値値
- B
U Y - S
E L L
- size型: number
この行のトークン量。
REDEEM行では、その行の結果に対してバーンされたトークン数です。そのため、マーケットの両側を償還すると、単一の統合行ではなく、結果ごとに 1 行が返されます。 - 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です。1 回の償還の各行の合計が支払総額になります。
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
}
]