Get Polymarket user statistics
Get a Polymarket wallet's profit and loss, volume and biggest win.
Headers
Get your API keyAPI key (`sfk_...`)
Wallet address: 0x followed by 40 hex digits.
pattern: ^0x[0-9a-fA-F]{40}$
Endpoint-specific response payload.
`not_found` when the wallet has never traded.
one of: found, not_found
The wallet asked for.
Headline statistics for a wallet.
Polymarket's headline trade count for the profile. It is a different counter from the one in the profit and loss breakdown.
Largest single win in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Times the profile page was viewed.
When the wallet first traded (ISO-8601, UTC).
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.
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.
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.
Time the figures describe (ISO-8601, UTC).
Polygon block the figures were computed at.
Realized profit from trading, US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
Realized profit from providing liquidity. A number, or an exact decimal string when the value has more digits than a number can hold.
Realized profit from combined positions. A number, or an exact decimal string when the value has more digits than a number can hold.
All realized profit. A number, or an exact decimal string when the value has more digits than a number can hold.
Profit on paper. A number, or an exact decimal string when the value has more digits than a number can hold.
Profit on positions: realized plus unrealized. A number, or an exact decimal string when the value has more digits than a number can hold.
Profit from trades. A number, or an exact decimal string when the value has more digits than a number can hold.
Liquidity reward income. A number, or an exact decimal string when the value has more digits than a number can hold.
Maker rebates received. A number, or an exact decimal string when the value has more digits than a number can hold.
Taker rebates received. A number, or an exact decimal string when the value has more digits than a number can hold.
Yield income. A number, or an exact decimal string when the value has more digits than a number can hold.
Referral income. A number, or an exact decimal string when the value has more digits than a number can hold.
Sponsored income. A number, or an exact decimal string when the value has more digits than a number can hold.
Income received by the wallet. A number, or an exact decimal string when the value has more digits than a number can hold.
Fees refunded. A number, or an exact decimal string when the value has more digits than a number can hold.
Fees paid. A number, or an exact decimal string when the value has more digits than a number can hold.
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.
Dollars deposited. A number, or an exact decimal string when the value has more digits than a number can hold.
Dollars withdrawn. A number, or an exact decimal string when the value has more digits than a number can hold.
Deposits minus withdrawals. A number, or an exact decimal string when the value has more digits than a number can hold.
Settled profit: realized plus income. A number, or an exact decimal string when the value has more digits than a number can hold.
Economic profit: settled plus unrealized. A number, or an exact decimal string when the value has more digits than a number can hold.
Traded volume, US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.
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.
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.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
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.