Skip to main content
GET
/
polymarket
/
trader
/
pnl
/
{address}
/
periods
Get trader best and worst PnL periods
curl --request GET \
  --url https://api.struct.to/v1/polymarket/trader/pnl/{address}/periods
{
  "timeframe": "<string>",
  "resolution": "<string>",
  "points": 1,
  "total_pnl_day": {
    "best": {
      "from": 1,
      "to": 1,
      "change": 123,
      "change_pct": 123
    },
    "worst": {
      "from": 1,
      "to": 1,
      "change": 123,
      "change_pct": 123
    }
  },
  "total_pnl_week": {
    "best": {
      "from": 1,
      "to": 1,
      "change": 123,
      "change_pct": 123
    },
    "worst": {
      "from": 1,
      "to": 1,
      "change": 123,
      "change_pct": 123
    }
  },
  "total_pnl_month": {
    "best": {
      "from": 1,
      "to": 1,
      "change": 123,
      "change_pct": 123
    },
    "worst": {
      "from": 1,
      "to": 1,
      "change": 123,
      "change_pct": 123
    }
  },
  "portfolio_day": {
    "best": {
      "from": 1,
      "to": 1,
      "change": 123,
      "change_pct": 123
    },
    "worst": {
      "from": 1,
      "to": 1,
      "change": 123,
      "change_pct": 123
    }
  },
  "portfolio_week": {
    "best": {
      "from": 1,
      "to": 1,
      "change": 123,
      "change_pct": 123
    },
    "worst": {
      "from": 1,
      "to": 1,
      "change": 123,
      "change_pct": 123
    }
  },
  "portfolio_month": {
    "best": {
      "from": 1,
      "to": 1,
      "change": 123,
      "change_pct": 123
    },
    "worst": {
      "from": 1,
      "to": 1,
      "change": 123,
      "change_pct": 123
    }
  },
  "from": 1,
  "to": 1
}

Path Parameters

address
string
required

Trader wallet address

Query Parameters

timeframe
enum<string>

Default: lifetime

Available options:
1d,
24h,
7d,
30d,
lifetime

Response

200 - application/json

Best and worst PnL periods

timeframe
string
required
resolution
string
required
points
integer
required
Required range: x >= 0
total_pnl_day
object
required
total_pnl_week
object
required
total_pnl_month
object
required
portfolio_day
object
required
portfolio_week
object
required
portfolio_month
object
required
from
integer<int64> | null
Required range: x >= 0
to
integer<int64> | null
Required range: x >= 0
Last modified on June 13, 2026