> ## 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 Profile

> Get detailed performance statistics and metadata for a specific Polymarket trader.

Retrieve a trader's full profile, including metadata, a breakdown of their performance by market category, and aggregate stats across multiple time frames from 1 hour to 30 days.

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

<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>

## Response

<ResponseField name="profile" type="object">
  Trader profile metadata.

  <Expandable title="properties">
    <ResponseField name="address" type="string">
      The trader's EVM wallet address.
    </ResponseField>

    <ResponseField name="name" type="string">
      The trader's display name.
    </ResponseField>

    <ResponseField name="profile_image" type="string">
      URL to the trader's profile image.
    </ResponseField>

    <ResponseField name="x_username" type="string">
      The trader's X (Twitter) username, if set.
    </ResponseField>

    <ResponseField name="profile_created_at" type="string">
      ISO 8601 timestamp of when the trader's profile was created.
    </ResponseField>

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

<ResponseField name="top_tags" type="object[]">
  The trader's most active market categories, ranked by PNL.

  <Expandable title="properties">
    <ResponseField name="slug" type="string">
      The tag identifier (e.g., `sports`, `basketball`, `crypto`).
    </ResponseField>

    <ResponseField name="pnl" type="string">
      Profit and loss in this category, in micro-USDC.
    </ResponseField>

    <ResponseField name="volume" type="string">
      Total trading volume in this category, in micro-USDC.
    </ResponseField>

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

    <ResponseField name="win_rate" type="float">
      Percentage of markets in this category where the trader was profitable.
    </ResponseField>

    <ResponseField name="markets_count" type="integer">
      Number of markets traded in this category.
    </ResponseField>

    <ResponseField name="maker_volume" type="string">
      Volume traded as a market maker, in micro-USDC.
    </ResponseField>

    <ResponseField name="taker_volume" type="string">
      Volume traded as a market taker, in micro-USDC.
    </ResponseField>

    <ResponseField name="wins_count" type="integer">
      Number of profitable markets in this category.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="stats" type="object">
  Aggregate performance metrics broken down by time frame.

  <Expandable title="properties">
    <ResponseField name="t_1h" type="object">
      Stats for the last 1 hour.

      <Expandable title="properties">
        <ResponseField name="pnl" type="string">PNL in micro-USDC.</ResponseField>
        <ResponseField name="volume" type="string">Total volume in micro-USDC.</ResponseField>
        <ResponseField name="roi" type="float">ROI as a percentage.</ResponseField>
        <ResponseField name="win_rate" type="float">Win rate as a percentage.</ResponseField>
        <ResponseField name="markets_count" type="integer">Number of markets traded.</ResponseField>
        <ResponseField name="wins_count" type="integer">Number of winning markets.</ResponseField>
        <ResponseField name="maker_volume" type="string">Maker volume in micro-USDC.</ResponseField>
        <ResponseField name="taker_volume" type="string">Taker volume in micro-USDC.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="t_4h" type="object">Stats for the last 4 hours. Same structure as `t_1h`.</ResponseField>
    <ResponseField name="t_1d" type="object">Stats for the last 1 day. Same structure as `t_1h`.</ResponseField>
    <ResponseField name="t_3d" type="object">Stats for the last 3 days. Same structure as `t_1h`.</ResponseField>
    <ResponseField name="t_7d" type="object">Stats for the last 7 days. Same structure as `t_1h`.</ResponseField>
    <ResponseField name="t_30d" type="object">Stats for the last 30 days. Same structure as `t_1h`.</ResponseField>
  </Expandable>
</ResponseField>

## Example

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

```json theme={null}
{
  "profile": {
    "address": "0x8a6c6811e8937f9e8afc1b9249fa540262c30b3f",
    "name": "0x8a6C6811e8937F9E8aFc1b9249FA540262c30b3f-1771776258725",
    "profile_image": "",
    "x_username": "",
    "profile_created_at": "2026-02-22 16:04:19Z",
    "last_trade_at": "2026-04-06 02:28:21Z"
  },
  "top_tags": [
    {
      "slug": "sports",
      "pnl": "965904212405",
      "volume": "30595925594119",
      "roi": 6.45,
      "win_rate": 50.92,
      "markets_count": 379,
      "maker_volume": "0",
      "taker_volume": "30595925594119",
      "wins_count": 193
    },
    {
      "slug": "basketball",
      "pnl": "898380238650",
      "volume": "20784425983134",
      "roi": 8.88,
      "win_rate": 52.99,
      "markets_count": 234,
      "maker_volume": "0",
      "taker_volume": "20784425983134",
      "wins_count": 124
    },
    {
      "slug": "soccer",
      "pnl": "42561666472",
      "volume": "9447112325675",
      "roi": 0.9,
      "win_rate": 47.1,
      "markets_count": 138,
      "maker_volume": "0",
      "taker_volume": "9447112325675",
      "wins_count": 65
    },
    {
      "slug": "hockey",
      "pnl": "-29972692713",
      "volume": "364387285310",
      "roi": -15.2,
      "win_rate": 57.14,
      "markets_count": 7,
      "maker_volume": "0",
      "taker_volume": "364387285310",
      "wins_count": 4
    }
  ],
  "stats": {
    "t_1h": {
      "pnl": "0",
      "volume": "0",
      "roi": 0,
      "win_rate": 0,
      "markets_count": 0,
      "wins_count": 0,
      "maker_volume": "0",
      "taker_volume": "0"
    },
    "t_4h": {
      "pnl": "103300586785",
      "volume": "698084015866",
      "roi": 70.49,
      "win_rate": 42.86,
      "markets_count": 7,
      "wins_count": 3,
      "maker_volume": "0",
      "taker_volume": "698084015866"
    },
    "t_1d": {
      "pnl": "257476829738",
      "volume": "1507351273690",
      "roi": 57.29,
      "win_rate": 50,
      "markets_count": 18,
      "wins_count": 9,
      "maker_volume": "0",
      "taker_volume": "1507351273690"
    },
    "t_3d": {
      "pnl": "607299024186",
      "volume": "3430098687485",
      "roi": 48.83,
      "win_rate": 60.87,
      "markets_count": 46,
      "wins_count": 28,
      "maker_volume": "0",
      "taker_volume": "3430098687485"
    },
    "t_7d": {
      "pnl": "419694044839",
      "volume": "6941403786226",
      "roi": 13.52,
      "win_rate": 53.75,
      "markets_count": 80,
      "wins_count": 43,
      "maker_volume": "0",
      "taker_volume": "6941403786226"
    },
    "t_30d": {
      "pnl": "965904212405",
      "volume": "30595925594119",
      "roi": 6.45,
      "win_rate": 50.92,
      "markets_count": 379,
      "wins_count": 193,
      "maker_volume": "0",
      "taker_volume": "30595925594119"
    }
  }
}
```