Market data API
A discovery index listing every market and government dataset this API serves, daily snapshots and historical time series for each tracked category, per-instrument statistics scored against five years of history, an upcoming large-cap earnings calendar, stored market headlines, and the tickers being discussed most across public communities.
The statistics endpoints are the unusual part. Rather than returning a price and leaving the interpretation to you, they score each instrument against its own five-year distribution, which is the calculation most consumers of a raw price feed end up writing themselves.
Endpoints
11 endpoints. Request and response examples for each one are in the full reference.
| Method | Endpoint | What it returns |
|---|---|---|
| GET | /marketapi.bottlebluellc.com |
Discovery index: every market and government dataset this API serves. |
| GET | /market/newsapi.bottlebluellc.com |
Stored market headlines. |
| GET | /market/predictionsapi.bottlebluellc.com |
Daily model-generated SPY predictions. |
| GET | /market/trendingapi.bottlebluellc.com |
The most talked about stocks across popular corners of the internet. |
| GET | /market/{category}api.bottlebluellc.com |
Latest daily snapshot for a market category. |
| GET | /market/{category}/{entity}api.bottlebluellc.com |
Historical time series for one instrument or series. |
| GET | /market/earningsapi.bottlebluellc.com |
Upcoming large-cap earnings (forward-looking). |
| GET | /market/earnings/{ticker}api.bottlebluellc.com |
One symbol's next scheduled earnings report in the forward window. |
| GET | /market/statsapi.bottlebluellc.com |
Per-instrument statistics scored against 5 years of history, for every instrument at once. |
| GET | /market/stats/{category}api.bottlebluellc.com |
Per-instrument statistics for every instrument in one source category. |
| GET | /market/stats/{category}/{entity}api.bottlebluellc.com |
The full statistics statement for one instrument. |
Where the data comes from
| Data | Published by |
|---|---|
| Market categories and historical series | Collected on a schedule into Bottle Blue's own store, see the full reference per category |
| Government datasets in the same index | The filing offices listed on the congressional trading page |
| Headlines | Multiple public news sources, each item carrying its own link |
| Trending tickers | Our own crawl of public Reddit investing communities |
Getting started
Every endpoint is JSON over HTTPS and takes one API key in an x-api-key header. There is no SDK to install and no OAuth dance.
curl "https://api.bottlebluellc.com/v1/market" \
-H "x-api-key: $BBL_API_KEY"Quickstart, authentication and errors and rate limits are documented in the reference. Keys are issued from the Bottle Blue dashboard.
Common questions
What is the difference between the market and stats endpoints?
The market endpoints return values: the latest snapshot for a category, or a historical series for one instrument. The stats endpoints return those values scored against five years of that instrument's own history, so you get where a number sits in its distribution rather than only the number.
How do I find out which categories exist?
Call the discovery index at the root of the market namespace. It lists every market and government dataset the API serves, which means you do not have to hardcode a category list that can go stale.
Is the earnings calendar forward looking?
Yes, and it is the one market endpoint that is. Every other category returns what has already happened; the earnings endpoints return scheduled reports in a forward window, either across large caps or for a single symbol.
Is this real-time market data?
No. The collectors run on a schedule and the endpoints serve the most recent completed snapshot, so this suits analysis, dashboards and research rather than execution. If you need a live order book, this is not the right API.