Alpaca IPO API

openapi: 3.2.0
info:
  contact:
    email: support@alpaca.markets
    name: Alpaca Support
    url: https://alpaca.markets/support
  description: Open brokerage accounts, enable stock, options and crypto trading. Manage the ongoing user experience and brokerage customer lifecycle with the Alpaca Broker API
  termsOfService: https://s3.amazonaws.com/files.alpaca.markets/disclosures/library/TermsAndConditions.pdf
  title: Broker IPO API
  version: 1.1.1
servers:
- description: Sandbox endpoint
  url: https://broker-api.sandbox.alpaca.markets
- description: Production endpoint
  url: https://broker-api.alpaca.markets
security:
- BasicAuth: []
tags:
- description: Endpoints for discovering and tracking IPO (Initial Public Offering) lifecycle data. Use `GET /v1/ipos` and `GET /v1/ipos/{offering_reference}` to query offerings on demand, and the IPO Events Stream under the **Events** group to receive real-time and historical lifecycle updates (new offerings, prospectus, 60-minute mail, allocations, cancellations).
  name: IPO
paths:
  /v1/ipos:
    get:
      description: 'Returns a paginated list of IPO offerings currently known to Alpaca.


        Use this endpoint to power IPO discovery surfaces (e.g. an "Upcoming IPOs" list). Real-time lifecycle changes (availability, prospectus, 60-minute mail, allocations, cancellations) are pushed over the IPO Events Stream.'
      operationId: listIPOOfferings
      parameters:
      - description: 'Filter by offering availability.

          - `available` - accepting new orders.

          - `not_available` - not yet open for orders.

          - `closed` - no longer accepting orders.

          '
        in: query
        name: availability
        schema:
          enum:
          - available
          - not_available
          - closed
          type: string
      - description: Filter by ticker symbol (case-insensitive exact match).
        example: EXMP
        in: query
        name: ticker
        schema:
          type: string
      - description: Maximum number of offerings to return per page. Capped at `200`.
        in: query
        name: limit
        schema:
          default: 50
          maximum: 200
          minimum: 1
          type: integer
      - description: Opaque cursor returned in the previous response's `next_page_token` field. Pass it back to fetch the next page.
        in: query
        name: page_token
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                default:
                  $ref: '#/components/examples/IPOOfferingListExample'
              schema:
                $ref: '#/components/schemas/IPOOfferingListResponse'
          description: A page of IPO offerings.
      summary: List IPO Offerings
      tags:
      - IPO
  /v1/ipos/{offering_reference}:
    parameters:
    - description: The unique offering identifier (also referred to as `ipo_reference` in the response body).
      example: FI111225
      in: path
      name: offering_reference
      required: true
      schema:
        type: string
    get:
      description: 'Returns a single IPO offering by `offering_reference`.


        The `offering_reference` value matches the one delivered on the IPO Events Stream.'
      operationId: getIPOOffering
      responses:
        '200':
          content:
            application/json:
              examples:
                default:
                  $ref: '#/components/examples/IPOOfferingGetExample'
              schema:
                $ref: '#/components/schemas/IPOOfferingResponse'
          description: The requested IPO offering.
        '404':
          description: No IPO offering exists for the given `offering_reference`.
      summary: Retrieve an IPO Offering
      tags:
      - IPO
components:
  schemas:
    IPOOffering:
      description: 'An IPO (Initial Public Offering) offering exposed via the IPO discovery REST API. Returned by `GET /v1/ipos` and `GET /v1/ipos/{offering_reference}`.


        Most IPO lifecycle changes (new offerings, prospectus availability, 60-minute mail, allocations, cancellations) are pushed in real time over the [IPO Events Stream](#operation/subscribeToIPOEventsSSE).

        '
      properties:
        anticipated_shares:
          description: Anticipated total share count for the offering, when known.
          format: int64
          type: integer
        availability:
          description: 'Whether the offering is currently accepting orders.

            - `available` - accepting new orders.

            - `not_available` - not yet open for orders.

            - `closed` - no longer accepting orders.


            Note: the IPO Events Stream uses a different casing for the analogous `payload.available_to_order` field on `Offering`/`OfferingUpdate` events (`Available`, `NotAvailable`, `Closed`).

            '
          enum:
          - available
          - not_available
          - closed
          example: available
          type: string
        cusip_id:
          description: CUSIP identifier of the offering.
          example: '123456789'
          type: string
        description:
          description: A longer human-readable description of the offering, when available.
          type: string
        ipo_reference:
          description: 'The unique offering identifier used across the IPO Events Stream and `/v1/ipos/{offering_reference}`. Note that this value is also used as the path parameter, where it is named `offering_reference`.

            '
          example: FI111225
          type: string
        logo_small:
          description: URL to a small logo asset for the issuer.
          type: string
        max_price:
          description: Upper bound of the indicated price range.
          example: '42'
          format: decimal
          type: string
        max_ticket_size:
          description: Maximum allowed order amount.
          type: string
        min_price:
          description: Lower bound of the indicated price range.
          example: '42'
          format: decimal
          type: string
        min_ticket_size:
          description: Minimum allowed order amount.
          type: string
        name:
          description: The official name of the offering.
          example: Example Corp
          type: string
        no_new_orders:
          description: 'When `true`, the offering is in its 60-minute pricing window and is not accepting new orders. This mirrors the `SixtyMinMail` event on the IPO Events Stream.

            '
          example: false
          type: boolean
        offering_type:
          description: The type of offering. Currently always `IPO`.
          example: IPO
          type: string
        prospectus_url:
          description: 'URL to the prospectus document. Mirrors the `prospectus_url` payload of the corresponding `Prospectus` event on the IPO Events Stream.

            '
          type: string
        settlement_date:
          description: Anticipated settlement date.
          format: date
          type: string
        ticker_symbol:
          description: The ticker symbol that will be used once the security begins trading on the secondary market.
          example: EXMP
          type: string
        trade_date:
          description: Anticipated first trading date on the secondary market.
          format: date
          type: string
        underwriters:
          description: List of underwriter names participating in the offering.
          items:
            type: string
          type: array
        unit_step_size:
          description: The minimum increment in which order quantities can be specified.
          type: string
      required:
      - name
      - ipo_reference
      - offering_type
      - availability
      - max_price
      - min_price
      - no_new_orders
      title: IPOOffering
      type: object
    IPOOfferingResponse:
      description: Wrapper response returned by `GET /v1/ipos/{offering_reference}`.
      properties:
        data:
          $ref: '#/components/schemas/IPOOffering'
      required:
      - data
      title: IPOOfferingResponse
      type: object
    IPOOfferingListResponse:
      description: Wrapper response returned by `GET /v1/ipos`.
      properties:
        data:
          description: The page of IPO offerings matching the query.
          items:
            $ref: '#/components/schemas/IPOOffering'
          type: array
        next_page_token:
          description: 'Opaque cursor for the next page of results. When `null`, there are no further pages. Pass this value back as the `page_token` query parameter to fetch the next page.

            '
          type:
          - string
          - 'null'
      required:
      - data
      - next_page_token
      title: IPOOfferingListResponse
      type: object
  examples:
    IPOOfferingGetExample:
      summary: Single IPO offering
      value:
        data:
          anticipated_shares: 5000000
          availability: available
          cusip_id: '123456789'
          description: Example Corp is a leading provider of example services.
          ipo_reference: FI111225
          logo_small: https://example.com/logos/exmp-small.png
          max_price: '44'
          max_ticket_size: '100000'
          min_price: '40'
          min_ticket_size: '100'
          name: Example Corp
          no_new_orders: false
          offering_type: IPO
          prospectus_url: https://example.com/prospectus/example-corp.pdf
          settlement_date: '2026-04-04'
          ticker_symbol: EXMP
          trade_date: '2026-04-02'
          underwriters:
          - Goldman Sachs
          - Morgan Stanley
          unit_step_size: '1'
    IPOOfferingListExample:
      summary: Page of available IPO offerings
      value:
        data:
        - anticipated_shares: 5000000
          availability: available
          cusip_id: '123456789'
          description: Example Corp is a leading provider of example services.
          ipo_reference: FI111225
          logo_small: https://example.com/logos/exmp-small.png
          max_price: '44'
          max_ticket_size: '100000'
          min_price: '40'
          min_ticket_size: '100'
          name: Example Corp
          no_new_orders: false
          offering_type: IPO
          prospectus_url: https://example.com/prospectus/example-corp.pdf
          settlement_date: '2026-04-04'
          ticker_symbol: EXMP
          trade_date: '2026-04-02'
          underwriters:
          - Goldman Sachs
          - Morgan Stanley
          unit_step_size: '1'
        next_page_token: null
  securitySchemes:
    BasicAuth:
      scheme: basic
      type: http
x-readme:
  explorer-enabled: true
  proxy-enabled: false