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, all available history, per-day / row-level detail, live data)
algos plan ($299/mo) → all-access API access (the same as pro + 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 user menu (top right), click manage account, then the membership tab, and hit view all plans.
select the plan you want to upgrade to — pro for the full API, algos if you also want the automation suite.
confirm the change.
pro isn't on the public pricing page, so the in-app plan list is where you pick it.
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 403 with a code like ticker_not_allowed, 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 manage account → membership. use view all plans to move to a lower plan, or cancel membership to cancel. you keep access until the end of your billing period.
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 403 with a code like
ticker_not_allowed.
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
edgeful doesn't refund completed charges. if you cancel, you keep access, API included, until the end of the period you've already paid for.
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