Felo API PlatformFelo API Platform

Data 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.

Parameters

query

  • userstringRequired

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

  • start_timeintegerOptional

    Filter activity from this Unix timestamp in seconds (inclusive)

  • end_timeintegerOptional

    Filter activity until this Unix timestamp in seconds (inclusive)

  • market_slugstringOptional

    Filter activity by market slug

  • condition_idstringOptional

    Filter activity by condition ID

  • limitintegerOptional

    Number of activities to return (1-1000)

  • pagination_keystringOptional

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

Example request

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

Response

Response fields

  • activitiesobject[]Optional
  • token_idstringOptional
  • sidestringOptional

    Allowed values: MERGE · SPLIT · REDEEM

  • market_slugstringOptional
  • condition_idstringOptional
  • sharesnumberOptional

    Raw number of shares (from the blockchain)

  • shares_normalizednumberOptional

    Number of shares normalized (raw divided by 1000000)

  • pricenumberOptional
  • block_numberintegerOptional

    Block number where the activity occurred

  • log_indexintegerOptional

    Log index of the activity event in the block

  • tx_hashstringOptional
  • titlestringOptional
  • timestampintegerOptional

    Unix timestamp in seconds when the activity occurred

  • order_hashstringOptional
  • userstringOptional

    User wallet address

  • paginationobjectOptional
  • limitintegerOptional
  • countintegerOptional

    Total number of activities matching the filters

  • has_morebooleanOptional

    Whether there are more activities available

  • pagination_keystringOptional

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