> ## 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.

# IPO calendar

> Get Initial Public Offerings (IPO) scheduled on the specified date. Both historical or upcoming IPOs can be retrieved.

IPOs (Initial Public Offerings) are how private companies first sell shares to the public and get listed on stock exchanges.
A company wanting to go public typically hires investment banks as underwriters. These banks help determine the company's value, prepare regulatory filings (like the S-1 with the SEC), and market the shares to institutional investors.

The banks define a range of prices to accept bids from potential investors. This allows underwriters to gauge investor demand. If there's strong interest, they can price at the high end or even above the range. Weak demand might push pricing to the low end or cause a delay.

The actual IPO price is set the evening before public trading begins, based on the order book from institutional investors. This "book building" process shows real demand at different price levels, allowing underwriters to optimize both the price and allocation of shares.
The goal is to price the IPO so it trades positively on the first day (showing investor confidence) but doesn't leave too much money on the table for the company.


## OpenAPI

````yaml reference/calendar/calendar.yaml GET /calendar/ipo
openapi: 3.1.0
info:
  title: Get financial calendar
  description: >-
    Get financial calendar data, including earnings, corporate actions,
    dividends and other events
  version: 1.0.0
servers:
  - url: https://openapi.ainvest.com/open
    description: Production environment
security:
  - bearerAuth: []
tags:
  - name: Calendar
    description: Financial calendar events
    externalDocs:
      url: https://docs.ainvest.com/calendar
paths:
  /calendar/ipo:
    get:
      tags:
        - Calendar
      summary: Get IPO calendar
      description: >-
        Get Initial Public Offerings (IPO) scheduled on the specified date. Both
        historical or upcoming IPOs can be retrieved.
      operationId: getIPOCalendar
      parameters:
        - name: date
          in: query
          required: true
          description: The date for which to get IPOs, format YYYY-MM-DD
          schema:
            type: string
      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 securities scheduled to go public on the
                          specified date
                        items:
                          type: object
                          properties:
                            ticker:
                              type: string
                              description: >-
                                US stock market ticker symbol, e.g. AAPL, TSLA,
                                etc.
                            exchange:
                              type: string
                              description: >-
                                The stock exchange where the security is being
                                listed, e.g. NYSE, NASDAQ, etc.
                            floor_price:
                              type: number
                              description: The lower end of the price range for the IPO
                            ceiling_price:
                              type: number
                              description: The upper end of the price range for the IPO
                  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. date is not specified or invalid format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status_code: 4012
                status_msg: Invalid param
components:
  schemas:
    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/)

````