GET /v1/edgar/watch/ipo-watch

$0.02delayed_15mtier: datacache 600sEngine D — Gov Data / EDGAR

Rolling feed of newly filed S-1 IPO registration documents: filer, filing date, accession number, and direct EDGAR links — metadata only, no deep parse. The watch feed for agents tracking S-1 IPO registration activity.

Parameters

NameInTypeRequiredNotes
limitqueryintegerno (default: 20)

Example

curl "https://x402-factory.com/v1/edgar/watch/ipo-watch?limit=10"

Example response

{
  "data": {
    "watch": "ipo-watch",
    "forms": [
      "S-1",
      "S-1/A"
    ],
    "filings": [
      {
        "company": "Cerebras Systems Inc.",
        "form": "S-1",
        "filed_at": "2026-07-15",
        "snippet": "Initial public offering of Class A common stock. We are an AI compute systems company…",
        "url": "https://www.sec.gov/Archives/edgar/data/1867287/000119312526182001/cerebras-s1.htm"
      }
    ]
  },
  "meta": {
    "endpoint": "/v1/edgar/watch/ipo-watch",
    "version": "1.0.0",
    "generated_at": "2026-08-18T22:54:16.755Z",
    "freshness": "delayed_15m",
    "sources": [
      "sec-edgar"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/gov.edgar-watch.ipo-watch",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "watch": {
      "type": "string"
    },
    "forms": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "filings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ticker": {
            "type": "string"
          },
          "company": {
            "type": "string"
          },
          "form": {
            "type": "string"
          },
          "filed_at": {
            "type": "string"
          },
          "snippet": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "company",
          "form",
          "filed_at",
          "snippet",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "watch",
    "forms",
    "filings"
  ],
  "additionalProperties": false
}

The platform wraps every payload in an envelope: { "data": …, "meta": { endpoint, version, generated_at, freshness, sources, request_id, docs, data_mode } }.

Payment (x402)

Unpaid requests receive 402 with payment requirements (accepts). Pay $0.02 in USDC on Base per call via an X-PAYMENT header — see docs.x402.org. With PAYMENT_MODE=disabled (local dev) the endpoint is open.

Errors

StatusCodeMeaning
400INVALID_PARAMSInput failed validation; message lists the offending fields.
404NOT_FOUNDNo matching resource; suggestion may point to a sibling endpoint.
410RESOLVEDMarket/event settled; body includes a resolution summary.
503STALE_DATAUpstream feed down; stale data is never silently served beyond 2× cache TTL.
500INTERNALOur bug. The request_id helps us find it.