PIT API quickstart

Run a query without an API key

The /v1/sample routes do not require an Authorization header. They support three sample companies: svb, aapl, and meta. These routes use the same backend and response envelope as paid routes. Every response includes sample: true. The rate limit is 30 requests a minute per IP.

The as_of parameter sets the query timestamp. The API excludes all records timestamped after this value.

$ curl -s "https://api.pit.aqx.llc/v1/sample/news?example=svb&as_of=2023-03-09T20:00:00Z"

{
  "as_of": "2023-03-09T20:00:00Z",
  "visible_by": "published_at",
  "status": "ok",
  "results": [],
  "count": 0,
  "coverage": { "touched": ["sec.edgar/2023-03-09", …], "missing": [] }
}

No records matched, and coverage.missing is empty. This confirms that every day queried has a valid certificate and SVB had zero filings at that timestamp. The certificate for sec.edgar/2023-03-09 is complete with 2,828 rows.

$ curl -s "https://api.pit.aqx.llc/v1/sample/news?example=svb&as_of=2023-03-10T23:59:59Z"

{
  "results": [
    {
      "id": "0001193125-23-067777_719739",
      "source_id": "sec.edgar",
      "form": "8-K",
      "cik": "719739",
      "title": "SVB FINANCIAL GROUP 8-K",
      "published_at": "2023-03-10T23:59:59Z",
      "available_at": null,
      "acceptance_at": "2023-03-10T22:23:03Z",
      "availability_basis": "unknown",
      "content_sha256": "8a95862ef…d2d06a"
    }
  ],
  "count": 1
}

One day later, the response includes the receivership 8-K. Only the as_of parameter differs between the two calls. See Timestamps for why published_at is set to 23:59:59 and why available_at is null.

Other sample routes

Python

The Python client wraps the same API routes. Its known_at argument maps directly to the as_of parameter.

$ pip install ./clients/python

from pitnews import PitClient

client = PitClient(api_key="pit_live_…")
page = client.query_as_of(
    ticker="SIVB",
    source="sec.edgar",
    known_at="2023-03-10T23:59:59Z",
    visible_by="published_at",
)

To test without a key, call /v1/sample/news directly. Each sample covers one of three companies and returns the standard JSON response format. An API key grants access to all 587,689 rows.

API keys

Paid routes require the header Authorization: Bearer pit_live_…. Log in using GitHub, Google, or email to create API keys in the dashboard. You can create multiple keys per account. Each key shows a name, prefix, last-used timestamp, and a revoke button. The secret is displayed only once at creation time. All plans access the entire ingested history. Plans differ by rate limit, key cap, and Parquet file access; see pricing for details.

Standard API keys cover internal use by you or your employer. If your users receive PIT data, you must obtain a commercial license.

Additional documentation