> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ainvest.com/llms.txt
> Use this file to discover all available pages before exploring further.

# US Congress trades

> Get trades by US politicians, including date, type of trade, approximate dollar value

Since 2012, the Stop Trading on Congressional Knowledge (STOCK) Act requires certain federal officials, including members of Congress,
to publicly disclose their financial transactions over \$1000 in those involving stocks, bonds, and some commodities.
This is done through the Periodic Transaction Report (OGE Form 278-T), which must be filed within 30 days of notification of the transaction, but no later than 45 days after the transaction.

Political figures on Capitol Hill often have access to information that could influence market movements before it becomes public. By following their trades through this API, you can:

* Monitor when senators purchase stocks in sectors before favorable legislation
* Identify House of Representatives members' trading patterns around regulatory announcements
* Analyze timing between committee hearings and politician stock transactions
* Identify politicians with consistently late filings (beyond the 45-day requirement)


## OpenAPI

````yaml reference/ownership/ownership.yaml GET /ownership/congress
openapi: 3.1.0
info:
  title: Insiders, politicians and istitutional ownership
  description: >-
    Get trades and ownership of US stocks by insiders, politicians and
    institutional investors
  version: 1.0.0
servers:
  - url: https://openapi.ainvest.com/open
    description: Production environment
security:
  - bearerAuth: []
tags:
  - name: Ownership
    description: >-
      Provides publicly available information about trades and ownership of US
      stocks by insiders, politicians and institutional investors
    externalDocs:
      url: https://docs.ainvest.com/ownership/insider
paths:
  /ownership/congress:
    get:
      tags:
        - Ownership
      summary: Get trades by US politicians
      description: >-
        Get trades by US politicians, including date, type of trade, approximate
        dollar value
      operationId: getCongressTrades
      parameters:
        - name: ticker
          in: query
          required: true
          description: US stock market ticker symbol, e.g. AAPL, TSLA, etc.
          schema:
            type: string
        - name: page
          in: query
          required: false
          description: Page number for pagination, default is 1
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: size
          in: query
          required: false
          description: Number of items per page, default is 10
          schema:
            type: integer
            minimum: 1
            default: 10
      responses:
        '200':
          description: Successful response in standard envelope.
          content:
            application/json:
              schema:
                $schema: http://json-schema.org/draft-04/schema#
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      data:
                        type: array
                        description: A list of trades, ordered newest first
                        items:
                          $ref: '#/components/schemas/CongressTrade'
                  status_code:
                    type: number
                    description: Status code, `0` for success
                  status_msg:
                    type: string
                    description: Status message, `success` for success
        '400':
          description: >-
            Validation error, i.e. requested stock is not found or parameter is
            not specified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status_code: 4012
                status_msg: Invalid param
components:
  schemas:
    CongressTrade:
      type: object
      properties:
        name:
          type: string
          description: Name of the person who made the trade
        party:
          type: string
          description: >-
            Political party of the person who made the trade, e.g. "Democrat",
            "Republican"
        state:
          type: string
          description: The US state, e.g. "CA", "NY", etc.
        trade_date:
          type: string
          description: The date of the trade, YYYY-MM-DD format
        filing_date:
          type: string
          description: The date when the trade was filed, YYYY-MM-DD format
        reporting_gap:
          type: string
          description: >-
            Human readable string indicating the difference between trade date
            and filing date, for example "13 Days"
        trade_type:
          type: string
          description: The side of the trade, `buy` or `sell`
        size:
          type: string
          description: Approximate dollar value of the trade, for example, $100K-$250K
    Error:
      type: object
      properties:
        status_code:
          type: integer
          description: Business status code
        status_msg:
          type: string
          description: Error message
      required:
        - status_code
        - status_msg
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer authentication header of the form `Bearer <token>`, where
        `<token>` is your key. [Get the key
        here](https://www.ainvest.com/business/developer-manage/)

````