# Alpha vantage ```json { "name": "Alpha vantage", "slug": "alpha_vantage", "url": "https://composio.dev/toolkits/alpha_vantage", "markdown_url": "https://composio.dev/toolkits/alpha_vantage.md", "logo_url": "https://logos.composio.dev/api/alpha_vantage", "categories": [ "finance & accounting" ], "is_composio_managed": false, "updated_at": "2026-05-06T08:00:11.092Z" } ``` ![Alpha vantage logo](https://logos.composio.dev/api/alpha_vantage) ## Description Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Alpha Vantage MCP or direct API to fetch live stock quotes, analyze technical indicators, retrieve historical price data, and monitor market trends through natural language. ## Summary Alpha Vantage is a financial data platform offering real-time and historical stock market APIs. Get instant, reliable access to equities, forex, and technical analysis data for smarter trading decisions. ## Categories - finance & accounting ## Toolkit Details - Tools: 20 ## Images - Logo: https://logos.composio.dev/api/alpha_vantage ## Authentication - **Api Key** - Type: `api_key` - Description: Api Key authentication for Alpha Vantage. - Setup: - Configure Api Key credentials for Alpha Vantage. - Use the credentials when creating an auth config in Composio. ## Suggested Prompts - Get latest Brent crude oil prices - Show upcoming earnings calendar for tech stocks - Fetch annual balance sheet for Apple - Retrieve historical global coffee price data ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `ALPHA_VANTAGE_ALL_COMMODITIES` | Get All Commodities Price Index | Tool to retrieve the global price index of all commodities. use when you need monthly, quarterly, or annual aggregated price index data for commodities. | | `ALPHA_VANTAGE_ALUMINUM` | ALUMINUM | Tool to fetch global aluminum prices. use when you need monthly, quarterly, or annual lme aluminum price data. | | `ALPHA_VANTAGE_BALANCE_SHEET` | Balance Sheet | Tool to return annual and quarterly balance sheets for a company. use when you need detailed fiscal statements for analysis. | | `ALPHA_VANTAGE_BRENT` | Brent Crude Oil Prices | Tool to fetch brent crude oil prices. use when you need daily, weekly, or monthly brent price data. | | `ALPHA_VANTAGE_COFFEE` | Global Coffee Price | Tool to retrieve the global coffee price series. use when you need historical monthly, quarterly, or annual coffee prices. | | `ALPHA_VANTAGE_COPPER` | COPPER | Tool to fetch global price of copper in monthly, quarterly, and annual intervals. use when you need historical copper price series for analysis. | | `ALPHA_VANTAGE_CORN` | Corn | Tool to retrieve global price of corn in monthly, quarterly, and annual intervals. use after verifying api key when you need historical corn price data. | | `ALPHA_VANTAGE_COTTON` | COTTON | Tool to retrieve global cotton prices in monthly, quarterly, and annual intervals. use when you need historical cotton price data. | | `ALPHA_VANTAGE_EARNINGS_CALENDAR` | Earnings Calendar | Tool to return the earnings calendar for the next three months. use when you need a schedule of upcoming earnings across symbols. | | `ALPHA_VANTAGE_EARNINGS_CALL_TRANSCRIPT` | Earnings Call Transcript | Tool to retrieve the earnings call transcript for a given company and quarter. use after confirming symbol and quarter. returns full transcript text and associated llm-based sentiment signals. | | `ALPHA_VANTAGE_FX_DAILY` | FX Daily Time Series | Tool to fetch daily time series (open, high, low, close) for a currency pair. use after confirming base and quote currency codes to retrieve historical daily fx rates. | | `ALPHA_VANTAGE_FX_MONTHLY` | FX Monthly Time Series | Tool to get monthly time series (open, high, low, close) for a currency pair. use when you need historical monthly forex data for a given currency pair. | | `ALPHA_VANTAGE_INCOME_STATEMENT` | Income Statement | Tool to fetch annual and quarterly income statements. use after confirming the company symbol. | | `ALPHA_VANTAGE_IPO_CALENDAR` | IPO Calendar | Tool to retrieve the ipo calendar for the next three months. use when you need a list of upcoming ipo events across markets. | | `ALPHA_VANTAGE_LISTING_STATUS` | Listing Status | Tool to fetch listing status of us stocks and etfs. use when you need active or delisted securities as of a date. | | `ALPHA_VANTAGE_NEWS_SENTIMENT` | News Sentiment | Tool to fetch live and historical market news & sentiment. use when you need curated news articles with sentiment scores for specified tickers and topics. | | `ALPHA_VANTAGE_SPLITS` | Stock Splits | Tool to retrieve historical stock split events for a symbol. use when you need past split dates and ratio details before analyzing corporate actions. | | `ALPHA_VANTAGE_SUGAR` | Global Sugar Price | Tool to retrieve the global sugar price series. use when you need historical monthly, quarterly, or annual sugar prices. | | `ALPHA_VANTAGE_TECHNICAL_INDICATOR` | Technical Indicator | Tool to fetch technical indicators for the specified equity or currency pair. use after obtaining time series to compute moving averages or oscillators. | | `ALPHA_VANTAGE_WHEAT` | WHEAT | Tool to fetch global price of wheat. use when you need historical wheat prices in monthly, quarterly, or annual intervals. | ## Supported Triggers None listed. ## Installation and MCP Setup ### Path 1: SDK Installation #### Path 1, Step 1: Install Composio Install the Composio SDK ```python pip install composio_openai ``` ```typescript npm install @composio/openai ``` #### Path 1, Step 2: Initialize Composio and Create Tool Router Session Import and initialize Composio client, then create a Tool Router session ```python from openai import OpenAI from composio import Composio from composio_openai import OpenAIResponsesProvider composio = Composio(provider=OpenAIResponsesProvider()) openai = OpenAI() session = composio.create(user_id='your-user-id') ``` ```typescript import OpenAI from 'openai'; import { Composio } from '@composio/core'; import { OpenAIResponsesProvider } from '@composio/openai'; const composio = new Composio({ provider: new OpenAIResponsesProvider(), }); const openai = new OpenAI({}); const session = await composio.create('your-user-id'); ``` #### Path 1, Step 3: Execute Alpha vantage Tools via Tool Router with Your Agent Get tools from Tool Router session and execute Alpha vantage actions with your Agent ```python tools = session.tools response = openai.responses.create( model='gpt-4.1', tools=tools, input=[{ 'role': 'user', 'content': 'Get the latest balance sheet for Apple Inc.' }] ) result = composio.provider.handle_tool_calls( response=response, user_id='your-user-id' ) print(result) ``` ```typescript const tools = session.tools; const response = await openai.responses.create({ model: 'gpt-4.1', tools: tools, input: [{ role: 'user', content: 'Get the latest balance sheet for Apple Inc.' }], }); const result = await composio.provider.handleToolCalls( 'your-user-id', response.output ); console.log(result); ``` ### Path 2: MCP Server Setup #### Path 2, Step 1: Install Composio Install the Composio SDK and Claude Agent SDK ```python pip install composio claude-agent-sdk ``` ```typescript npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp ``` #### Path 2, Step 2: Create Tool Router Session Initialize the Composio client and create a Tool Router session ```python from composio import Composio from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions composio = Composio(api_key='your-composio-api-key') session = composio.create(user_id='your-user-id') url = session.mcp.url ``` ```typescript import { Composio } from '@composio/core'; const composio = new Composio({ apiKey: 'your-api-key' }); console.log("Creating Tool Router session..."); const { mcp } = await composio.create('your-user-id'); console.log(`Tool Router session created: ${mcp.url}`); ``` #### Path 2, Step 3: Connect to AI Agent Use the MCP server with your AI agent ```python import asyncio options = ClaudeAgentOptions( permission_mode='bypassPermissions', mcp_servers={ 'tool_router': { 'type': 'http', 'url': url, 'headers': { 'x-api-key': 'your-composio-api-key' } } }, system_prompt='You are a helpful assistant with access to Alpha vantage tools.', max_turns=10 ) async def main(): async with ClaudeSDKClient(options=options) as client: await client.query('Get the earnings calendar for the next three months') async for message in client.receive_response(): if hasattr(message, 'content'): for block in message.content: if hasattr(block, 'text'): print(block.text) asyncio.run(main()) ``` ```typescript import { openai } from '@ai-sdk/openai'; import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp'; import { generateText, stepCountIs } from 'ai'; const client = await createMCPClient({ transport: { type: 'http', url: mcp.url, headers: { 'x-api-key': 'your-composio-api-key' } } }); const tools = await client.tools(); const { text } = await generateText({ model: openai('gpt-4o'), tools, messages: [{ role: 'user', content: 'Get the earnings calendar for the next three months' }], stopWhen: stepCountIs(5) }); console.log(`Agent: ${text}`); ``` ## Why Use Composio? ### 1. AI Native Alpha vantage Integration - Supports both Alpha vantage MCP and direct API based integrations - Structured, LLM-friendly schemas for reliable tool execution - Rich coverage for reading, writing, and querying your Alpha vantage data ### 2. Managed Auth - Built-in OAuth handling with automatic token refresh and rotation - Central place to manage, scope, and revoke Alpha vantage access - Per user and per environment credentials instead of hard-coded keys ### 3. Agent Optimized Design - Tools are tuned using real error and success rates to improve reliability over time - Comprehensive execution logs so you always know what ran, when, and on whose behalf ### 4. Enterprise Grade Security - Fine-grained RBAC so you control which agents and users can access Alpha vantage - Scoped, least privilege access to Alpha vantage resources - Full audit trail of agent actions to support review and compliance ## Use Alpha vantage with any AI Agent Framework Choose a framework you want to connect Alpha vantage with: - [OpenAI Agents SDK](https://composio.dev/toolkits/alpha_vantage/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/alpha_vantage/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/alpha_vantage/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/alpha_vantage/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/alpha_vantage/framework/codex) - [OpenClaw](https://composio.dev/toolkits/alpha_vantage/framework/openclaw) - [Hermes](https://composio.dev/toolkits/alpha_vantage/framework/hermes-agent) - [Google ADK](https://composio.dev/toolkits/alpha_vantage/framework/google-adk) - [LangChain](https://composio.dev/toolkits/alpha_vantage/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/alpha_vantage/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/alpha_vantage/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/alpha_vantage/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/alpha_vantage/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/alpha_vantage/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/alpha_vantage/framework/autogen) ## Related Toolkits - [Stripe](https://composio.dev/toolkits/stripe) - Stripe is a global online payments platform offering APIs for managing payments, customers, and subscriptions. Trusted by businesses for secure, efficient, and scalable payment processing worldwide. - [Altoviz](https://composio.dev/toolkits/altoviz) - Altoviz is a cloud-based billing and invoicing platform for businesses. It streamlines online payments, expense tracking, and customizable invoice management. - [Benzinga](https://composio.dev/toolkits/benzinga) - Benzinga provides real-time financial news and data APIs for market coverage. It helps you track breaking news and actionable market insights instantly. - [Brex](https://composio.dev/toolkits/brex) - Brex provides corporate credit cards and spend management tailored for startups and tech businesses. It helps optimize company cash flow, streamline accounting, and accelerate business growth. - [Chaser](https://composio.dev/toolkits/chaser) - Chaser is accounts receivable automation software that sends invoice reminders and helps businesses get paid faster. It streamlines the collections process to save time and improve cash flow. - [Clientary](https://composio.dev/toolkits/clientary) - Clientary is a platform for managing clients, invoices, projects, proposals, and more. It streamlines client work and saves you serious admin time. - [Coinbase](https://composio.dev/toolkits/coinbase) - Coinbase is a platform for buying, selling, and storing cryptocurrency. It makes exchanging and managing crypto simple and secure for everyone. - [Coinranking](https://composio.dev/toolkits/coinranking) - Coinranking is a comprehensive cryptocurrency market data platform offering access to real-time coin prices, market caps, and historical data. Get accurate, up-to-date stats for thousands of digital assets in one place. - [Coupa](https://composio.dev/toolkits/coupa) - Coupa is a business spend management platform for procurement, invoicing, and expenses. It helps organizations streamline purchasing, control costs, and gain complete visibility over financial operations. - [CurrencyScoop](https://composio.dev/toolkits/currencyscoop) - CurrencyScoop is a developer-friendly API for real-time and historical currency exchange rates. Easily access fiat and crypto data for smart, up-to-date financial applications. - [Daffy](https://composio.dev/toolkits/daffy) - Daffy is a modern charitable giving platform with a donor-advised fund. Easily set aside funds, grow them tax-free, and donate to over 1.7 million U.S. charities. - [Eagle doc](https://composio.dev/toolkits/eagle_doc) - Eagle doc is an AI-powered OCR API for invoices and receipts. It delivers fast, reliable, and accurate document data extraction for seamless automation. - [Elorus](https://composio.dev/toolkits/elorus) - Elorus is an online invoicing and time-tracking software for freelancers and small businesses. Easily manage finances, bill clients, and track work in one place. - [Eodhd apis](https://composio.dev/toolkits/eodhd_apis) - Eodhd apis delivers comprehensive financial data, including live and historical stock prices, via robust APIs. Easily access reliable, up-to-date market insights to power your apps, dashboards, and analytics. - [Fidel api](https://composio.dev/toolkits/fidel_api) - Fidel api is a secure platform for linking payment cards to web and mobile apps. It enables real-time card transaction monitoring and event-based automation for businesses. - [Finage](https://composio.dev/toolkits/finage) - Finage is a secure API platform delivering real-time and historical financial data for stocks, forex, crypto, indices, and commodities. It empowers developers and businesses to access, analyze, and act on market data instantly. - [Finmei](https://composio.dev/toolkits/finmei) - Finmei is an invoicing tool that simplifies billing, invoice management, and expense tracking. Ideal for automating and organizing your business finances in one place. - [Fixer](https://composio.dev/toolkits/fixer) - Fixer is a currency data API offering real-time and historical exchange rates for 170 currencies. Instantly access accurate, up-to-date forex data for your applications and workflows. - [Fixer io](https://composio.dev/toolkits/fixer_io) - Fixer.io is a lightweight API for real-time and historical foreign exchange rates. It makes global currency conversion fast, accurate, and hassle-free. - [Flutterwave](https://composio.dev/toolkits/flutterwave) - Flutterwave is a global payments platform enabling businesses to accept and send payments across Africa and beyond. Its robust APIs simplify cross-border transactions and financial operations. ## Frequently Asked Questions ### Do I need my own developer credentials to use Alpha vantage with Composio? Yes, Alpha vantage requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you. ### Can I use multiple toolkits together? Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview). ### Is Composio secure? Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev). ### What if the API changes? Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions. --- [See all toolkits](https://composio.dev/toolkits) ยท [Composio docs](https://docs.composio.dev/llms.txt)