For AI agents: complete Markdown index · compact index. Follow the explicit .md links for the Markdown version of each page.

IPO

Hot IPOs

GET/v2/ipo/hot

Returns the curated list of hot IPO offerings, each with an offering summary and a headline financials snapshot (latest full-year period). Ordered by implied valuation descending, then public filing date descending. Filter by symbol, status, or a from/to public-filing date range. Supports offset and cursor pagination.

Included in: Growth.

Authentication

Send your API key in the x-api-key header on every request to https://api.bavest.co. The samples read it from the BAVEST_API_KEY environment variable. Get an API key (free trial) · Authentication guide.

Parameters

  • stringquery · no

    Optional IPO ticker filter (e.g., SPCX). Omit for all offerings.

  • stringquery · no

    Filter by offering status (e.g. Expected, Priced, Listed). Example when explicitly filtering: Expected.

  • string (date)query · no

    Start date (YYYY-MM-DD)

  • string (date)query · no

    End date (YYYY-MM-DD)

  • integer (int32)query · no

    Maximum number of results to return (default 100, max 1000)

    Default 100

  • integer (int32)query · no

    Number of results to skip for pagination (default 0)

    Default 0

  • stringquery · no

    Opaque cursor for cursor-based pagination. When provided, returns results after the cursor position. Takes precedence over offset.

Response 200

Successful response · application/json

  • data
    array of HotIPORecord
    17 fields in data
    • symbol
      string
      required

      Planned ticker symbol

      Example: SPCX

    • name
      string | null

      Company name

      Example: Space Exploration Technologies Corp.

    • exchange
      integer | null

      Target exchange identifier for the listing

    • regulator
      string | null

      Filing regulator (e.g. SEC)

      Example: SEC

    • filingType
      string | null

      Filing type (e.g. S-1)

      Example: S-1

    • status
      string | null

      Offering status (e.g. Expected, Priced, Listed)

      Example: Expected

    • priceType
      string | null

      Pricing mechanism (e.g. fixed, range)

      Example: fixed

    • priceLow
      number (double) | null

      Lower bound of the expected price range

      Example: 135

    • priceHigh
      number (double) | null

      Upper bound of the expected price range

      Example: 135

    • currency
      string | null

      Offering currency (ISO 4217)

      Example: USD

    • numberOfShares
      integer | null

      Number of shares offered

      Example: 556600000

    • grossProceeds
      number (double) | null

      Expected gross proceeds

      Example: 75141000000

    • impliedValuation
      number (double) | null

      Implied post-offering valuation

      Example: 1750000000000

    • confidentialFilingDate
      string (date) | null

      Confidential filing date

      Example: 2026-04-01

    • publicFilingDate
      string (date) | null

      Public filing date

      Example: 2026-05-20

    • expectedListingDate
      string (date) | null

      Expected listing date, resolved from the listing milestone

      Example: 2026-06-12

    • financialsSnapshot
      IPOFinancialsSnapshot | null

      Headline financials snapshot, or null when no financials exist

      5 fields in financialsSnapshot
      • period
        string | null

        Reporting period label (e.g. FY2025)

        Example: FY2025

      • revenue
        number (double) | null

        Total revenue for the period

        Example: 18674

      • ebitdaAdjusted
        number (double) | null

        Adjusted EBITDA for the period

        Example: 6584

      • netIncome
        number (double) | null

        Net income for the period

        Example: -4940

      • revenueYoY
        number (double) | null

        Year-over-year revenue growth (fraction, e.g. 0.3324 = 33.24%)

        Example: 0.3324

  • meta
    ResponseMeta

    Response metadata for paginated endpoints. Offset pagination returns page/pageSize/totalPages/totalCount; cursor pagination returns pageSize/hasMore/nextCursor and totalCount only when known.

    8 fields in meta
    • time
      integer

      Server-side processing time in milliseconds

      Example: 17

    • parameters
      object

      Echo of the request parameters the endpoint resolved

    • page
      integer

      Current page number (offset pagination)

      Example: 1

    • pageSize
      integer

      Number of results per page

      Example: 50

    • totalPages
      integer

      Total number of pages (offset pagination)

      Example: 2

    • totalCount
      integer

      Total number of results across all pages

      Example: 100

    • hasMore
      boolean

      Whether more results follow (cursor pagination)

    • nextCursor
      string | null

      Cursor for the next page (cursor pagination), null on the last page

Errors

  • 400 Invalid request parameters. Returned when required query parameters are missing, have invalid types, or violate constraints (e.g., providing both symbol and isin when they are mutually exclusive).
  • 401 Missing or invalid API key.
  • 404 Resource not found.
  • 429 Rate limit exceeded. Retry after the `Retry-After` header interval.
  • 500 An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.
  • 502 Upstream data provider returned an error or is temporarily unavailable. Retry after a short delay.
  • 504 The request timed out waiting for a response from the upstream data provider. This may occur for complex queries or during peak load.
  • default An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.
  • 403 from the gateway: the API key is invalid or switched off.

  • 429 with message Limit Exceeded: the monthly quota of the key is used up. With Too Many Requests: the key is throttled, or this route is not in the key's plan. Wait for Retry-After when it is sent.

For AI agents: this page as Markdown at /docs/v2_ipo_hot.md, every route in /llms.txt, the OpenAPI spec at /openapi.json.