if you're on essentials and want more reports, more tickers, or longer lookback, the upgrade path runs through your existing edgeful subscription — not through a separate API checkout. this article covers how to upgrade, what happens to your existing keys, and how billing changes apply.
how the API plans are billed
the API isn't billed as a separate product. it rides on top of your existing edgeful subscription, and the API tier you have access to is determined by the plan you're on:
essentials plan ($49/mo) → essentials API access (3 reports, 4 test tickers, 6-month lookback, summary data only)
pro plan ($99/mo) → pro API access (all reports, all tickers, 1-year lookback, live data, summary data only)
algos plan ($299/mo) → all-access API access (everything in pro + 8-year history + per-day / row-level detail + the algo suite)
upgrading your edgeful plan upgrades your API access automatically. the same keys you generated on essentials keep working — they just unlock more reports, tickers, and history once your plan changes.
upgrade in-app
upgrades happen inside the edgeful platform, not on an external pricing page.
open the edgeful dashboard and go to settings → billing (or whichever page your plan is managed from).
select the plan you want to upgrade to — pro for API expansion, algos for the full 8 years + per-day detail.
confirm the change.
we don't currently have an external upgrade page for the API specifically — every upgrade is handled inside the app. that may change as the API rolls out more broadly.
when the upgrade takes effect
plan changes are typically reflected in your API access within a few minutes of the upgrade processing. if you make a call right after upgrading and it still returns a tier-restricted error, give it a couple of minutes and retry.
your existing API keys do not need to be regenerated after an upgrade. the same key value continues to work — it just authenticates against your new tier's catalog.
what about prorating?
if you upgrade mid-month, the difference is prorated against your remaining billing period. you'll see the prorated charge on your next invoice.
downgrading or canceling
to downgrade or cancel:
go to settings → billing in the edgeful dashboard.
select the lower-tier plan or cancellation option.
confirm. your existing keys keep working — they just drop back to whatever access level the new plan includes. if you were on pro and call a pro-only ticker after downgrading to essentials, the API will return a tier-restricted error.
if you cancel your edgeful subscription entirely, your API keys are revoked at the end of your billing period. any code that was using them will start returning 401 after that date.
refunds
refund policy follows the standard edgeful subscription terms. if you're unsure whether you qualify for a refund, the fastest path is to reach out to support directly.
common questions
"I just upgraded but the API still says I don't have access."
give it a couple of minutes. plan changes propagate within a few minutes — if it's been longer than that, ping support with your account email and we'll check the propagation status.
"do I need to generate new keys after upgrading?"
no. your existing keys keep working at the new tier automatically.
"can I have one key on essentials limits and another on pro limits?"
no. all keys on your account share the same tier — whatever plan you're currently on. if you need staged access, you'd have to manage that in your code (e.g., separate clients for production vs. dev).
"what happens to my keys if I cancel?"
they keep working until the end of your billing period, then they're revoked. requests after that point return 401.
developer docs
for technical details — header format, error responses, session presets, and the full endpoint catalog — the developer docs are the source of truth:
→ https://www.edgeful.com/docs/welcome (start here)
→ authentication — header format, key format, rotation, error responses