Stocks · Reference and fundamentals
Stocks IPOs
Initial public offerings and direct listings, newest first.
GET
/v1/stocks/iposstocksIposUpcoming and historical IPOs with issuer, status, listing and announcement dates, offer price range, final price, shares offered and the listing exchange. Status runs from rumor and pending through new (listing day) to history.
Example request
curl -sS --get "https://api.ordermap.si/v1/stocks/ipos" \
-H "Authorization: Bearer $ORDERMAP_API_KEY" \
--data-urlencode symbol=AAPLconst params = new URLSearchParams({
symbol: "AAPL",
});
const res = await fetch(`https://api.ordermap.si/v1/stocks/ipos?${params}`, {
headers: { Authorization: `Bearer ${process.env.ORDERMAP_API_KEY}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data, meta } = await res.json();
console.log(data, meta.coverage);
// Paginated: repeat with cursor_id set to pagination.next_cursor_id until it is null.Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.
Parameters
6 parameters, none required.
| Parameter | Type and limits | Description |
|---|---|---|
statusqueryoptional | stringdirect_listing_processhistorynewpendingpostponedrumorwithdrawn | Only IPOs in this status. |
symbolqueryoptional | stringat most 11 characterspattern ^[A-Za-z]{1,6}(\.[A-Za-z0-9]{1,4})?$ | Only this ticker symbol. |
start_queryoptional | stringdate | Inclusive earliest listing date, YYYY-MM-DD. |
end_queryoptional | stringdate | Inclusive latest listing date, YYYY-MM-DD. |
limitqueryoptional | integerdefault 100min 1max 999 | Maximum rows to return. |
cursor_queryoptional | stringat most 1024 characters | Opaque cursor returned as pagination.next_cursor_id; resumes the same query on the next page. |
Response
| Status | Meaning | Body |
|---|---|---|
200 | Successful response. | Schema below |
400 | Invalid, unknown or repeated parameters, or an invalid cursor. | Error object |
401 | Missing or invalid API key. | Error object |
403 | The plan, dataset release or account state does not allow this request. | Error object |
422 | The request is valid but no data exists for it. | Error object |
429 | Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-After | Error object |
500 | Internal error. | Error object |
503 | Data temporarily unavailable; retry after Retry-After seconds.Retry-After | Error object |
504 | The request timed out. | Error object |
Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.
200 response body
dataarray<object>required20 fields insideannounced_datestring | nulldaterequiredDate the IPO was announced.currencystring | nullrequiredCurrency, ISO 4217.final_issue_pricenumber | nullrequiredFinal offer price.highest_offer_pricenumber | nullrequiredHigh end of the offer range.isinstring | nullrequiredISIN.issuer_namestringrequiredIssuer name.last_updatedstring | nulldaterequiredDate the record last changed.listing_datestring | nulldaterequiredFirst trading date.lot_sizenumber | nullrequiredMinimum trade lot.lowest_offer_pricenumber | nullrequiredLow end of the offer range.max_shares_offerednumber | nullrequiredUpper share count offered.min_shares_offerednumber | nullrequiredLower share count offered.primary_exchangestring | nullrequiredMarket identifier code of the listing exchange.security_descriptionstring | nullrequiredDescription of the security.security_typestring | nullrequiredSecurity type, for example CS.shares_outstandingnumber | nullrequiredShares outstanding after the offering.statusstringrequiredIPO status.symbolstringrequiredTicker symbol.total_offer_sizenumber | nullrequiredTotal raised in dollars.us_codestring | nullrequiredNine-character US security code.
metaobjectrequiredMeta objectpaginationobjectrequiredPagination object
Example response
{
"data": [
{
"announced_date": "2026-10-01",
"currency": "USD",
"final_issue_price": null,
"highest_offer_price": 16,
"isin": null,
"issuer_name": "New Company, Inc.",
"last_updated": "2026-10-14",
"listing_date": "2026-11-05",
"lot_size": 100,
"lowest_offer_price": 14,
"max_shares_offered": 9000000,
"min_shares_offered": 8000000,
"primary_exchange": "XNAS",
"security_description": "Class A Common Stock",
"security_type": "CS",
"shares_outstanding": 52000000,
"status": "pending",
"symbol": "NEWC",
"total_offer_size": 135000000,
"us_code": null
}
],
"meta": {
"as_of": 1760659200123,
"coverage": {
"complete": true
},
"delay_ms": 0,
"delayed": false,
"request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
"source": "sip"
},
"pagination": {
"count": 1,
"has_more": false,
"limit": 100,
"next_cursor_id": null,
"next_url": null
}
}Values are illustrative. Missing values are null, never 0.