Docs navigation

Tiers & quotas

Blockchain Academics ships one product, the Crypto Brain with its 105 tools, across five access tiers: Free, Starter, Pro, Team and Enterprise. The tool surface is the same at every tier. What changes is the monthly quota, the rate limit, which tools return data instead of BCA_TIER_LOCKED, how far back history goes, and whether strip_attribution is honored.

Quick reference

TierAgent-backed toolsas_of queriesstrip_attributionSeats
FreeNoNoNo1
StarterNoNoNo1
ProYes, with a daily job capYesYes1
TeamYes, with a higher daily capYesYes5 included
EnterpriseYes, negotiatedYesYes, white-label availableNegotiated

Every tier has a monthly call quota and a per-second rate limit, and both grow with the plan. The free tier has no card and no time limit.

Tool gating

Most tools are available at every tier. Gating happens per tool: a call above your tier returns HTTP 403 with BCA_TIER_LOCKED rather than a thinner payload. The minimum tier per category, read from the same catalog the tool reference is built from:

CategoryToolsMinimum tierGated above the minimum
Content & corpus7Freeget_as_of_snapshot (Enterprise)
Market data4Freeget_ohlc (Starter), get_pair_data (Starter)
On-chain4Freeget_wallet_profile (Starter), get_tx (Starter), get_token_holders (Pro)
Sentiment + crypto Twitter6Freeget_social_pulse (Pro), get_ct_pulse (Pro), get_x_signals (Pro), get_kol_consensus (Pro)
Proprietary indicators6Starterget_coverage_index (Pro), get_narrative_strength (Pro), get_sentiment_velocity (Pro), get_editorial_premium (Pro), get_kol_influence (Pro)
Agent-backed generation (async)6Freegenerate_due_diligence (Pro), generate_tokenomics_model (Pro), summarize_whitepaper (Pro), translate_contract (Pro), monitor_keyword (Pro)
Directories16FreeNone
Fundamentals6Freeget_tokenomics (Starter)
Chain-specific4FreeNone
Microstructure5FreeNone
Narrative / meta5FreeNone
Regulatory4StarterNone
Security4FreeNone
Memes / degen4FreeNone
Compute / AI crypto2FreeNone
Services (revenue)3FreeNone
History time-series4FreeNone
Corpus meta7FreeNone
Memos / theses / social / currencies8FreeNone

When a caller hits a tool above their tier, the server returns HTTP 403 with an error body: { "error": { "code": "BCA_TIER_LOCKED", "message": "Tool requires pro tier.", "request_id": "req_…" } }. Agents catch the 403, read error.code and surface the upgrade path.

Attribution by tier

TierAttribution rule
Freecite_url surfaced verbatim. Stripping gets the key rate-limited first.
StarterSame as Free.
Procite_url recommended. strip_attribution: true honored on applicable read tools.
TeamSame as Pro. The dashboard shows per-seat citation compliance.
EnterpriseFull white-label; cite_url may be replaced with a contract-approved scheme.

See Attribution & licensing for what "verbatim" means in practice.

Getting a key

  1. Sign up at blockchainacademics.com/crypto-api/signup: free, by email, no card.
  2. The key (bca_live_…) arrives by email and is on your dashboard.
  3. Drop it into BCA_API_KEY in your MCP config or shell.
  4. For a paid plan, pick one on Pricing: the same key moves up on the first successful charge.

Rate-limit response

Over-limit calls return HTTP 429 with a JSON body the MCP server surfaces as a structured error:

json
{
  "error": {
    "code": "BCA_RATE_LIMIT",
    "message": "Rate limit exceeded on the Free tier. Retry-After: 8s.",
    "retry_after_seconds": 8
  }
}

The bundled HTTP client honors Retry-After. Custom clients: sleep the indicated seconds and retry, or upgrade.

Next