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.