# Polymarket (/integrations/polymarket)





{/* MANUAL-CONTENT-START:intro */}

Use [Polymarket](https://polymarket.com) in Sim to retrieve prediction-market data: markets, events, orderbooks, prices, price history, positions, trades, and related statistics. These read operations support research, reporting, and monitoring workflows.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Get markets, market, events, event, tags, series, orderbook, price, midpoint, price history, last trade price, spread, tick size, positions, trades, activity, leaderboard, holders, and search.

## Actions [#actions]

### Get Markets from Polymarket [#get-markets-from-polymarket]

Retrieve a list of prediction markets from Polymarket with optional filtering

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `closed` | string | No | Filter by closed status (true/false). Use false for open markets only. |
  | `order` | string | No | Sort field (e.g., volumeNum, liquidityNum, startDate, endDate, createdAt) |
  | `ascending` | string | No | Sort direction (true for ascending, false for descending) |
  | `tagId` | string | No | Filter by tag ID |
  | `limit` | string | No | Number of results per page (e.g., "25"). Max: 50. |
  | `offset` | string | No | Number of results to skip for pagination (e.g., "50"). |

  #### Output [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `markets` | array | Array of market objects |
  | ↳ `id` | string | Market ID |
  | ↳ `question` | string | Market question |
  | ↳ `conditionId` | string | Condition ID |
  | ↳ `slug` | string | Market slug |
  | ↳ `endDate` | string | End date |
  | ↳ `image` | string | Market image URL |
  | ↳ `outcomes` | string | Outcomes JSON string |
  | ↳ `outcomePrices` | string | Outcome prices JSON string |
  | ↳ `volume` | string | Total volume |
  | ↳ `liquidity` | string | Total liquidity |
  | ↳ `active` | boolean | Whether market is active |
  | ↳ `closed` | boolean | Whether market is closed |
  | ↳ `volumeNum` | number | Volume as number |
  | ↳ `liquidityNum` | number | Liquidity as number |
  | ↳ `clobTokenIds` | array | CLOB token IDs |
</ReferenceDetails>

### Get Market from Polymarket [#get-market-from-polymarket]

Retrieve details of a specific prediction market by ID or slug

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `marketId` | string | No | The numeric market ID (e.g., "253591"). Required if slug is not provided. Not the condition ID. |
  | `slug` | string | No | The market slug (e.g., "will-trump-win"). URL-friendly identifier. Required if marketId is not provided. |

  #### Output [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `market` | object | Market object with details |
  | ↳ `id` | string | Market ID |
  | ↳ `question` | string | Market question |
  | ↳ `conditionId` | string | Condition ID |
  | ↳ `slug` | string | Market slug |
  | ↳ `resolutionSource` | string | Resolution source |
  | ↳ `endDate` | string | End date |
  | ↳ `startDate` | string | Start date |
  | ↳ `image` | string | Market image URL |
  | ↳ `icon` | string | Market icon URL |
  | ↳ `description` | string | Market description |
  | ↳ `outcomes` | string | Outcomes JSON string |
  | ↳ `outcomePrices` | string | Outcome prices JSON string |
  | ↳ `volume` | string | Total volume |
  | ↳ `liquidity` | string | Total liquidity |
  | ↳ `active` | boolean | Whether market is active |
  | ↳ `closed` | boolean | Whether market is closed |
  | ↳ `archived` | boolean | Whether market is archived |
  | ↳ `volumeNum` | number | Volume as number |
  | ↳ `liquidityNum` | number | Liquidity as number |
  | ↳ `clobTokenIds` | array | CLOB token IDs |
  | ↳ `acceptingOrders` | boolean | Whether accepting orders |
  | ↳ `negRisk` | boolean | Whether negative risk |
</ReferenceDetails>

### Get Events from Polymarket [#get-events-from-polymarket]

Retrieve a list of events from Polymarket with optional filtering

<ReferenceDetails>
  #### Input [#input-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `closed` | string | No | Filter by closed status (true/false). Use false for open events only. |
  | `order` | string | No | Sort field (e.g., volume, liquidity, startDate, endDate, createdAt) |
  | `ascending` | string | No | Sort direction (true for ascending, false for descending) |
  | `tagId` | string | No | Filter by tag ID |
  | `limit` | string | No | Number of results per page (e.g., "25"). Max: 50. |
  | `offset` | string | No | Number of results to skip for pagination (e.g., "50"). |

  #### Output [#output-2]

  | Parameter | Type | Description |
  | - | - | - |
  | `events` | array | Array of event objects |
  | ↳ `id` | string | Event ID |
  | ↳ `ticker` | string | Event ticker |
  | ↳ `slug` | string | Event slug |
  | ↳ `title` | string | Event title |
  | ↳ `description` | string | Event description |
  | ↳ `startDate` | string | Start date |
  | ↳ `endDate` | string | End date |
  | ↳ `image` | string | Event image URL |
  | ↳ `icon` | string | Event icon URL |
  | ↳ `active` | boolean | Whether event is active |
  | ↳ `closed` | boolean | Whether event is closed |
  | ↳ `archived` | boolean | Whether event is archived |
  | ↳ `liquidity` | number | Total liquidity |
  | ↳ `volume` | number | Total volume |
  | ↳ `markets` | array | Array of markets in this event |
</ReferenceDetails>

### Get Event from Polymarket [#get-event-from-polymarket]

Retrieve details of a specific event by ID or slug

<ReferenceDetails>
  #### Input [#input-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `eventId` | string | No | The numeric event ID (e.g., "12345"). Required if slug is not provided. |
  | `slug` | string | No | The event slug (e.g., "2024-presidential-election"). URL-friendly identifier. Required if eventId is not provided. |

  #### Output [#output-3]

  | Parameter | Type | Description |
  | - | - | - |
  | `event` | object | Event object with details |
  | ↳ `id` | string | Event ID |
  | ↳ `ticker` | string | Event ticker |
  | ↳ `slug` | string | Event slug |
  | ↳ `title` | string | Event title |
  | ↳ `description` | string | Event description |
  | ↳ `startDate` | string | Start date |
  | ↳ `creationDate` | string | Creation date |
  | ↳ `endDate` | string | End date |
  | ↳ `image` | string | Event image URL |
  | ↳ `icon` | string | Event icon URL |
  | ↳ `active` | boolean | Whether event is active |
  | ↳ `closed` | boolean | Whether event is closed |
  | ↳ `archived` | boolean | Whether event is archived |
  | ↳ `liquidity` | number | Total liquidity |
  | ↳ `volume` | number | Total volume |
  | ↳ `openInterest` | number | Open interest |
  | ↳ `commentCount` | number | Comment count |
  | ↳ `markets` | array | Array of markets in this event |
</ReferenceDetails>

### Get Tags from Polymarket [#get-tags-from-polymarket]

Retrieve available tags for filtering markets from Polymarket

<ReferenceDetails>
  #### Input [#input-4]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `limit` | string | No | Number of results per page (e.g., "25"). Max: 50. |
  | `offset` | string | No | Number of results to skip for pagination (e.g., "50"). |

  #### Output [#output-4]

  | Parameter | Type | Description |
  | - | - | - |
  | `tags` | array | Array of tag objects |
  | ↳ `id` | string | Tag ID |
  | ↳ `label` | string | Tag label |
  | ↳ `slug` | string | Tag slug |
  | ↳ `createdAt` | string | Creation timestamp |
  | ↳ `updatedAt` | string | Last update timestamp |
</ReferenceDetails>

### Search Polymarket [#search-polymarket]

Search for markets, events, and profiles on Polymarket

<ReferenceDetails>
  #### Input [#input-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `query` | string | Yes | Search query term (e.g., "presidential election", "bitcoin price"). |
  | `limit` | string | No | Maximum number of results per type (events, tags, profiles). Default: 50. |
  | `page` | string | No | Page number for pagination (e.g., "2"). 1-indexed. |
  | `cache` | string | No | Enable caching (true/false) |
  | `eventsStatus` | string | No | Filter events by status |
  | `eventsTag` | string | No | Filter by event tags (comma-separated) |
  | `sort` | string | No | Sort field |
  | `ascending` | string | No | Sort direction (true for ascending, false for descending) |
  | `searchTags` | string | No | Include tags in search results (true/false) |
  | `searchProfiles` | string | No | Include profiles in search results (true/false) |
  | `recurrence` | string | No | Filter by recurrence type |
  | `excludeTagId` | string | No | Exclude events with these tag IDs (comma-separated) |
  | `keepClosedMarkets` | string | No | Include closed markets in results (0 or 1) |

  #### Output [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `results` | object | Search results containing events, tags, and profiles arrays |
  | ↳ `events` | array | Array of matching event objects (markets nested) |
  | ↳ `tags` | array | Array of matching tag objects |
  | ↳ `profiles` | array | Array of matching profile objects |
</ReferenceDetails>

### Get Series from Polymarket [#get-series-from-polymarket]

Retrieve series (related market groups) from Polymarket

<ReferenceDetails>
  #### Input [#input-6]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `limit` | string | No | Number of results per page (e.g., "25"). Max: 50. |
  | `offset` | string | No | Number of results to skip for pagination (e.g., "50"). |

  #### Output [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `series` | array | Array of series objects |
  | ↳ `id` | string | Series ID |
  | ↳ `ticker` | string | Series ticker |
  | ↳ `slug` | string | Series slug |
  | ↳ `title` | string | Series title |
  | ↳ `seriesType` | string | Series type |
  | ↳ `recurrence` | string | Recurrence pattern |
  | ↳ `image` | string | Series image URL |
  | ↳ `icon` | string | Series icon URL |
  | ↳ `active` | boolean | Whether series is active |
  | ↳ `closed` | boolean | Whether series is closed |
  | ↳ `archived` | boolean | Whether series is archived |
  | ↳ `featured` | boolean | Whether series is featured |
  | ↳ `volume` | number | Total volume |
  | ↳ `liquidity` | number | Total liquidity |
  | ↳ `eventCount` | number | Number of events in series |
</ReferenceDetails>

### Get Series by ID from Polymarket [#get-series-by-id-from-polymarket]

Retrieve a specific series (related market group) by ID from Polymarket

<ReferenceDetails>
  #### Input [#input-7]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `seriesId` | string | Yes | The numeric series ID (e.g., "12345"). |

  #### Output [#output-7]

  | Parameter | Type | Description |
  | - | - | - |
  | `series` | object | Series object with details |
  | ↳ `id` | string | Series ID |
  | ↳ `ticker` | string | Series ticker |
  | ↳ `slug` | string | Series slug |
  | ↳ `title` | string | Series title |
  | ↳ `seriesType` | string | Series type |
  | ↳ `recurrence` | string | Recurrence pattern |
  | ↳ `image` | string | Series image URL |
  | ↳ `icon` | string | Series icon URL |
  | ↳ `active` | boolean | Whether series is active |
  | ↳ `closed` | boolean | Whether series is closed |
  | ↳ `archived` | boolean | Whether series is archived |
  | ↳ `featured` | boolean | Whether series is featured |
  | ↳ `volume` | number | Total volume |
  | ↳ `liquidity` | number | Total liquidity |
  | ↳ `commentCount` | number | Comment count |
  | ↳ `eventCount` | number | Number of events in series |
  | ↳ `events` | array | Array of events in this series |
</ReferenceDetails>

### Get Orderbook from Polymarket [#get-orderbook-from-polymarket]

Retrieve the order book summary for a specific token

<ReferenceDetails>
  #### Input [#input-8]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `tokenId` | string | Yes | The CLOB token ID from market clobTokenIds array (e.g., "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |

  #### Output [#output-8]

  | Parameter | Type | Description |
  | - | - | - |
  | `orderbook` | object | Order book with bids and asks arrays |
  | ↳ `market` | string | Market identifier |
  | ↳ `asset_id` | string | Asset token ID |
  | ↳ `hash` | string | Order book hash |
  | ↳ `timestamp` | string | Timestamp |
  | ↳ `bids` | array | Bid orders |
  | ↳ `price` | string | Bid price |
  | ↳ `size` | string | Bid size |
  | ↳ `asks` | array | Ask orders |
  | ↳ `price` | string | Ask price |
  | ↳ `size` | string | Ask size |
  | ↳ `min_order_size` | string | Minimum order size |
  | ↳ `tick_size` | string | Tick size |
  | ↳ `neg_risk` | boolean | Whether negative risk |
  | ↳ `last_trade_price` | string | Last trade price |
</ReferenceDetails>

### Get Price from Polymarket [#get-price-from-polymarket]

Retrieve the market price for a specific token and side

<ReferenceDetails>
  #### Input [#input-9]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `tokenId` | string | Yes | The CLOB token ID from market clobTokenIds array (e.g., "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |
  | `side` | string | Yes | Order side: "buy" or "sell". |

  #### Output [#output-9]

  | Parameter | Type | Description |
  | - | - | - |
  | `price` | string | Market price |
</ReferenceDetails>

### Get Midpoint Price from Polymarket [#get-midpoint-price-from-polymarket]

Retrieve the midpoint price for a specific token

<ReferenceDetails>
  #### Input [#input-10]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `tokenId` | string | Yes | The CLOB token ID from market clobTokenIds array (e.g., "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |

  #### Output [#output-10]

  | Parameter | Type | Description |
  | - | - | - |
  | `midpoint` | string | Midpoint price |
</ReferenceDetails>

### Get Price History from Polymarket [#get-price-history-from-polymarket]

Retrieve historical price data for a specific market token

<ReferenceDetails>
  #### Input [#input-11]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `tokenId` | string | Yes | The CLOB token ID from market clobTokenIds array (e.g., "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |
  | `interval` | string | No | Duration ending at current time (1m, 1h, 6h, 1d, 1w, max). Mutually exclusive with startTs/endTs. |
  | `fidelity` | number | No | Data resolution in minutes (e.g., 60 for hourly) |
  | `startTs` | number | No | Start timestamp (Unix seconds UTC) |
  | `endTs` | number | No | End timestamp (Unix seconds UTC) |

  #### Output [#output-11]

  | Parameter | Type | Description |
  | - | - | - |
  | `history` | array | Array of price history entries |
  | ↳ `t` | number | Unix timestamp |
  | ↳ `p` | number | Price at timestamp |
</ReferenceDetails>

### Get Last Trade Price from Polymarket [#get-last-trade-price-from-polymarket]

Retrieve the last trade price for a specific token

<ReferenceDetails>
  #### Input [#input-12]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `tokenId` | string | Yes | The CLOB token ID from market clobTokenIds array (e.g., "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |

  #### Output [#output-12]

  | Parameter | Type | Description |
  | - | - | - |
  | `price` | string | Last trade price |
  | `side` | string | Side of the last trade (BUY or SELL) |
</ReferenceDetails>

### Get Spread from Polymarket [#get-spread-from-polymarket]

Retrieve the bid-ask spread for a specific token

<ReferenceDetails>
  #### Input [#input-13]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `tokenId` | string | Yes | The CLOB token ID from market clobTokenIds array (e.g., "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |

  #### Output [#output-13]

  | Parameter | Type | Description |
  | - | - | - |
  | `spread` | object | Spread value between bid and ask |
  | ↳ `spread` | string | The spread value |
</ReferenceDetails>

### Get Tick Size from Polymarket [#get-tick-size-from-polymarket]

Retrieve the minimum tick size for a specific token

<ReferenceDetails>
  #### Input [#input-14]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `tokenId` | string | Yes | The CLOB token ID from market clobTokenIds array (e.g., "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |

  #### Output [#output-14]

  | Parameter | Type | Description |
  | - | - | - |
  | `tickSize` | string | Minimum tick size |
</ReferenceDetails>

### Get Positions from Polymarket [#get-positions-from-polymarket]

Retrieve user positions from Polymarket

<ReferenceDetails>
  #### Input [#input-15]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `user` | string | Yes | User wallet address |
  | `market` | string | No | Condition IDs to filter positions (e.g., "0x1234...abcd,0x5678...efgh"). Mutually exclusive with eventId. |
  | `eventId` | string | No | Event ID to filter positions (e.g., "12345"). Mutually exclusive with market. |
  | `sizeThreshold` | string | No | Minimum position size threshold (default: 1) |
  | `redeemable` | string | No | Filter for redeemable positions only (true/false) |
  | `mergeable` | string | No | Filter for mergeable positions only (true/false) |
  | `sortBy` | string | No | Sort field (TOKENS, CURRENT, INITIAL, CASHPNL, PERCENTPNL, TITLE, RESOLVING, PRICE, AVGPRICE) |
  | `sortDirection` | string | No | Sort direction (ASC or DESC) |
  | `title` | string | No | Search filter by title |
  | `limit` | string | No | Number of results per page (e.g., "25"). |
  | `offset` | string | No | Number of results to skip for pagination (e.g., "50"). |

  #### Output [#output-15]

  | Parameter | Type | Description |
  | - | - | - |
  | `positions` | array | Array of position objects |
  | ↳ `proxyWallet` | string | Proxy wallet address |
  | ↳ `asset` | string | Asset token ID |
  | ↳ `conditionId` | string | Condition ID |
  | ↳ `size` | number | Position size |
  | ↳ `avgPrice` | number | Average price |
  | ↳ `initialValue` | number | Initial value |
  | ↳ `currentValue` | number | Current value |
  | ↳ `cashPnl` | number | Cash profit/loss |
  | ↳ `percentPnl` | number | Percent profit/loss |
  | ↳ `totalBought` | number | Total bought |
  | ↳ `realizedPnl` | number | Realized profit/loss |
  | ↳ `percentRealizedPnl` | number | Percent realized profit/loss |
  | ↳ `curPrice` | number | Current price |
  | ↳ `redeemable` | boolean | Whether position is redeemable |
  | ↳ `mergeable` | boolean | Whether position is mergeable |
  | ↳ `title` | string | Market title |
  | ↳ `slug` | string | Market slug |
  | ↳ `icon` | string | Market icon URL |
  | ↳ `eventSlug` | string | Event slug |
  | ↳ `outcome` | string | Outcome name |
  | ↳ `outcomeIndex` | number | Outcome index |
  | ↳ `oppositeOutcome` | string | Opposite outcome name |
  | ↳ `oppositeAsset` | string | Opposite asset token ID |
  | ↳ `endDate` | string | End date |
  | ↳ `negativeRisk` | boolean | Whether negative risk |
</ReferenceDetails>

### Get Trades from Polymarket [#get-trades-from-polymarket]

Retrieve trade history from Polymarket

<ReferenceDetails>
  #### Input [#input-16]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `user` | string | No | User wallet address to filter trades |
  | `market` | string | No | Market/condition ID to filter trades (e.g., "0x1234...abcd"). Mutually exclusive with eventId. |
  | `eventId` | string | No | Event ID to filter trades (e.g., "12345"). Mutually exclusive with market. |
  | `side` | string | No | Trade direction filter (BUY or SELL) |
  | `takerOnly` | string | No | Filter for taker trades only (true/false, default: true) |
  | `filterType` | string | No | Filter type (CASH or TOKENS) - requires filterAmount |
  | `filterAmount` | string | No | Filter amount threshold - requires filterType |
  | `limit` | string | No | Number of results per page (e.g., "50"). Default: 100, max: 10000. |
  | `offset` | string | No | Number of results to skip for pagination (e.g., "100"). |

  #### Output [#output-16]

  | Parameter | Type | Description |
  | - | - | - |
  | `trades` | array | Array of trade objects |
  | ↳ `proxyWallet` | string | Proxy wallet address |
  | ↳ `side` | string | Trade side (BUY or SELL) |
  | ↳ `asset` | string | Asset token ID |
  | ↳ `conditionId` | string | Condition ID |
  | ↳ `size` | number | Trade size |
  | ↳ `price` | number | Trade price |
  | ↳ `timestamp` | number | Unix timestamp |
  | ↳ `title` | string | Market title |
  | ↳ `slug` | string | Market slug |
  | ↳ `icon` | string | Market icon URL |
  | ↳ `eventSlug` | string | Event slug |
  | ↳ `outcome` | string | Outcome name |
  | ↳ `outcomeIndex` | number | Outcome index |
  | ↳ `name` | string | Trader name |
  | ↳ `pseudonym` | string | Trader pseudonym |
  | ↳ `bio` | string | Trader bio |
  | ↳ `profileImage` | string | Profile image URL |
  | ↳ `profileImageOptimized` | string | Optimized profile image URL |
  | ↳ `transactionHash` | string | Transaction hash |
</ReferenceDetails>

### Get Activity from Polymarket [#get-activity-from-polymarket]

Retrieve on-chain activity for a user including trades, splits, merges, redemptions, rewards, and conversions

<ReferenceDetails>
  #### Input [#input-17]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `user` | string | Yes | User wallet address (0x-prefixed) |
  | `limit` | string | No | Maximum results to return (e.g., "50"). Default: 100, max: 500. |
  | `offset` | string | No | Number of results to skip for pagination (e.g., "100"). Default: 0, max: 10000. |
  | `market` | string | No | Comma-separated condition IDs (e.g., "0x1234...abcd,0x5678...efgh"). Mutually exclusive with eventId. |
  | `eventId` | string | No | Comma-separated event IDs (e.g., "12345,67890"). Mutually exclusive with market. |
  | `type` | string | No | Activity type filter: TRADE, SPLIT, MERGE, REDEEM, REWARD, CONVERSION, MAKER\_REBATE, REFERRAL\_REWARD |
  | `start` | number | No | Start timestamp (Unix seconds) |
  | `end` | number | No | End timestamp (Unix seconds) |
  | `sortBy` | string | No | Sort field: TIMESTAMP, TOKENS, or CASH (default: TIMESTAMP) |
  | `sortDirection` | string | No | Sort direction: ASC or DESC (default: DESC) |
  | `side` | string | No | Trade side filter: BUY or SELL (only applies to trades) |

  #### Output [#output-17]

  | Parameter | Type | Description |
  | - | - | - |
  | `activity` | array | Array of activity entries |
  | ↳ `proxyWallet` | string | User proxy wallet address |
  | ↳ `timestamp` | number | Unix timestamp of activity |
  | ↳ `conditionId` | string | Market condition ID |
  | ↳ `type` | string | Activity type (TRADE, SPLIT, MERGE, REDEEM, REWARD, CONVERSION) |
  | ↳ `size` | number | Size in tokens |
  | ↳ `usdcSize` | number | Size in USDC |
  | ↳ `transactionHash` | string | Blockchain transaction hash |
  | ↳ `price` | number | Price (for trades) |
  | ↳ `asset` | string | Asset/token ID |
  | ↳ `side` | string | Trade side (BUY/SELL) |
  | ↳ `outcomeIndex` | number | Outcome index |
  | ↳ `title` | string | Market title |
  | ↳ `slug` | string | Market slug |
  | ↳ `icon` | string | Market icon URL |
  | ↳ `eventSlug` | string | Event slug |
  | ↳ `outcome` | string | Outcome name |
  | ↳ `name` | string | User display name |
  | ↳ `pseudonym` | string | User pseudonym |
  | ↳ `bio` | string | User bio |
  | ↳ `profileImage` | string | User profile image URL |
  | ↳ `profileImageOptimized` | string | Optimized profile image URL |
</ReferenceDetails>

### Get Leaderboard from Polymarket [#get-leaderboard-from-polymarket]

Retrieve trader leaderboard rankings by profit/loss or volume

<ReferenceDetails>
  #### Input [#input-18]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `category` | string | No | Category filter: OVERALL, POLITICS, SPORTS, CRYPTO, CULTURE, MENTIONS, WEATHER, ECONOMICS, TECH, FINANCE (default: OVERALL) |
  | `timePeriod` | string | No | Time period: DAY, WEEK, MONTH, ALL (default: DAY) |
  | `orderBy` | string | No | Order by: PNL or VOL (default: PNL) |
  | `limit` | string | No | Number of results to return (e.g., "10"). Range: 1-50, default: 25. |
  | `offset` | string | No | Number of results to skip for pagination (e.g., "25"). Range: 0-1000, default: 0. |
  | `user` | string | No | Filter by specific user wallet address |
  | `userName` | string | No | Filter by username |

  #### Output [#output-18]

  | Parameter | Type | Description |
  | - | - | - |
  | `leaderboard` | array | Array of leaderboard entries |
  | ↳ `rank` | string | Leaderboard rank position |
  | ↳ `proxyWallet` | string | User proxy wallet address |
  | ↳ `userName` | string | User display name |
  | ↳ `vol` | number | Trading volume |
  | ↳ `pnl` | number | Profit and loss |
  | ↳ `profileImage` | string | User profile image URL |
  | ↳ `xUsername` | string | Twitter/X username |
  | ↳ `verifiedBadge` | boolean | Whether user has verified badge |
</ReferenceDetails>

### Get Market Holders from Polymarket [#get-market-holders-from-polymarket]

Retrieve top holders of a specific market token

<ReferenceDetails>
  #### Input [#input-19]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `market` | string | Yes | Comma-separated list of condition IDs (e.g., "0x1234...abcd" or "0x1234...abcd,0x5678...efgh"). |
  | `limit` | string | No | Number of holders to return (e.g., "10"). Range: 0-20, default: 20. |
  | `minBalance` | string | No | Minimum balance threshold (default: 1) |

  #### Output [#output-19]

  | Parameter | Type | Description |
  | - | - | - |
  | `holders` | array | Array of market holder groups by token |
  | ↳ `token` | string | Token/asset ID |
  | ↳ `holders` | array | Array of holders for this token |
  | ↳ `proxyWallet` | string | Holder wallet address |
  | ↳ `bio` | string | Holder bio |
  | ↳ `asset` | string | Asset ID |
  | ↳ `pseudonym` | string | Holder pseudonym |
  | ↳ `amount` | number | Amount held |
  | ↳ `displayUsernamePublic` | boolean | Whether username is publicly displayed |
  | ↳ `outcomeIndex` | number | Outcome index |
  | ↳ `name` | string | Holder display name |
  | ↳ `profileImage` | string | Profile image URL |
  | ↳ `profileImageOptimized` | string | Optimized profile image URL |
  | ↳ `verified` | boolean | Whether the holder is verified |
</ReferenceDetails>