> ## 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 Hourly Stats

> Get hourly aggregated performance data for a specific trader.

Get hourly aggregated performance data for a specific trader. This includes PNL, market count, win count, and volume (taker/maker) grouped by hour. This is ideal for visualizing a trader's activity and performance trends over time.

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

<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="tag" type="string">
  Filter by a specific market tag (e.g., `crypto`, `politics`). Default: `all`.
</ParamField>

## Response

<ResponseField name="stats" type="object[]">
  An array of hourly trading activity metrics.

  <Expandable title="properties">
    <ResponseField name="hour" type="string">
      The hour timestamp (e.g., `2026-04-06 18:00:00`).
    </ResponseField>

    <ResponseField name="pnl" type="string">
      Profit and loss for this hour.
    </ResponseField>

    <ResponseField name="market_count" type="integer">
      Number of markets traded during this hour.
    </ResponseField>

    <ResponseField name="win_count" type="integer">
      Number of winning markets during this hour.
    </ResponseField>

    <ResponseField name="taker_volume" type="string">
      Volume traded as a market taker.
    </ResponseField>

    <ResponseField name="maker_volume" type="string">
      Volume traded as a market maker.
    </ResponseField>

    <ResponseField name="volume" type="string">
      Total trading volume for this hour.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

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

```json theme={null}
{
  "stats": [
    {
      "hour": "2026-04-06 18:00:00",
      "pnl": "349839124594",
      "market_count": 1,
      "win_count": 1,
      "taker_volume": "995695969998",
      "maker_volume": "0",
      "volume": "995695969998"
    },
    {
      "hour": "2026-04-05 19:00:00",
      "pnl": "99364860916",
      "market_count": 1,
      "win_count": 1,
      "taker_volume": "72345918100",
      "maker_volume": "88968339415",
      "volume": "161314257515"
    },
    {
      "hour": "2026-04-05 00:00:00",
      "pnl": "134120706200",
      "market_count": 2,
      "win_count": 2,
      "taker_volume": "124597833800",
      "maker_volume": "0",
      "volume": "124597833800"
    },
    {
      "hour": "2026-04-04 23:00:00",
      "pnl": "-49999999999",
      "market_count": 1,
      "win_count": 0,
      "taker_volume": "49999999999",
      "maker_volume": "0",
      "volume": "49999999999"
    },
    {
      "hour": "2026-04-03 23:00:00",
      "pnl": "128852598730",
      "market_count": 2,
      "win_count": 2,
      "taker_volume": "209480094395",
      "maker_volume": "519896000",
      "volume": "209999990395"
    }
  ]
}
```