AIR Stock Discovery API
Every response body carries disclaimer. Free-plan responses also carry attribution_required: true and the exact attribution string, which must be shown…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Every response body carries disclaimer. Free-plan responses also carry attribution_required: true and the exact attribution string, which must be shown wherever AIR data is used in public. Daily limits are per account and shared by all of its keys. Plans, limits and the API Terms: https://www.aistockradars.com/developers. Versioning: v1 is additive-only. New fields, endpoints and enum values may appear at any time without notice — ignore fields you do not know and handle enum values you do not know. Existing v1 fields are never removed or renamed and never change meaning. A breaking change ships as /v2; v1 then keeps running for at least 6 months, announced on /developers, by email to every active key owner, and in-band on every v1 response (Deprecation and Sunset headers and a deprecation field). Methodology changes (how scores are computed) do not change the API shape; they are listed in the changelog with the date of their decision record.
Endpoints 7
- GETThe companies AIR currently covers
/companiesTicker, name, sector and cap-size label (small, mid or large) for every company in AIR's universe, ordered by ticker. The cap label is null for a company… - GETA company's current AIR read
/companies/:tickerThe AIR score, the five perspectives as rating words, AIR confidence (the overall confidence behind the read) and the Discovery Gap, exactly as the company… - GETSEC filings on the company's timeline
/companies/:ticker/evidenceNewest first. The last twelve months by default; all=true for the full history on file. summary is AIR's one-paragraph reading of the filing where the site… - GETDividend and buyback facts from SEC filings
/companies/:ticker/capital-eventsEach event is one plain sentence (line) as stated in the company's 8-K, with the filing it came from. current is the latest dividend change and the latest… - GETThe Discover ranking
/discoverThe current ranked list as /discover shows it: companies with AIR confidence (the overall confidence behind the read) of at least min_confidence, ordered by… - GETThe forward ledger
/ledgerFor each closed month, the five companies with the widest Discovery Gap at that month's end (AIR confidence, the overall confidence behind the read, of at… - GETYour plan, today's usage and limits
/meusage_today counts this call. The day resets at 00:00 UTC.
API details
- Base URL
https://www.aistockradars.com/api/v1- Authentication
- A bearer token in the Authorization header
- Operations
- 7 operations on 7 pathsGET 7
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
1.0.2 - Links
- OpenAPI document · Terms of service · Support
How to test the AIR Stock Discovery API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the AIR Stock Discovery API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “The companies AIR currently covers” (GET /companies), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the AIR Stock Discovery API?
Every response body carries disclaimer. Free-plan responses also carry attribution_required: true and the exact attribution string, which must be shown… It is listed under Finance & banking and has 7 endpoints.
Who publishes the AIR Stock Discovery API?
It is listed from AIStockRadars's public API description (an OpenAPI document), not published by AIStockRadars on Swastik Codes. Anyone who controls aistockradars.com can claim the profile by adding a DNS TXT record.
What is the base URL of the AIR Stock Discovery API?
Requests go to https://www.aistockradars.com/api/v1. Endpoint paths are added to this base URL.
How do I authenticate with the AIR Stock Discovery API?
With A bearer token in the Authorization header.
How many endpoints does the AIR Stock Discovery API have?
7 operations on 7 paths (7 GET).
Is forking the AIR Stock Discovery API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.