> ## 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 <API key>`. 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).

# Live Top Shareholders

> Returns the top shareholders for a specific ticker, including both direct and derivative holdings.

**Plan:** Trader or above. A Hobbyist plan gets a `403` from this endpoint. See [Plans and data access](/docs/plans-and-access.md).


## OpenAPI

````yaml /openapi.json get /beta/live/topshareholders/{ticker}
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/topshareholders/{ticker}:
    get:
      tags:
        - Insiders and institutions
      summary: Live Top Shareholders
      description: >-
        Returns the top shareholders for a specific ticker, including both
        direct and derivative holdings.
      operationId: live_topshareholders_retrieve
      parameters:
        - in: path
          name: ticker
          schema:
            type: string
          description: Ticker for any given stock
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiveTopShareholdersResponse'
          description: ''
      security:
        - WebPlatformTokenAuth: []
components:
  schemas:
    LiveTopShareholdersResponse:
      title: LiveTopShareholdersResponse
      description: JSON Response structure for live top shareholders endpoint.
      type: object
      properties:
        ownership:
          title: Ownership
          type: array
          items:
            $ref: '#/components/schemas/TopShareholdersEntry'
        ownership_options:
          title: Ownership Options
          type: array
          items:
            $ref: '#/components/schemas/TopShareholdersOptionEntry'
    TopShareholdersEntry:
      title: TopShareholdersEntry
      description: Top shareholders entry.
      type: object
      properties:
        owner_name:
          title: Owner Name
          type: string
        owner_title:
          title: Owner Title
          type: string
        shares:
          title: Shares
          type: integer
    TopShareholdersOptionEntry:
      title: TopShareholdersOptionEntry
      description: Top shareholders option entry.
      type: object
      properties:
        owner_name:
          title: Owner Name
          type: string
        owner_title:
          title: Owner Title
          type: string
        option_type:
          title: Option Type
          type: string
        underlying_shares:
          title: Underlying Shares
          type: integer
  securitySchemes:
    WebPlatformTokenAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.