Felo API PlatformFelo API Platform

資料 API / Polymarket / Activity

Get Polymarket Wallet Activity

Get one wallet's on-chain Polymarket activity — a per-address lookup, not a market-wide trade feed. The user parameter is required. Use it to reconstruct what a specific trader did — position splits, merges and redemptions, with size, price, and the transaction that settled them; narrow further with market_slug, condition_id, and the start_time / end_time Unix-second range. Returns activities[] with side (MERGE / SPLIT / REDEEM), market_slug, condition_id, shares, price, timestamp, and tx_hash, plus a pagination object whose key you pass back as pagination_key. For market-wide prices rather than one wallet's history, use get_polymarket_markets.

參數

查詢

  • userstring必填

    Wallet address or user identifier. Required by the runtime route.

  • start_timeinteger選填

    Filter activity from this Unix timestamp in seconds (inclusive)

  • end_timeinteger選填

    Filter activity until this Unix timestamp in seconds (inclusive)

  • market_slugstring選填

    Filter activity by market slug

  • condition_idstring選填

    Filter activity by condition ID

  • limitinteger選填

    Number of activities to return (1-1000)

  • pagination_keystring選填

    Base64-encoded cursor for efficient pagination. Returned in the previous response's pagination object.

請求範例

curl -G "https://openapi.felo.ai/v1/beta/polymarket/activity" \
  --data-urlencode "user=<string>" \
  -H "Authorization: Bearer $FELO_API_KEY"

回應

回應欄位

  • activitiesobject[]選填
  • token_idstring選填
  • sidestring選填

    允許值： MERGE · SPLIT · REDEEM

  • market_slugstring選填
  • condition_idstring選填
  • sharesnumber選填

    Raw number of shares (from the blockchain)

  • shares_normalizednumber選填

    Number of shares normalized (raw divided by 1000000)

  • pricenumber選填
  • block_numberinteger選填

    Block number where the activity occurred

  • log_indexinteger選填

    Log index of the activity event in the block

  • tx_hashstring選填
  • titlestring選填
  • timestampinteger選填

    Unix timestamp in seconds when the activity occurred

  • order_hashstring選填
  • userstring選填

    User wallet address

  • paginationobject選填
  • limitinteger選填
  • countinteger選填

    Total number of activities matching the filters

  • has_moreboolean選填

    Whether there are more activities available

  • pagination_keystring選填

    Base64-encoded cursor for the next page. Only present when there are more results.