Make your first API call.

Quickstart

Once you're off the waitlist we'll issue an API key. Then:

$ curl https://api.hawkdata.io/v1/events \
    -H "Authorization: Bearer YOUR_API_KEY" \
    --data-urlencode "ticker=AAPL"

{
  "data": [
    {
      "event_id": "evt_8f3a91c4",
      "ticker": "AAPL",
      "cik": "0000320193",
      "type": "leadership_change",
      "filing": {
        "form": "8-K",
        "item": "5.02",
        "filed_at": "2025-08-12T20:31:00Z"
      }
    }
  ]
}

Endpoints

• GET /v1/events — query the event stream by ticker, CIK, type, or filing window.
• GET /v1/companies/:ticker/audit_trail — fetch the full chronological event history for a company.
• GET /v1/companies/:ticker/predictions — current outcome probabilities and horizons.
• POST /v1/webhooks — register a webhook, filter by event type or company set.

Schema

Every event has the same top-level shape: event_id, ticker, cik, type, filing (form, item, accession, filed_at, url), and a type-specific payload.

Rate limits & SLAs

Documented at launch. Pilot customers get a dedicated channel and direct contact with engineering.