Polymarket Get Top Holders
Get the top holders for a Polymarket prediction market by condition ID. Returns holders for each outcome token including wallet, pseudonym, share amount, and verification status. Ideal for: whale tracking, market sentiment analysis, holder distribution research.
Catalog action Utility
Get the top holders for a Polymarket prediction market by condition ID. Returns holders for each outcome token including wallet, pseudonym, share amount, and verification status. Ideal for: whale tracking, market sentiment analysis, holder distribution research.
At a Glance
| Field | Value |
|---|---|
| Action ID | polymarket-get-top-holders |
| Category | Utility |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | polymarket, holders, market-data, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
conditionId | string | Yes | The condition ID of the Polymarket market to get top holders for. |
limit | number | No | Maximum number of holders to return per outcome (default: 20, max: 100) |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
outcomes | array | Yes | Array of outcomes with their top holders |
conditionId | string | Yes | The condition ID queried |
Examples
json{ "type": "polymarket-get-top-holders", "payload": { "conditionId": "example-conditionId" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/polymarket-get-top-holders/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "conditionId": "example-conditionId" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.