Skip to main content

Entitlements

Some Alphio features are gated by your subscription tier, your add-on packages, or by feature flags. This page explains why and how to unlock them.

1. Tier-based entitlements​

The base feature gate is your subscription tier — Free / Base / Pro / Elite. Each tier unlocks a defined feature set:

  • Free — chat, basic research, watchlist, limited screener access.
  • Base — adds Whales Auto Tracker, AI Earnings Calendar, unlimited AI Screener, Custom Credits eligibility.
  • Pro — adds all 7 Signals products except Quant AI Alpha Pick, plus Agentic Trading, Auto Trade, and Copy Trading.
  • Elite — adds Quant AI Alpha Pick on top of Pro.

The full matrix lives at Subscription Tiers.

When a feature is tier-gated, Alphio uses subscription-store selectors (useHasBaseTierOrAbove, useHasSignalsPackage, etc.) to decide whether to render the feature or a paywall.

2. Feature flags​

Beyond tier gating, Alphio uses feature flags for:

  • A/B tests — half of users see a redesigned page, half stay on the old one.
  • Gradual rollouts — a new product ships to 5% of users, then 25%, then 100%.
  • Region / locale gating — some products are hidden in regulated regions.
  • Account-level overrides — a specific user is in early access, or excluded from a buggy build.

Feature flags are fetched at app startup and cached client-side. They override tier-based access in both directions: a flag can hide a feature you "should" have, or grant access to one your tier wouldn't normally include.

This means two users on the same tier may legitimately see different features.

3. Paywall UI​

When you try to access a feature you don't have access to, Alphio renders a paywall in place of the feature surface. The paywall typically includes:

  • Why you can't access it — the required tier or add-on.
  • What you'd unlock — a short list of the feature's benefits.
  • CTA buttons — usually "Upgrade" (goes to /account/subscribe) and "Learn more" (opens the doc page).

Paywalls are non-blocking: you stay on the page you tried to open, the feature surface is just replaced. You can always navigate away.

For Credit-cost paywalls (you have access to the feature but not enough Credits), see Credits System.

4. Add-on packages​

Some entitlements ship as add-on packages that layer on top of a paid base tier:

  • Signals package — bundles specific Signals products (e.g. Stock Signal bundle, Crypto Signal bundle) for users who don't need the full Pro tier.
  • Copytrade package — unlocks specific Copy Trading sources (Quant AI, SwingMax Portfolio, Whales).
  • Whales Pro — extended depth for Whales Auto Tracker.

Add-ons require a paid base tier (Base / Pro / Elite — not Free) and are typically billed annually. The Subscribe page shows which add-ons are available for your current tier.

warning

The exact catalog of available add-ons, their pricing, and which Signals / Copy Trade sources each package includes is being finalized. Treat the in-app Subscribe page as authoritative.

5. Checking your entitlements​

The canonical view is /account/subscription. It shows:

  • Base tier — Free / Base / Pro / Elite, with end date and next billing.
  • Active add-ons — every Signals package and Copytrade package you've subscribed to, with their individual end dates.
  • Quota and credit grants — daily / monthly Credits granted, used, and remaining.

For developer / debugging context, the same data is exposed via subscription-store selectors:

  • useHasBaseTierOrAbove(BaseTier.Pro) — true if user is Pro or Elite.
  • useHasSignalsPackage(pkg) — true if user has a specific Signals add-on.
  • useHasCopytradePackage(pkg) — true for a specific Copytrade add-on.
  • useFeatureEnabled(flagName) — true if the named feature flag is enabled for this account.

6. Why a feature might disappear​

A feature you had yesterday might be gone today. Common reasons:

  • Subscription downgraded or expired — at the end of the cycle, you drop to the lower tier and lose its entitlements.
  • Add-on expired — Signals or Copytrade package end date passed without renewal.
  • Feature flag rolled back — the product team disabled a flag (e.g. paused an A/B test, rolled back a buggy release).
  • Region / locale change — a flag that gates by country / language switched you off after you changed locale.
  • Account-level adjustment — rare, but if you were in a beta-only cohort and the beta ended, access is removed.

If you believe access was removed in error, contact support through /account — they can check both the entitlements record and the flag set for your account.

Agent Instructions: Querying This Documentation

If you need information not on this page, you can query the docs dynamically by sending a GET request with the ask query parameter:

GET https://docs.alphio.ai/reference/entitlements.md?ask=<question>

The question should be specific, self-contained, and written in natural language. The response includes a direct answer plus relevant excerpts and sources.