List Polymarket user profit over time
List a Polymarket wallet's profit and loss over time.
Headers
Get your API keyAPI key (`sfk_...`)
Wallet address: 0x followed by 40 hex digits.
pattern: ^0x[0-9a-fA-F]{40}$
How far back to go. Default: `1m`.
one of: 6h, 12h, 1d, 1w, 1m, all, max
Spacing of the points. Default: `1d`.
one of: 1h, 3h, 12h, 18h, 1d
Endpoint-specific response payload.
`found` on success. A wallet that never traded returns an empty list.
one of: found, not_found
The wallet asked for.
The range returned.
The spacing returned.
Oldest first.
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/pnl?interval=1m&fidelity=1d" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket user profit.