getIpoCalendar
Returns a list of IPO records matching the supplied filters. With no parameters, returns IPOs with listing dates between today and 30 days from now. All parameters are optional; combine them to narrow results by ticker, CIK, date range, status, deal type, exchange, or industry.
This record as markdown: /tools/com-api-ninjas-mcp/getipocalendar.md
What getIpoCalendar does on API Ninjas
AI agents call getIpoCalendar to retrieve information from API Ninjas without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
cik | string | — | SEC Central Index Key, numeric only (padded or unpadded; e.g., 0001713445 or 1713445). |
date | string | — | Single date in YYYY-MM-DD format. Cannot be combined with date_start or date_end. |
limit | integer | — | Maximum number of results to return. Must be between 1 and 1000 (inclusive). Default is 50. |
offset | integer | — | Number of results to skip for pagination. Must be a non-negative integer. |
status | string | — | Comma-separated list of statuses to filter by. Values: filed, amended, priced, listed, withdrawn. |
ticker | string | — | Company ticker symbol (e.g., RDDT). Returns IPO records for that specific company. |
date_end | string | — | Range end in YYYY-MM-DD format. Defaults to today + 30 days. |
exchange | string | — | U.S. exchange code. |
sic_code | string | — | SEC Standard Industrial Classification code (up to 4 digits). |
deal_type | string | — | Comma-separated list of deal types to filter by. Values: ipo, spac_ipo, direct_listing. |
date_field | string | — | Which date the range filter applies to. |
date_start | string | — | Range start in YYYY-MM-DD format. Defaults to today. Free-tier users cannot query earlier than 24 months ago. |
Parameters from the server's own tool schema.
Why getIpoCalendar is rated Low
Even though getIpoCalendar only reads data, uncontrolled read access leaks sensitive information and racks up API costs: an agent caught in a retry loop can make thousands of calls a minute without anyone noticing.
Risk signalsHigh parameter count (12 properties)
Attacks that exploit this kind of access
The rule that runs getIpoCalendar safely
PolicyLayer is an MCP gateway: it sits between your AI agents and API Ninjas, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For getIpoCalendar, this is the rule to start with:
getIpoCalendar is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect API Ninjas, apply this rule, and every getIpoCalendar call is checked against it from then on.
Questions about getIpoCalendar
Returns a list of IPO records matching the supplied filters. With no parameters, returns IPOs with listing dates between today and 30 days from now. All parameters are optional; combine them to narrow results by ticker, CIK, date range, status, deal type, exchange, or industry. It is categorised as a Read tool in the API Ninjas MCP Server, which means it retrieves data without modifying state.
getIpoCalendar accepts 12 parameters: cik, date, limit, offset, status, ticker, date_end, exchange, sic_code, deal_type, date_field, date_start. The full parameter table on this page comes from the server's own tool schema.
Register the API Ninjas MCP server in PolicyLayer and add a rule for getIpoCalendar: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches API Ninjas. Nothing to install.
getIpoCalendar is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the getIpoCalendar rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for getIpoCalendar. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
getIpoCalendar is provided by the API Ninjas MCP server (https://mcp.api-ninjas.com/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on API Ninjas, and thousands of servers like it.
This server
Across the catalogue