AIR, from your own code.

What the API covers

Every 8-K, 10-Q and 10-K on a covered company's timeline, with its form, its items and whether AIR classed it as material — an 8-K API and a material events API in one call. AIR scores, Discovery Gap reads and the Discover ranking come from the same key.

Use it as an SEC EDGAR API alternative for research: filings arrive already tied to a company and to AIR's read, so there is no EDGAR parsing on your side. Coverage is the ~1,800 companies AIR follows, not all of EDGAR.

The Free plan costs nothing, and paid plans are priced for independent developers — an affordable financial data API for filings and research reads. It serves no stock prices.

Quickstart

1. Sign in, open Account → API and create a key. It is shown once — copy it then.
2. Check the key and your plan:

List companies, then read one by its ticker:

Every response is JSON with data and a disclaimer (“Research, not investment advice.”). The full description is at /api/v1/openapi.json (OpenAPI 3.1).

Attribution

On the Free plan, every public use of AIR data from the API must show this line, linked to www.aistockradars.com where the medium allows links:

Source: AIR Stock Discovery — www.aistockradars.com

Free-plan responses carry it as attribution, with attribution_required: true. Builder and Pro waive the requirement while the subscription is active. If a paid plan ends, it applies again from the end of the paid period.

Plans

• Daily limits are per account: all of your keys share one limit. Three keys on Builder share 10,000 calls a day between them — not 10,000 each.
• Every plan: up to 10 calls a second. The day resets at 00:00 UTC. Refused calls are not counted.
• Pro adds month-end Discover rankings for closed months and email support.
• Yearly is two months free.
• Prices marked “EU price incl. VAT” include 21% Spanish VAT, charged to consumers in the EU.
• Businesses: the price excl. VAT applies. EU businesses with a valid VAT ID are reverse-charged.
• Outside the EU, you pay the price excl. VAT. Checkout shows your exact total before you pay.

Endpoints

Base URL https://beta.aistockradars.com/api/v1. Send Authorization: Bearer <key> with every call.

Errors

Errors are JSON: {"error": {"code", "message"}}. A refused call (401, 403, 429) is not counted. On 429 wait for the Retry-After seconds. Codes:

missing_key · invalid_key · revoked_key · rate_limited · daily_limit · not_found · bad_request · forbidden_tier · metering_unavailable · internal_error

API stability & versioning

• v1 is additive-only. We may add fields, endpoints and enum values at any time without notice. Your client must ignore fields it does not know and handle enum values it does not know.
• We will never remove or rename an existing v1 field or change what it means. Anything that would break a v1 client ships as a new version, /v2.
• When /v2 ships, v1 keeps running for at least 6 months. We announce the deprecation on the Developers page and by email to every active key owner, and from then on every v1 response carries Deprecation and Sunset headers and a deprecation field.
• Methodology changes — how scores are computed — do not change the API's shape. They are listed in the changelog with the date of their decision record.

Changelog