GET /v1/traders/:address/markets
Your PolyEdge API key.
Parameters
The EVM wallet address of the trader.
Number of markets to return. Maximum:
100.Pagination offset.
Filter by active (unresolved) markets only. If omitted, both active and resolved markets are returned.
If true, includes the trader’s individual orders for each market. Requires individual or pro tier.
Response
Array of market performance records, ordered by most recent trade.
Show properties
Show properties
The trader’s profit and loss in this market, in micro-USDC.
The trader’s total trading volume in this market, in micro-USDC.
Return on investment for this market as a percentage.
ISO 8601 timestamp of the trader’s most recent trade in this market.
Details about the market.
Show properties
Show properties
Unique market ID.
The market question.
URL-friendly market identifier.
ISO 8601 timestamp of when the market opened.
ISO 8601 timestamp of when the market closes or closed.
URL to the market’s icon image.
Whether this is a negative-risk market.
Slug of the parent event this market belongs to.
Slug of the series this market belongs to (e.g.,
nba-2026).List of category tags applied to this market.
Label for the first outcome.
Label for the second outcome.
Display title for this market within its event group (e.g.,
Spread -3.5).Human-readable title of the parent event.
URL to the parent event’s icon image.
ISO 8601 timestamp of when the market was resolved. Empty string if not yet resolved.
The winning outcome label. Empty string if the market is not yet resolved.
Array of individual order executions for the trader in this market, ordered by time. Only populated if
include_orders=true.Show properties
Show properties
ISO 8601 timestamp of when the order was executed.
The outcome the order was placed on.
Order direction. Either
BUY or SELL.Execution price in micro-units (6 decimal places).
Number of shares filled, in micro-units.
USDC value of the order, in micro-USDC.
Unique on-chain hash identifying this order.
true if taker, false if maker.The ERC-1155 token ID.
Fee in micro-USDC.
Total number of markets for this trader. Use with
limit and offset for pagination.Example
curl "https://api.polyedge.dev/v1/traders/0x8a6c6811e8937f9e8afc1b9249fa540262c30b3f/markets?limit=5" \
-H "X-PolyEdge-Key: YOUR_API_KEY"
{
"history": [
{
"pnl": "0",
"volume": "99844999995",
"roi": 0,
"last_trade_at": "2026-04-06T02:28:21Z",
"market": {
"id": "1858809",
"question": "Spread: Rockets (-3.5)",
"slug": "nba-hou-gsw-2026-04-05-spread-away-3pt5",
"start_date": "2026-04-04T10:12:49Z",
"end_date": "2026-04-06T02:00:00Z",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png",
"neg_risk": false,
"event_slug": "nba-hou-gsw-2026-04-05",
"series_slug": "nba-2026",
"tags": [
"sports",
"basketball",
"nba",
"games"
],
"outcome_1": "Rockets",
"outcome_2": "Warriors",
"group_item_title": "Spread -3.5",
"event_title": "Rockets vs. Warriors",
"event_icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png",
"resolved_at": "",
"winning_outcome": ""
},
"orders": [
{
"time": "2026-04-06T02:25:29Z",
"outcome": "Rockets",
"side": "BUY",
"price": "478541",
"shares": "10448408978",
"usdc": "4999999999",
"order_hash": "0x25150adb61c78c2fe4bf9a025ad1b9fac0bf9cbb3a8904c74430905cb2a008ce",
"is_taker": true,
"token_id": "78907585036215681443680219168838316352537740030793428756821532285400412083533",
"fee": "24999999"
}
]
},
{
"pnl": "20956746601",
"volume": "70611742599",
"roi": 85.00000000750354,
"last_trade_at": "2026-04-06T01:24:41Z",
"market": {
"id": "1881148",
"question": "Spread: Hornets (-3.5)",
"slug": "nba-cha-min-2026-04-05-spread-away-3pt5",
"start_date": "2026-04-05T18:13:02Z",
"end_date": "2026-04-05T23:00:00Z",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png",
"neg_risk": false,
"event_slug": "nba-cha-min-2026-04-05",
"series_slug": "nba-2026",
"tags": [
"sports",
"basketball",
"nba",
"games"
],
"outcome_1": "Hornets",
"outcome_2": "Timberwolves",
"group_item_title": "Spread -3.5",
"event_title": "Hornets vs. Timberwolves",
"event_icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png",
"resolved_at": "",
"winning_outcome": ""
}
},
{
"pnl": "21847823040",
"volume": "71494998459",
"roi": 88.64229944284625,
"last_trade_at": "2026-04-06T01:24:19Z",
"market": {
"id": "1883510",
"question": "Spread: Hornets (-4.5)",
"slug": "nba-cha-min-2026-04-05-spread-away-4pt5",
"start_date": "2026-04-05T22:12:38Z",
"end_date": "2026-04-05T23:00:00Z",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png",
"neg_risk": false,
"event_slug": "nba-cha-min-2026-04-05",
"series_slug": "nba-2026",
"tags": [
"sports",
"basketball",
"nba",
"games"
],
"outcome_1": "Hornets",
"outcome_2": "Timberwolves",
"group_item_title": "Spread -4.5",
"event_title": "Hornets vs. Timberwolves",
"event_icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png",
"resolved_at": "",
"winning_outcome": ""
}
},
{
"pnl": "61203112561",
"volume": "256132274818",
"roi": 62.207768015697674,
"last_trade_at": "2026-04-06T01:23:59Z",
"market": {
"id": "1791503",
"question": "Hornets vs. Timberwolves",
"slug": "nba-cha-min-2026-04-05",
"start_date": "2026-03-30T14:03:07Z",
"end_date": "2026-04-05T23:00:00Z",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png",
"neg_risk": false,
"event_slug": "nba-cha-min-2026-04-05",
"series_slug": "nba-2026",
"tags": [
"sports",
"basketball",
"nba",
"games"
],
"outcome_1": "Hornets",
"outcome_2": "Timberwolves",
"group_item_title": "",
"event_title": "Hornets vs. Timberwolves",
"event_icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png",
"resolved_at": "2026-04-06T03:27:05Z",
"winning_outcome": "Hornets"
}
},
{
"pnl": "0",
"volume": "149999999997",
"roi": 0,
"last_trade_at": "2026-04-06T00:45:59Z",
"market": {
"id": "1791537",
"question": "Lakers vs. Mavericks",
"slug": "nba-lal-dal-2026-04-05",
"start_date": "2026-03-30T14:02:51Z",
"end_date": "2026-04-05T23:30:00Z",
"icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png",
"neg_risk": false,
"event_slug": "nba-lal-dal-2026-04-05",
"series_slug": "nba-2026",
"tags": [
"sports",
"basketball",
"nba",
"games"
],
"outcome_1": "Lakers",
"outcome_2": "Mavericks",
"group_item_title": "",
"event_title": "Lakers vs. Mavericks",
"event_icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/super+cool+basketball+in+red+and+blue+wow.png",
"resolved_at": "",
"winning_outcome": ""
}
}
],
"total_count": 414
}