> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polyedge.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Trader Markets

> Retrieve a history of all markets where a specific trader has been active.

Retrieve a paginated list of markets a trader has participated in, along with their per-market performance including PNL, ROI, and volume. This is useful for analyzing a trader's focus areas and historical success rate.

```
GET /v1/traders/:address/markets
```

<ParamField header="X-PolyEdge-Key" type="string" required>
  Your PolyEdge API key.
</ParamField>

## Parameters

<ParamField path="address" type="string" required>
  The EVM wallet address of the trader.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Number of markets to return. Maximum: `100`.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Pagination offset.
</ParamField>

<ParamField query="is_active" type="boolean">
  Filter by active (unresolved) markets only. If omitted, both active and resolved markets are returned.
</ParamField>

<ParamField query="include_orders" type="boolean">
  If true, includes the trader's individual orders for each market. Requires individual or pro tier.
</ParamField>

## Response

<ResponseField name="history" type="object[]">
  Array of market performance records, ordered by most recent trade.

  <Expandable title="properties">
    <ResponseField name="pnl" type="string">
      The trader's profit and loss in this market, in micro-USDC.
    </ResponseField>

    <ResponseField name="volume" type="string">
      The trader's total trading volume in this market, in micro-USDC.
    </ResponseField>

    <ResponseField name="roi" type="float">
      Return on investment for this market as a percentage.
    </ResponseField>

    <ResponseField name="last_trade_at" type="string">
      ISO 8601 timestamp of the trader's most recent trade in this market.
    </ResponseField>

    <ResponseField name="market" type="object">
      Details about the market.

      <Expandable title="properties">
        <ResponseField name="id" type="string">
          Unique market ID.
        </ResponseField>

        <ResponseField name="question" type="string">
          The market question.
        </ResponseField>

        <ResponseField name="slug" type="string">
          URL-friendly market identifier.
        </ResponseField>

        <ResponseField name="start_date" type="string">
          ISO 8601 timestamp of when the market opened.
        </ResponseField>

        <ResponseField name="end_date" type="string">
          ISO 8601 timestamp of when the market closes or closed.
        </ResponseField>

        <ResponseField name="icon" type="string">
          URL to the market's icon image.
        </ResponseField>

        <ResponseField name="neg_risk" type="boolean">
          Whether this is a negative-risk market.
        </ResponseField>

        <ResponseField name="event_slug" type="string">
          Slug of the parent event this market belongs to.
        </ResponseField>

        <ResponseField name="series_slug" type="string">
          Slug of the series this market belongs to (e.g., `nba-2026`).
        </ResponseField>

        <ResponseField name="tags" type="string[]">
          List of category tags applied to this market.
        </ResponseField>

        <ResponseField name="outcome_1" type="string">
          Label for the first outcome.
        </ResponseField>

        <ResponseField name="outcome_2" type="string">
          Label for the second outcome.
        </ResponseField>

        <ResponseField name="group_item_title" type="string">
          Display title for this market within its event group (e.g., `Spread -3.5`).
        </ResponseField>

        <ResponseField name="event_title" type="string">
          Human-readable title of the parent event.
        </ResponseField>

        <ResponseField name="event_icon" type="string">
          URL to the parent event's icon image.
        </ResponseField>

        <ResponseField name="resolved_at" type="string">
          ISO 8601 timestamp of when the market was resolved. Empty string if not yet resolved.
        </ResponseField>

        <ResponseField name="winning_outcome" type="string">
          The winning outcome label. Empty string if the market is not yet resolved.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="orders" type="object[]">
      Array of individual order executions for the trader in this market, ordered by time. Only populated if `include_orders=true`.

      <Expandable title="properties">
        <ResponseField name="time" type="string">
          ISO 8601 timestamp of when the order was executed.
        </ResponseField>

        <ResponseField name="outcome" type="string">
          The outcome the order was placed on.
        </ResponseField>

        <ResponseField name="side" type="string">
          Order direction. Either `BUY` or `SELL`.
        </ResponseField>

        <ResponseField name="price" type="string">
          Execution price in micro-units (6 decimal places).
        </ResponseField>

        <ResponseField name="shares" type="string">
          Number of shares filled, in micro-units.
        </ResponseField>

        <ResponseField name="usdc" type="string">
          USDC value of the order, in micro-USDC.
        </ResponseField>

        <ResponseField name="order_hash" type="string">
          Unique on-chain hash identifying this order.
        </ResponseField>

        <ResponseField name="is_taker" type="boolean">
          `true` if taker, `false` if maker.
        </ResponseField>

        <ResponseField name="token_id" type="string">
          The ERC-1155 token ID.
        </ResponseField>

        <ResponseField name="fee" type="string">
          Fee in micro-USDC.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total_count" type="integer">
  Total number of markets for this trader. Use with `limit` and `offset` for pagination.
</ResponseField>

## Example

```bash theme={null}
curl "https://api.polyedge.dev/v1/traders/0x8a6c6811e8937f9e8afc1b9249fa540262c30b3f/markets?limit=5" \
  -H "X-PolyEdge-Key: YOUR_API_KEY"
```

```json theme={null}
{
  "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
}
```