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.Documentation Index
Fetch the complete documentation index at: https://docs.mavera.io/llms.txt
Use this file to discover all available pages before exploring further.
API Reference Card
| Detail | Value |
|---|---|
| Base URL | https://www.alphavantage.co/query |
| Auth | API key as apikey query parameter |
| Rate limits | Free: 25 req/day; Premium: 75–1,200 req/min (plan-dependent) |
| Key functions | NEWS_SENTIMENT, EARNINGS_CALENDAR, REAL_GDP, CPI, UNEMPLOYMENT, SECTOR |
| Mavera base | https://app.mavera.io/api/v1 |
| Mavera auth | Authorization: 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
Alpha Vantage API key
Get a free key at alphavantage.co/support. Premium keys available at alphavantage.co/premium.
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.
Mavera API key
Get your key from Mavera dashboard.
Jobs
| # | Job | Alpha Vantage Data | Mavera Surface | Output |
|---|---|---|---|---|
| 1 | Market Sentiment → Brand Positioning | NEWS_SENTIMENT | Mave Agent (Chat) | Sentiment-aligned positioning strategy |
| 2 | Earnings Calendar → Content Timing | EARNINGS_CALENDAR | Mave Agent + Generate | Earnings-timed content plan |
| 3 | Economic Indicator → Focus Group | REAL_GDP, CPI, UNEMPLOYMENT | Personas + Focus Groups | Demographic persona reactions |
| 4 | Sector Performance → Vertical Prioritization | SECTOR | Mave Agent + Generate | Vertical marketing priority matrix |
Rate Limits & Production Notes
| Alpha Vantage Function | Free Limit | Premium | Strategy |
|---|---|---|---|
NEWS_SENTIMENT | 25 req/day (shared) | 75-1200 req/min | 15s delay between ticker calls |
EARNINGS_CALENDAR | 25 req/day (shared) | 75-1200 req/min | Cache weekly — dates rarely change |
REAL_GDP, CPI, UNEMPLOYMENT | 25 req/day (shared) | 75-1200 req/min | Cache monthly — data updates monthly/quarterly |
SECTOR | 25 req/day (shared) | 75-1200 req/min | Cache daily — updates intraday |