GET /v1/traders/:address/markets
string
required
Your PolyEdge API key.
Parameters
string
required
The EVM wallet address of the trader.
integer
default:"20"
Number of markets to return. Maximum:
100.integer
default:"0"
Pagination offset.
boolean
Filter by active (unresolved) markets only. If omitted, both active and resolved markets are returned.
boolean
If true, includes the trader’s individual orders for each market. Requires individual or pro tier.
Response
object[]
Array of market performance records, ordered by most recent trade.
Show properties
Show properties
string
The trader’s profit and loss in this market, in micro-USDC.
string
The trader’s total trading volume in this market, in micro-USDC.
float
Return on investment for this market as a percentage.
string
ISO 8601 timestamp of the trader’s most recent trade in this market.
object
Details about the market.
Show properties
Show properties
string
Unique market ID.
string
The market question.
string
URL-friendly market identifier.
string
ISO 8601 timestamp of when the market opened.
string
ISO 8601 timestamp of when the market closes or closed.
string
URL to the market’s icon image.
boolean
Whether this is a negative-risk market.
string
Slug of the parent event this market belongs to.
string
Slug of the series this market belongs to (e.g.,
nba-2026).string[]
List of category tags applied to this market.
string
Label for the first outcome.
string
Label for the second outcome.
string
Display title for this market within its event group (e.g.,
Spread -3.5).string
Human-readable title of the parent event.
string
URL to the parent event’s icon image.
string
ISO 8601 timestamp of when the market was resolved. Empty string if not yet resolved.
string
The winning outcome label. Empty string if the market is not yet resolved.
object[]
Array of individual order executions for the trader in this market, ordered by time. Only populated if
include_orders=true.Show properties
Show properties
string
ISO 8601 timestamp of when the order was executed.
string
The outcome the order was placed on.
string
Order direction. Either
BUY or SELL.string
Execution price in micro-units (6 decimal places).
string
Number of shares filled, in micro-units.
string
USDC value of the order, in micro-USDC.
string
Unique on-chain hash identifying this order.
boolean
true if taker, false if maker.string
The ERC-1155 token ID.
string
Fee in micro-USDC.
integer
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
}