Skip to main content
Alpha Vantage provides free and premium APIs for real-time and historical financial data — stock prices, economic indicators, earnings calendars, and market news sentiment. These four jobs connect financial signals to Mavera’s surfaces (Mave Agent, Personas, Focus Groups, Generate) to align brand positioning with market sentiment, time content to earnings cycles, test economic messaging with demographic personas, and prioritize vertical marketing based on sector performance.

​
API Reference Card

DetailValue
Base URLhttps://www.alphavantage.co/query
AuthAPI key as apikey query parameter
Rate limitsFree: 25 req/day; Premium: 75–1,200 req/min (plan-dependent)
Key functionsNEWS_SENTIMENT, EARNINGS_CALENDAR, REAL_GDP, CPI, UNEMPLOYMENT, SECTOR
Mavera basehttps://app.mavera.io/api/v1
Mavera authAuthorization: Bearer mvra_live_...
All examples use ALPHA_VANTAGE_KEY for Alpha Vantage and MAVERA_API_KEY for Mavera. Free keys are limited to 25 requests/day — cache responses aggressively. Premium keys unlock higher throughput and intraday data.

​
Prerequisites

1

Alpha Vantage API key

Get a free key at alphavantage.co/support. Premium keys available at alphavantage.co/premium.
2

Understand rate limits

Free: 25 req/day (5 req/min). Premium tiers go up to 1,200 req/min. All jobs below use 1-3 Alpha Vantage calls per run.
3

Mavera API key

Get your key from Mavera dashboard.
4

Environment variables

export ALPHA_VANTAGE_KEY="your-av-key"
export MAVERA_API_KEY="mvra_live_xxxxx"

​
Jobs

#JobAlpha Vantage DataMavera SurfaceOutput
1Market Sentiment → Brand PositioningNEWS_SENTIMENTMave Agent (Chat)Sentiment-aligned positioning strategy
2Earnings Calendar → Content TimingEARNINGS_CALENDARMave Agent + GenerateEarnings-timed content plan
3Economic Indicator → Focus GroupREAL_GDP, CPI, UNEMPLOYMENTPersonas + Focus GroupsDemographic persona reactions
4Sector Performance → Vertical PrioritizationSECTORMave Agent + GenerateVertical marketing priority matrix

​
Rate Limits & Production Notes

Alpha Vantage FunctionFree LimitPremiumStrategy
NEWS_SENTIMENT25 req/day (shared)75-1200 req/min15s delay between ticker calls
EARNINGS_CALENDAR25 req/day (shared)75-1200 req/minCache weekly — dates rarely change
REAL_GDP, CPI, UNEMPLOYMENT25 req/day (shared)75-1200 req/minCache monthly — data updates monthly/quarterly
SECTOR25 req/day (shared)75-1200 req/minCache daily — updates intraday
Alpha Vantage free tier shares 25 req/day across ALL functions. Run one job per day on free tier, or cache responses. The API returns HTTP 200 with a "Note" key when rate-limited — always check for this before parsing. Premium keys ($49.99/month+) unlock 75+ req/min. Store credentials in env vars. Monitor Mavera credits at Dashboard.

All Integrations

Alpha Vantage Docs

Personas

Focus Groups

Mave Agent

Generate