Polymarket
Prediction-market discovery and market data.
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.
- 类型: stringuser必填
Wallet address or user identifier. Required by the runtime route.
- 类型: integerstart
_time Filter activity from this Unix timestamp in seconds (inclusive)
- 类型: integerend
_time Filter activity until this Unix timestamp in seconds (inclusive)
- 类型: stringmarket
_slug Filter activity by market slug
- 类型: stringcondition
_id Filter activity by condition ID
- 类型: integerlimit最小值:1最大值:1000
Number of activities to return (1-1000)
- 类型: stringpagination
_key Base64-encoded cursor for efficient pagination. Returned in the previous response's pagination object.
- 类型: object200
Activity response with pagination
- 类型: array object[]activities
- block类型: integer
_number Block number where the activity occurred
- condition类型: string
_id - log类型: integer
_index Log index of the activity event in the block
- market类型: string
_slug - order类型: string
_hash - price类型: number
- shares类型: number
Raw number of shares (from the blockchain)
- shares类型: number
_normalized Number of shares normalized (raw divided by 1000000)
- side类型: string 枚举值
- M
E R G E - S
P L I T - R
E D E E M
- timestamp类型: integer
Unix timestamp in seconds when the activity occurred
- title类型: string
- token类型: string
_id - tx类型: string
_hash - user类型: string
User wallet address
- 类型: objectpagination
- count类型: integer
Total number of activities matching the filters
- has类型: boolean
_more Whether there are more activities available
- limit类型: integer
Integer numbers.
- pagination类型: string
_key Base64-encoded cursor for the next page. Only present when there are more results.
application/json - 类型: object400
Bad Request - Invalid parameters or validation errors
- 类型: stringerror
- 类型: stringmessage
application/json - 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 类型: object500
Internal Server Error
- 类型: stringerror
- 类型: stringmessage
application/json - 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl 'https://openapi.felo.ai/v1/beta/polymarket/activity?user=0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"activities": [
{
"token_id": "",
"side": "REDEEM",
"market_slug": "will-the-doj-charge-boeing",
"condition_id": "0x92e4b1b8e0621fab0537486e7d527322569d7a8fd394b3098ff4bb1d6e1c0bbd",
"shares": 187722726,
"shares_normalized": 187.722726,
"price": 1,
"block_number": 123456789,
"log_index": 42,
"tx_hash": "0x028baff23a90c10728606781d15077098ee93c991ea204aa52a0bd2869187574",
"title": "Will the DOJ charge Boeing?",
"timestamp": 1721263049,
"order_hash": "",
"user": "0xfd9c3e7f8c56eb4186372f343c873cce154b3873"
}
],
"pagination": {
"limit": 50,
"count": 1250,
"has_more": true,
"pagination_key": "eyJibG9ja190aW1lc3RhbXAiOiIyMDI1LTAxLTE5VDEyOjAwOjAwLjAwMFoiLCJzaWRlIjoiU1BMSVQiLCJ0eF9oYXNoIjoiMHgxMjM0NTY3ODkwYWJjZGVmIiwibG9nX2luZGV4IjoxMCwidG90YWwiOjE5ODkwMTc3Nn0="
}
}