IPO Tracker API
A JSON API for pre-IPO, IPO and newly-public company data. Base URL: https://ipotracker.app/api/v1. Every key needs an active subscription — see plans.
Authentication
Send your key as a Bearer token (the X-Api-Key header is also accepted). Keys are shown once at creation and stored hashed — keep them secret and server-side.
curl https://ipotracker.app/api/v1/companies \
-H "Authorization: Bearer ipo_live_xxxxxxxxxxxxxxxx"Errors
Errors use a consistent envelope with a stable machine code:
{ "error": { "code": "unauthorized", "message": "Missing or invalid API key" } }| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request | Malformed query or body. |
| 401 | unauthorized | Missing, unknown or revoked key. |
| 402 | payment_required | No active subscription. |
| 403 | plan_limit | Request exceeds your plan. |
| 404 | not_found | Unknown endpoint or resource. |
| 429 | rate_limited | Per-minute rate limit hit. |
| 429 | quota_exceeded | Monthly quota hit. |
Rate limits & quota
Each response carries X-RateLimit-* (per minute) and X-Quota-* (per month) headers. On 429, respect the Retry-After header.
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-Quota-Limit: 100000
X-Quota-Remaining: 99123Pagination
List endpoints accept limit and offset and return { items, total, limit, offset }. Invalid values return 400.
Endpoints
| GET | /companies | List companies (filters + data-quality meta). |
| GET | /companies/{slug} | One company with full listings. |
| GET | /companies/{slug}/news | Per-company classified news. |
| GET | /companies/{slug}/sec-filings | SEC EDGAR filing timeline. |
| GET | /news | Aggregated, asset-tagged news feed. |
| GET | /calendar | IPO calendar, filterable by date/status. |
| GET | /candles | OHLC candles (plan-capped history). |
| GET | /sources | Aggregation source metadata. |
| GET | /me | Your plan, limits and month-to-date usage. |
Example — the most-awaited IPOs with a live market:
curl "https://ipotracker.app/api/v1/companies?collection=most-awaited&limit=5" \
-H "Authorization: Bearer $IPO_TRACKER_API_KEY"Get started
Subscribe to a plan, then create a key from your account dashboard.