every edgeful plan includes API access — but what you can do with it depends on your tier. essentials gives you a starter setup so you can test the API. pro unlocks the full catalogue. all-access adds the deepest historical data and individual-day detail.
this article breaks down what's included in each tier and what the rate limits are.
the 3 tiers at a glance
feature | essentials | pro | all-access |
reports | 3 select reports | all reports | all reports |
tickers | RTY, AAPL, ETH/USDT, GBP/CAD | all tickers | all tickers |
historical lookback | 6 months | 1 year | 8 years |
what's in play (live) | not included | included | included |
screener (live) | not included | included | included |
data depth | summary only | summary only (aggregated probabilities) | per-day / row-level detail (the underlying dataset) |
rate limits | 30 req / 60s + 5 req / 5s burst (default — uniform across tiers) | 30 req / 60s + 5 req / 5s burst | 30 req / 60s + 5 req / 5s burst |
price | $49/mo (essentials plan) | $99/mo | $299/mo (algos plan) |
the short version: essentials is for testing the API and seeing if it fits your workflow. pro is the right tier if you want to use the API on real tickers and reports. all-access is for anyone who wants the full 8-year history and the ability to drill into individual days.
what each tier unlocks
essentials
designed as a try-before-you-upgrade tier. you can confirm the API works, integrate it with Claude or ChatGPT, and prototype against it without committing to a paid upgrade.
3 reports — Opening Stats, Green & Red Days by Weekday, Previous Day's Range
4 test tickers — RTY, AAPL, ETH/USDT, GBP/CAD (one from each market type — futures, stock, crypto, forex — so you can test every shape of request)
6 months of historical data — enough to validate a workflow, not enough for long-term backtesting
summary data only — aggregated probabilities, no per-day detail
no live data integration — what's in play and the screener aren't exposed on this tier
essentials is included with the $49/mo essentials plan at no extra cost. if the API fits your workflow, the upgrade path is in the next section.
pro
the tier most people end up on if they're actually using the API in production. opens up the full reports catalog and every ticker the platform supports.
all reports — the full report catalog
all tickers — futures (ES, NQ, GC, etc.), stocks (SPY, QQQ, AAPL, etc.), forex (EURUSD, GBPJPY, etc.), crypto (BTCUSD, ETHUSD, etc.)
1 year of historical data — enough lookback for most strategy work
what's in play live data — pull the same WIP data the dashboard uses
screener live data — same data behind the screener page
summary data only — aggregated probabilities, same shape as essentials, just broader catalog and longer lookback
pricing: $99/mo. that's $50/mo more than the essentials plan.
all-access (algos plan)
the top tier. all of pro, plus the historical depth and per-day detail that lets you build precise backtests and event-driven analyses.
everything in pro, plus:
8 years of historical data — soon to be 9 years
per-day / row-level detail — the underlying dataset, not just the aggregate. instead of getting back "gap fill 60/40" as a stat, you can ask for the underlying days. examples: longest streak of gaps up that filled, every day in the last 5 years where SPY gapped down >0.5% and didn't fill, etc.
the algo suite — algo dashboard + TradingView indicator suite bundled in
technical note on the response shape: per-day rows are returned in a detailed field on the report response. on plans with row-level access (all-access), that field is populated. on plans without row-level detail (essentials, pro), the API omits detailed from the response entirely — you get the summary numbers and that's it. this matches what the developer docs describe.
all-access is $299/mo and comes with the algos plan — the same plan that powers the algo dashboard and indicator suite.
rate limits
rate limits apply per API key, but they aggregate at the account level — spreading requests across multiple keys won't get you around the limit.
the default is the same on every tier: 30 requests per 60-second window (sustained), plus a short burst allowance of 5 requests per 5 seconds. tier doesn't change the rate limit — what tier changes is what you can call (reports, tickers, lookback, data depth), not how often. these defaults match what's published in the authentication docs.
when you exceed your limit, the API returns a 429 with body {"detail": "API key rate limit exceeded"}.
best practice when you hit a 429:
back off with exponential delay (1s, then 2s, then 4s, etc.) before retrying
cache responses where it makes sense — most report data doesn't change intraday, so calling it more than once per session is usually unnecessary
if you're consistently hitting the limit on your tier, upgrading is the cleanest fix. full troubleshooting for 429s and other error codes is in the API errors and troubleshooting article.
which tier am I on?
you can see your current plan in the edgeful dashboard under your account settings. if you're not sure whether your tier includes API access on a specific report or ticker, the easiest check is the table above, or to call the endpoint and see if the response includes the data you expect.
to upgrade, head to the in-app upgrade flow. the billing + upgrading between tiers article covers exactly what happens when you upgrade, when changes take effect, and how to downgrade.
developer docs
for the canonical reference on header format, error responses, session presets, and the full endpoint catalog:
→ authentication — header format, rotation, error responses, rate limits
→ session presets — intraday start_time / end_time / timezone values