List Polymarket market holders
List the largest holders of each outcome of a Polymarket market.
Headers
Get your API keyAPI key (`sfk_...`)
Condition id of the market: 0x followed by 64 hex digits.
pattern: ^0x[0-9a-fA-F]{64}$
Add each holder's entry price, cost, current value and profit. Default: false.
Only holders with at least this many shares.
≥ 0 · ≤ 1000000000000
Items per page, 1–1000. Default: 20.
≥ 1 · ≤ 1000
Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same.
min 1 chars · max 6000 chars
Endpoint-specific response payload.
`not_found` when no market has this condition id or it has no holders.
one of: found, not_found
The condition id asked for.
One group per outcome token.
Outcome token id.
Position of the outcome in the market.
Largest holder first.
The public profile attached to a wallet.
The trader's wallet address (public on the Polygon chain).
Chosen username, as Polymarket sends it. Null when the trader has not set one. Present even when the holder does not show it on their own profile (see `usernamePublic`).
Whether the holder shows the chosen username publicly on their profile. Null when Polymarket does not say, as on the trade tape.
Auto-generated name such as `Velvety-Relief`.
Profile bio.
Profile image URL.
Whether Polymarket verified the profile.
Shares held. A number, or an exact decimal string when the value has more digits than a number can hold.
Average entry price. Only with `includePnl`.
Dollars paid in. Only with `includePnl`. A number, or an exact decimal string when the value has more digits than a number can hold.
Current value in dollars. Only with `includePnl`. A number, or an exact decimal string when the value has more digits than a number can hold.
Profit already taken. Only with `includePnl`. A number, or an exact decimal string when the value has more digits than a number can hold.
Profit on paper. Only with `includePnl`. A number, or an exact decimal string when the value has more digits than a number can hold.
Realized plus unrealized profit. Only with `includePnl`. A number, or an exact decimal string when the value has more digits than a number can hold.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
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/markets/0x0f49db97f71c68b1e42a6d16e3de93d85dbf7d4148e3f018eb79e88554be9f75/holders?includePnl=true&limit=5" \
-H "x-api-key: YOUR_API_KEY"Responses
Polymarket market holders.