Agent-first surface

Reliable IPO data,
without scraping HTML.

Every response carries source provenance, observation time, retrieval time, and an explicit freshness state. Missing or unverified values remain null.

OpenAPI schema Read llms.txt

API contract

Endpoints

GET/api/v1/ipos

List IPOs with status and market filters.

GET/api/v1/ipos/{slug}

Read one normalized IPO record.

GET/api/v1/meta/freshness

Check ingestion health and dataset age.

GET/openapi.json

OpenAPI 3.1 schema for tool generation.

GET/llms.txt

Compact discovery document for agents.

Example request

No key is required for normal read traffic.

curl 'https://ipoherald.example/api/v1/ipos?status=open'

# 200 OK
{
  "data": [...],
  "meta": {
    "count": 4,
    "generatedAt": "..."
  }
}

Rate limits

10 requests per 10 seconds and 60 per minute per network address. A limited response returns 429 and Retry-After.

GMP policy

GMP is unofficial. Observations are published only with a named source, timestamp, and confidence label. IPO Herald never converts absence into zero.

Reliable IPO data,without scraping HTML.

Endpoints

Reliable IPO data,
without scraping HTML.