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.