Get Hourly PnL Equity Curve
Provides 1-hour bucketed historical equity changes, trading volumes, cost basis, fees, and win counts
GET/v2/traders/{address}/hourly_stats
Request Parameters
Required headers and parameter specifications for this endpoint.
Headers
| Header | Type | Required | Description |
|---|---|---|---|
| X-PolyEdge-Key | string | required | PolyEdge API Key for client authentication and rate-limiting |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| address | string | required | EVM address (0x...) |
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
tag | string | all | Market category tag filter |
series | string | - | Market series filter |
Response (200 OK)
Field definitions for the successful response payload.
200 Response Example
json
{
"stats": [
{
"cost_basis": 24850660246,
"fee": 24967290,
"hour": "2026-09-29 08:00:00",
"maker_volume": 54634701927,
"market_count": 11,
"pnl": -3733716975,
"taker_volume": 2014738300,
"win_count": 1
},
{
"cost_basis": 58685497235,
"fee": 229019300,
"hour": "2026-09-29 07:00:00",
"maker_volume": 89042160705,
"market_count": 7,
"pnl": -2436265096,
"taker_volume": 11325414859,
"win_count": 2
},
{
"cost_basis": 26861556625,
"fee": 137163810,
"hour": "2026-09-29 06:00:00",
"maker_volume": 56103815299,
"market_count": 6,
"pnl": -7543438889,
"taker_volume": 6550889000,
"win_count": 4
},
{
"cost_basis": 56643759886,
"fee": 27629740,
"hour": "2026-09-29 05:00:00",
"maker_volume": 79752884138,
"market_count": 9,
"pnl": -9124231198,
"taker_volume": 3239663900,
"win_count": 4
},
{
"cost_basis": 100586059150,
"fee": 187141530,
"hour": "2026-09-29 04:00:00",
"maker_volume": 97875954493,
"market_count": 7,
"pnl": 16158968281,
"taker_volume": 9996537500,
"win_count": 5
},
{
"cost_basis": 58264168212,
"fee": 0,
"hour": "2026-09-29 03:00:00",
"maker_volume": 103850078497,
"market_count": 11,
"pnl": -907598414,
"taker_volume": 10650319200,
"win_count": 5
},
{
"cost_basis": 244598301276,
"fee": 0,
"hour": "2026-09-29 02:00:00",
"maker_volume": 337299848640,
"market_count": 21,
"pnl": 41910104873,
"taker_volume": 80734484200,
"win_count": 17
},
{
"cost_basis": 19681504941,
"fee": 0,
"hour": "2026-09-29 01:00:00",
"maker_volume": 29068503554,
"market_count": 10,
"pnl": 4656127001,
"taker_volume": 1690152300,
"win_count": 4
},
{
"cost_basis": 15954761206,
"fee": 127319540,
"hour": "2026-09-29 00:00:00",
"maker_volume": 18400181445,
"market_count": 17,
"pnl": 1115539395,
"taker_volume": 5324324500,
"win_count": 4
},
{
"cost_basis": 16186316183,
"fee": 0,
"hour": "2026-09-28 23:00:00",
"maker_volume": 16661650511,
"market_count": 16,
"pnl": -2697703575,
"taker_volume": 0,
"win_count": 9
},
{
"cost_basis": 62962321707,
"fee": 14859600,
"hour": "2026-09-28 22:00:00",
"maker_volume": 106987905403,
"market_count": 4,
"pnl": -4151370462,
"taker_volume": 512400000,
"win_count": 2
},
{
"cost_basis": 176232921,
"fee": 0,
"hour": "2026-09-28 21:00:00",
"maker_volume": 2273016386,
"market_count": 2,
"pnl": -146232921,
"taker_volume": 0,
"win_count": 0
},
{
"cost_basis": 249505822798,
"fee": 1103697970,
"hour": "2026-09-28 20:00:00",
"maker_volume": 300128745108,
"market_count": 52,
"pnl": 16419938447,
"taker_volume": 59559214600,
"win_count": 27
},
{
"cost_basis": 83584325941,
"fee": 185309980,
"hour": "2026-09-28 19:00:00",
"maker_volume": 87074639524,
"market_count": 62,
"pnl": 10635643448,
"taker_volume": 8532141900,
"win_count": 34
},
{
"cost_basis": 19432865385,
"fee": 176207010,
"hour": "2026-09-28 18:00:00",
"maker_volume": 19864236234,
"market_count": 14,
"pnl": -1569485304,
"taker_volume": 8359331200,
"win_count": 8
},
{
"cost_basis": 134062963236,
"fee": 66661920,
"hour": "2026-09-28 17:00:00",
"maker_volume": 205401076504,
"market_count": 39,
"pnl": -2489974960,
"taker_volume": 3081100300,
"win_count": 18
},
{
"cost_basis": 63109143468,
"fee": 443641730,
"hour": "2026-09-28 16:00:00",
"maker_volume": 79360491013,
"market_count": 19,
"pnl": -13108653801,
"taker_volume": 19910641500,
"win_count": 10
},
{
"cost_basis": 33584160371,
"fee": 0,
"hour": "2026-09-28 15:00:00",
"maker_volume": 39283221819,
"market_count": 5,
"pnl": 22405808569,
"taker_volume": 0,
"win_count": 4
},
{
"cost_basis": 8990190720,
"fee": 0,
"hour": "2026-09-28 14:00:00",
"maker_volume": 10999841826,
"market_count": 4,
"pnl": -3126014881,
"taker_volume": 0,
"win_count": 1
},
{
"cost_basis": 62115089128,
"fee": 306717690,
"hour": "2026-09-28 13:00:00",
"maker_volume": 95986999727,
"market_count": 15,
"pnl": 3632154384,
"taker_volume": 15085358068,
"win_count": 7
}
]
}Response Body Fields
| Field | Type | Description |
|---|---|---|
stats | array of objects | Chronological array of 1-hour performance metrics |
├─cost_basis | integer | Aggregate capital cost basis in micro-USD (6 decimals) |
├─fee | integer | Total trading fees incurred in micro-USD (6 decimals) |
├─hour | string | 1-hour UTC bucket timestamp (ISO 8601) |
├─maker_volume | integer | Maker trading volume in micro-USD (6 decimals) |
├─market_count | integer | Number of distinct prediction markets active or settled in this hour |
├─pnl | integer | Realized net PnL in micro-USD (6 decimals) |
├─taker_volume | integer | Taker trading volume in micro-USD (6 decimals) |
├─win_count | integer | Number of profitable markets settled in this hour |
cURL Example
Copy and run this command directly in your terminal to test this endpoint.
cURL: GET /v2/traders/{address}/hourly_stats
bash
curl -X GET "https://api.polyedge.dev/v2/traders/0x2005d16a84ceefa912d4e380cd32e7ff827875ea/hourly_stats?tag=all" \
-H "X-PolyEdge-Key: Your-PolyEdge-ApiKey"