# x402stock IPO Calendar & History

> x402stock IPO Calendar & History is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status healthy (last checked 2026-09-14, last successful call 2026-09-02).

Returns upcoming, recent, and historical US IPO data including issuer, ticker, pricing, deal size, exchange, and status, filterable by status, ticker, and result count.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/ipos
- Price: $0.02/call
- Payment: x402
- Status: healthy
- Last checked: 2026-09-14
- Last successful call: 2026-09-02
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-xyz-8138a306
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HyO4d7yBRAmBJ517DwGi9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402stock-xyz-8138a306
```

Example prompt: Show me the 30 most recent US IPOs that have already priced — I want to see the issuer name, ticker, final offer price, deal size, and which exchange they listed on.

## When to prefer this

Use this endpoint when you need structured US IPO data — upcoming deal calendar, recently priced offerings, or historical IPO records — especially when you need price range, final offer price, deal size, and exchange details in one call. Prefer over general financial APIs when you specifically need new-issue calendar data with USDC pay-per-call pricing and no API key requirement.

## Known failure modes

- Invalid ipo_status enum value returns 400 or empty results
- Unknown ticker returns an empty ipos array
- Limit exceeding 250 returns an error
- Payment not completed (402) blocks response
- Stale data if IPO calendar has not been refreshed recently

## How this service works

Upcoming and historical US IPOs: issuer name, ticker, announced and listing dates, offer price range and final price, shares offered, total deal size, exchange, and status. Filter by `?ipo_status=pending|new|history|rumor`, `?ticker=`, and `?limit=`. Use to track the new-issue calendar and recently priced deals. From x402stock, a market & economic data API (x402, USDC).

## Output

A JSON object with a source label, as-of timestamp, result count, and an array of IPO records each containing: ticker, issuer name, status, announced date, listing date, primary exchange, security type, security description, currency, ISIN, final issue price, lowest and highest offer price, max shares offered, total offer size, shares outstanding, and last updated timestamp.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 20,
   "ipo_status": "new"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "limit"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 250,
       "exclusiveMinimum": 0
      },
      "ticker": {
       "type": "string",
       "maxLength": 10,
       "minLength": 1
      },
      "ipo_status": {
       "enum": [
        "pending",
        "new",
        "history",
        "rumor",
        "postponed",
        "withdrawn"
       ],
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "count",
      "ipos"
     ],
     "properties": {
      "ipos": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "ticker",
         "issuer_name",
         "status",
         "announced_date",
         "listing_date",
         "primary_exchange",
         "security_type",
         "security_description",
         "currency",
         "isin",
         "final_issue_price",
         "lowest_offer_price",
         "highest_offer_price",
         "max_shares_offered",
         "total_offer_size",
         "shares_outstanding",
         "last_updated"
        ],
        "properties": {
         "isin": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ]
         },
         "status": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ]
         },
         "ticker": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ipos": [
   {
    "isin": "US75734B1008",
    "status": "history",
    "ticker": "RDDT",
    "currency": "USD",
    "issuer_name": "Reddit Inc.",
    "last_updated": "2024-12-02",
    "listing_date": "2024-03-21",
    "security_type": "CS",
    "announced_date": "2024-02-22",
    "primary_exchange": "XNYS",
    "total_offer_size": 519401918,
    "final_issue_price": 34,
    "lowest_offer_price": 31,
    "max_shares_offered": 22000000,
    "shares_outstanding": 36871367,
    "highest_offer_price": 34,
    "security_description": "Ordinary Shares - Class A"
   }
  ],
  "as_of": "2026-05-30T07:00:00.000Z",
  "count": 1,
  "source": "x402stock"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-xyz-8138a306/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)