Get Trader Market Participation History

Queries resolved and active prediction market positions, PnL per market, and execution records

GEThttps://api.polyedge.dev/v2/traders/{address}/markets

Request Parameters

Required headers and parameter specifications for this endpoint.

Headers

Header	Type	Required	Description
X-PolyEdge-Key	string	required	PolyEdge API Key for client authentication and rate-limiting

Path Parameters

Parameter	Type	Required	Description
address	string	required	EVM address (0x...)

Query Parameters

Parameter	Type	Default	Description
limit	integer	20	Page limit (1-100)
offset	integer	0	Pagination offset
tag	string	-	Market category tag filter
series	string	-	Market series filter
status	string	all	Filter by market resolution status: 'active', 'resolved', or 'all' (default: 'all') Options:`activeresolvedall`
include_orders	boolean	false	Include individual fill orders for each market

Response (200 OK)

Field definitions for the successful response payload.

application/json

200 Response Example

json

{
  "history": [
    {
      "last_trade_at": "2026-09-29T08:59:42Z",
      "market": {
        "icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/wta-logo-41f331bdf1.png",
        "id": 5023458,
        "outcomes": [
          "Amelia Rajecki",
          "Yuhan Wang"
        ],
        "question": "Jingshan: Amelia Rajecki vs Yuhan Wang",
        "resolved_at": null,
        "result": -2,
        "series_slug": "wta",
        "slug": "wta-rajecki-yuhanwa-2026-09-28"
      },
      "orders": [
        {
          "fee": 0,
          "is_taker": false,
          "outcome": "Yuhan Wang",
          "shares": 41476492,
          "side": "BUY",
          "time": "2026-09-29T08:09:54Z",
          "usdc": 17834892
        },
        {
          "fee": 0,
          "is_taker": false,
          "outcome": "Yuhan Wang",
          "shares": 5613334827,
          "side": "BUY",
          "time": "2026-09-29T08:59:18Z",
          "usdc": 2357600628
        }
      ],
      "pnl": 0,
      "roi": 0,
      "volume": 2375435520
    },
    {
      "last_trade_at": "2026-09-29T08:59:03Z",
      "market": {
        "icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/atp-tour-b4390c4fb8.jpg",
        "id": 5041267,
        "outcomes": [
          "Bernard Tomic",
          "Fajing Sun"
        ],
        "question": "Jingshan: Bernard Tomic vs Fajing Sun",
        "resolved_at": null,
        "result": -2,
        "series_slug": "atp",
        "slug": "atp-tomic-su-2026-09-28"
      },
      "orders": [
        {
          "fee": 0,
          "is_taker": false,
          "outcome": "Bernard Tomic",
          "shares": 442392858,
          "side": "BUY",
          "time": "2026-09-29T08:34:05Z",
          "usdc": 318522858
        },
        {
          "fee": 0,
          "is_taker": false,
          "outcome": "Bernard Tomic",
          "shares": 992350345,
          "side": "BUY",
          "time": "2026-09-29T08:36:12Z",
          "usdc": 704568745
        },
        {
          "fee": 0,
          "is_taker": false,
          "outcome": "Fajing Sun",
          "shares": 2816900,
          "side": "BUY",
          "time": "2026-09-29T08:59:03Z",
          "usdc": 816901
        }
      ],
      "pnl": -8685,
      "roi": -0.4323726380057789,
      "volume": 1023908504
    }
  ],
  "total_count": 90529
}

Response Body Fields

Field	Type	Description
history	array of objects	Paginated list of market settlement details
├─last_trade_at	string	ISO 8601 UTC timestamp of the trader's last trade in this market
├─market	object	-
├─icon	string	Market thumbnail image URL
├─id	integer	Unique numeric prediction market identifier
├─outcomes	string[]	Raw JSON array of outcome display names, e.g. ["Yes", "No"]
├─question	string	Full title question describing the market condition
├─resolved_at	string	Timestamp when market officially settled (RFC 3339 UTC), or null if active
├─result	integer	Resolution outcome (-2: unresolved, -1: void/invalid, 0-100: payout percentage for Outcome 0, e.g. 100 = Outcome 0 won, 0 = Outcome 1 won, 50 = 50/50 split)
├─series_slug	string	URL slug of the recurring sports league or tournament series
├─slug	string	URL-friendly slug identifying the market on Polymarket
├─orders	array of objects	Detailed order fill events (present only when include_orders=true)
├─fee	integer	Protocol trading fee deducted in micro-USD (6 decimals)
├─is_taker	boolean	True if executed against resting book liquidity as a taker
├─outcome	string	Prediction outcome label (e.g. "Yes", "No")
├─shares	integer	Filled outcome token shares (6 decimals)
├─side	string	Order execution side: "BUY" or "SELL"
├─time	string	ISO 8601 UTC timestamp of order fill execution
├─usdc	integer	Total collateral USDC transferred (6 decimals micro-USD)
├─pnl	integer	Realized net PnL in micro-USD (6 decimals)
├─roi	number	Return on investment percentage in this market
├─volume	integer	Total traded volume in this market in micro-USD (6 decimals)
total_count	integer	Total count of matching market positions for pagination

cURL Example

Copy and run this command directly in your terminal to test this endpoint.

cURL: GET /v2/traders/{address}/markets

bash

curl -X GET "https://api.polyedge.dev/v2/traders/0x2005d16a84ceefa912d4e380cd32e7ff827875ea/markets?limit=20&offset=0&status=all&include_orders=true" \
  -H "X-PolyEdge-Key: Your-PolyEdge-ApiKey"