Polymarket

Get Polymarket user statistics

Get a Polymarket wallet's profit and loss, volume and biggest win.

GET/v1/polymarket/users/{wallet}/stats
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
walletstringrequiredpath

Wallet address: 0x followed by 40 hex digits.

pattern: ^0x[0-9a-fA-F]{40}$

Response fields
43

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the wallet has never traded.

one of: found, not_found

datawallet
string

The wallet asked for.

Headline statistics for a wallet.

datastatstrades
integernullable

Polymarket's headline trade count for the profile. It is a different counter from the one in the profit and loss breakdown.

datastatsbiggestWin

Largest single win in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

datastatsprofileViews
integernullable

Times the profile page was viewed.

datastatsjoinedAt
stringnullable

When the wallet first traded (ISO-8601, UTC).

datastatsvolume

All-time traded volume in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

datastatsrealizedPnl

All-time realized profit in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

datastatsportfolioValue

Current value of open positions, US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

Profit and loss by source.

datapnlasOf
stringnullable

Time the figures describe (ISO-8601, UTC).

datapnlsourceBlock
integernullable

Polygon block the figures were computed at.

datapnlrealizedMarket

Realized profit from trading, US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlrealizedLp

Realized profit from providing liquidity. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlrealizedCombo

Realized profit from combined positions. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlrealized

All realized profit. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlunrealized

Profit on paper. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlpositionPnl

Profit on positions: realized plus unrealized. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnltradePnl

Profit from trades. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlrewards

Liquidity reward income. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlmakerRebate

Maker rebates received. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnltakerRebate

Taker rebates received. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlyieldIncome

Yield income. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlreferralIncome

Referral income. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlsponsoredIncome

Sponsored income. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlwalletIncome

Income received by the wallet. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlfeesRefunded

Fees refunded. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlfees

Fees paid. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlfeesPaid

Fees paid, as Polymarket's separate total. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnldeposits

Dollars deposited. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlwithdrawals

Dollars withdrawn. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlcashflowNet

Deposits minus withdrawals. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlsettled

Settled profit: realized plus income. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnleconomic

Economic profit: settled plus unrealized. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlvolume

Traded volume, US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnlvolumeUsdc

Traded volume in USDC, as Polymarket's separate total. A number, or an exact decimal string when the value has more digits than a number can hold.

datapnltrades
integernullable

Number of trades counted in the profit and loss breakdown. The profile's headline count is a separate figure.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/polymarket/users/0x56687bf447db6ffa42ffe2204a05edaa20f55839/stats" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Polymarket user stats.