> ## Documentation Index > Fetch the complete documentation index at: /docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Quiver Quantitative API: base URL https://api.quiverquant.com, endpoints under /beta/. Authenticate every request with the header `Authorization: Bearer `. Keys are on https://api.quiverquant.com/dashboard/ after subscribing at https://api.quiverquant.com/pricing/. > AI agents can use the Quiver MCP server at https://mcp.quiverquant.com/ (streamable HTTP; OAuth sign-in, or the API key as a Bearer token). Setup: https://api.quiverquant.com/docs/mcp-server. > Each dataset needs a plan (https://api.quiverquant.com/docs/plans-and-access) and each endpoint has a per-account rate limit (https://api.quiverquant.com/docs/rate-limits). # Polymarket Top Trades > Returns Polymarket trades flagged as large or unusual bets. Sports-market trades are excluded by default. **Plan:** included in every plan, from Hobbyist up. See [Plans and data access](/docs/plans-and-access.md). ## OpenAPI ````yaml /openapi.json get /beta/live/polymarkettrades openapi: 3.0.3 info: title: Quiver API version: v1 description: Tap into the power of alternative data contact: name: 'Us: info@quiverquant.com' email: info@quiverquant.com license: name: Terms of Service url: https://www.quiverquant.com/termsofservice/ servers: - url: https://api.quiverquant.com security: [] tags: - name: Congress description: Stock trades, holdings and profiles of members of Congress. - name: Trump trades description: Stock trades by Donald Trump. - name: Insiders and institutions description: Insider trades, 13F holdings, shareholders and executive pay. - name: Government contracts description: Federal contracts awarded to public companies. - name: Lobbying and donations description: Corporate lobbying, revolving door lobbyists and PAC donations. - name: Market data description: Daily prices, off-exchange trading and Polymarket trades. - name: Patents description: Patents granted to public companies, and patent-based signals. - name: Company data description: Layoff notices, app ratings and the Quiver newsfeed. - name: New Constructs description: New Constructs ratings, a separate subscription. paths: /beta/live/polymarkettrades: get: tags: - Market data summary: Polymarket Top Trades description: >- Returns Polymarket trades flagged as large or unusual bets. Sports-market trades are excluded by default. operationId: live_polymarkettrades_retrieve parameters: - in: query name: date schema: type: string format: date description: Date, formatted as YYYYMMDD - in: query name: include_sports_markets schema: type: boolean description: >- Include trades on sports markets in the results (excluded by default) - in: query name: page schema: type: integer description: Page number - in: query name: page_size schema: type: integer description: Items / page - in: query name: proxy_wallet schema: type: string description: Filter to trades from this trader's wallet address - in: query name: slug schema: type: string description: Filter to trades on the Polymarket market with this slug - in: query name: sort_by schema: type: string description: 'Sort results by: trade_time or estimated_amount' - in: query name: sort_order schema: type: string description: 'Sort direction: asc or desc' responses: '200': content: application/json: schema: $ref: '#/components/schemas/PolymarketTopTradesResponse' description: '' security: - WebPlatformTokenAuth: [] components: schemas: PolymarketTopTradesResponse: title: PolymarketTopTradesResponse description: >- JSON Response structure for the Polymarket large/unusual trades endpoint. type: array items: $ref: '#/components/schemas/PolymarketTrade' PolymarketTrade: title: PolymarketTrade description: A trade on Polymarket flagged as a large or unusual bet. type: object properties: proxy_wallet: title: Proxy Wallet description: Wallet address that placed the trade type: string side: title: Side description: BUY or SELL type: string asset: title: Asset description: Polymarket asset (outcome token) id type: string condition_id: title: Condition Id description: Polymarket market condition id type: string size: title: Size description: Number of shares traded type: number price: title: Price description: Price per share at execution type: number title: title: Title description: Market title type: string slug: title: Slug description: Market slug type: string event_slug: title: Event Slug description: Event slug the market belongs to type: string outcome: title: Outcome description: Outcome name traded type: string outcome_index: title: Outcome Index description: Index of the outcome traded type: integer name: title: Name description: Trader's display name type: string transaction_hash: title: Transaction Hash description: On-chain transaction hash type: string estimated_amount: title: Estimated Amount description: Estimated USD value of the trade type: number trade_time: title: Trade Time description: Trade execution time type: string format: date-time uploaded: title: Uploaded description: Time the trade was uploaded by Quiver type: string format: date-time user_first_activity: title: User First Activity description: Time of the trader's first recorded activity type: string format: date-time user_position_rank: title: User Position Rank description: Trader's rank by current position value type: integer user_position_current_val: title: User Position Current Val description: Trader's current position value (USD) type: number user_positions_value: title: User Positions Value description: Total value (USD) of all of the trader's positions type: number user_markets_traded: title: User Markets Traded description: Number of distinct markets the trader has traded type: integer sports_market_type: title: Sports Market Type description: >- Sports bet type (e.g. moneyline, spreads, totals); null for non-sports markets type: string slug_volume: title: Slug Volume description: Total traded volume (USD) for the market type: number required: - proxy_wallet - side - asset - condition_id - size - price - title - slug - event_slug - outcome - outcome_index - transaction_hash - estimated_amount - trade_time - uploaded securitySchemes: WebPlatformTokenAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.