Alpha vantage | Composio Docs

Overview

SLUG: ALPHA_VANTAGE

Description

Alpha Vantage provides free APIs for real-time and historical financial data, including stock time series, technical indicators, and more.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Alpha vantage

Create an auth config

Use the dashboard to create an auth config for the Alpha vantage toolkit. This allows you to connect multiple Alpha vantage accounts to Composio for agents to use.

Select App

Navigate to [Alpha vantage](https://platform.composio.dev?next_page=/marketplace/Alpha vantage).

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Alpha vantage Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 alpha_vantage_auth_config_id = "ac_YOUR_ALPHA_VANTAGE_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Alpha vantage for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, alpha_vantage_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Alpha vantage toolkit’s playground](https://app.composio.dev/app/Alpha vantage)

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["ALPHA_VANTAGE"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

ALPHA_VANTAGE_ALL_COMMODITIES

Tool Name: Get All Commodities Price Index

Description

Tool to retrieve the global price index of all commodities. Use when you need monthly, quarterly, or annual aggregated price index data for commodities.

Action Parameters

datatype

stringDefaults to json

interval

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_ALUMINUM

Tool Name: ALUMINUM

Description

Tool to fetch global aluminum prices. Use when you need monthly, quarterly, or annual LME aluminum price data.

Action Parameters

datatype

stringDefaults to json

interval

stringDefaults to monthly

Action Response

Data

objectRequired

Meta Data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_BALANCE_SHEET

Tool Name: Balance Sheet

Description

Tool to return annual and quarterly balance sheets for a company. Use when you need detailed fiscal statements for analysis.

Action Parameters

symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_BRENT

Tool Name: Brent Crude Oil Prices

Description

Tool to fetch Brent crude oil prices. Use when you need daily, weekly, or monthly Brent price data.

Action Parameters

datatype

stringDefaults to json

interval

stringDefaults to monthly

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_CASH_FLOW

Tool Name: Cash Flow

Description

Tool to return annual and quarterly cash flow statements for a company. Use when you need to analyze cash movements.

Action Parameters

symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_COFFEE

Tool Name: Global Coffee Price

Description

Tool to retrieve the global coffee price series. Use when you need historical monthly, quarterly, or annual coffee prices.

Action Parameters

datatype

stringDefaults to json

interval

stringDefaults to monthly

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_COMPANY_OVERVIEW

Tool Name: Company Overview

Description

Tool to retrieve company overview and fundamental data for a given symbol. Use after specifying a valid ticker symbol.

Action Parameters

apikey

string

symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_COPPER

Tool Name: COPPER

Description

Tool to fetch global price of copper in monthly, quarterly, and annual intervals. Use when you need historical copper price series for analysis.

Action Parameters

datatype

stringDefaults to json

interval

stringDefaults to monthly

Action Response

Data

objectRequired

Meta Data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_CORN

Tool Name: Corn

Description

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.

Action Parameters

datatype

stringDefaults to json

interval

stringDefaults to monthly

Action Response

data

arrayRequired

error

string

interval

stringRequired

name

stringRequired

successful

booleanRequired

unit

stringRequired

ALPHA_VANTAGE_COTTON

Tool Name: COTTON

Description

Tool to retrieve global cotton prices in monthly, quarterly, and annual intervals. Use when you need historical cotton price data.

Action Parameters

datatype

stringDefaults to json

interval

stringDefaults to monthly

Action Response

data

arrayRequired

error

string

interval

stringRequired

name

stringRequired

successful

booleanRequired

unit

stringRequired

ALPHA_VANTAGE_CURRENCY_EXCHANGE_RATE

Tool Name: Currency Exchange Rate

Description

Tool to retrieve real-time exchange rate for a currency pair. Use after confirming base and quote currency codes to get current rates.

Action Parameters

apikey

string

from_currency

stringRequired

to_currency

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_DIGITAL_CURRENCY_MONTHLY

Tool Name: Digital Currency Monthly Time Series

Description

Tool to retrieve monthly digital currency prices in a fiat currency. Use when needing long-term monthly OHLC and volume data for a given crypto/fiat pair.

Action Parameters

apikey

string

datatype

stringDefaults to json

market

stringRequired

symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_EARNINGS

Tool Name: Earnings

Description

Tool to retrieve annual and quarterly earnings. Use when you need EPS history for a specific company symbol.

Action Parameters

apikey

string

symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_EARNINGS_CALENDAR

Tool Name: Earnings Calendar

Description

Tool to return the earnings calendar for the next three months. Use when you need a schedule of upcoming earnings across symbols.

Action Parameters

horizon

stringDefaults to 3month

symbol

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_EARNINGS_CALL_TRANSCRIPT

Tool Name: Earnings Call Transcript

Description

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.

Action Parameters

quarter

stringRequired

symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_FX_DAILY

Tool Name: FX Daily Time Series

Description

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.

Action Parameters

datatype

stringDefaults to json

from_symbol

stringRequired

outputsize

stringDefaults to compact

to_symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_FX_MONTHLY

Tool Name: FX Monthly Time Series

Description

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.

Action Parameters

datatype

stringDefaults to json

from_symbol

stringRequired

to_symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_FX_WEEKLY

Tool Name: FX Weekly Time Series

Description

Tool to get weekly time series (open, high, low, close) for a currency pair. Use when you need weekly FX rates.

Action Parameters

datatype

stringDefaults to json

from_symbol

stringRequired

to_symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_INCOME_STATEMENT

Tool Name: Income Statement

Description

Tool to fetch annual and quarterly income statements. Use after confirming the company symbol.

Action Parameters

symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_IPO_CALENDAR

Tool Name: IPO Calendar

Description

Tool to retrieve the IPO calendar for the next three months. Use when you need a list of upcoming IPO events across markets.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_LISTING_STATUS

Tool Name: Listing Status

Description

Tool to fetch listing status of US stocks and ETFs. Use when you need active or delisted securities as of a date.

Action Parameters

date

string

state

stringDefaults to active

Action Response

data

arrayRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_NEWS_SENTIMENT

Tool Name: News Sentiment

Description

Tool to fetch live and historical market news & sentiment. Use when you need curated news articles with sentiment scores for specified tickers and topics.

Action Parameters

limit

integerDefaults to 50

sort

stringDefaults to LATEST

tickers

string

time_from

string

time_to

string

topics

array

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_REAL_GDP

Tool Name: Real GDP

Description

Tool to fetch U.S. real GDP time series. Use when you need quarterly or annual GDP data.

Action Parameters

apikey

string

datatype

stringDefaults to json

interval

stringDefaults to annual

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_SECTOR

Tool Name: Sector Performance

Description

Tool to retrieve real-time and historical sector performance data. Use when you need sector performance metrics across timeframes.

Action Parameters

apikey

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_SPLITS

Tool Name: Stock Splits

Description

Tool to retrieve historical stock split events for a symbol. Use when you need past split dates and ratio details before analyzing corporate actions.

Action Parameters

symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_SUGAR

Tool Name: Global Sugar Price

Description

Tool to retrieve the global sugar price series. Use when you need historical monthly, quarterly, or annual sugar prices.

Action Parameters

datatype

stringDefaults to json

interval

stringDefaults to monthly

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_SYMBOL_SEARCH

Tool Name: Symbol Search

Description

Tool to search for best-matching symbols based on keywords. Use when you need to find ticker symbols by a name or keyword.

Action Parameters

apikey

string

datatype

stringDefaults to json

keywords

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_TECHNICAL_INDICATOR

Tool Name: Technical Indicator

Description

Tool to fetch technical indicators for the specified equity or currency pair. Use after obtaining time series to compute moving averages or oscillators.

Action Parameters

datatype

stringDefaults to json

function

stringRequired

interval

stringRequired

month

string

series_type

stringRequired

symbol

stringRequired

time_period

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_TIME_SERIES_INTRADAY

Tool Name: Time Series Intraday

Description

Tool to retrieve intraday OHLCV for a given equity. Use when you need high-frequency pricing data within the trading day.

Action Parameters

adjusted

stringDefaults to true

datatype

stringDefaults to json

extended_hours

stringDefaults to true

interval

stringRequired

month

string

outputsize

stringDefaults to compact

symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_TIME_SERIES_MONTHLY

Tool Name: Time Series Monthly

Description

Tool to retrieve monthly open, high, low, close, and volume for a global equity. Use when you need month-end OHLCV data for a specific stock symbol.

Action Parameters

apikey

string

datatype

stringDefaults to json

symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_TIME_SERIES_MONTHLY_ADJUSTED

Tool Name: Monthly Adjusted Time Series

Description

Tool to retrieve monthly adjusted OHLC and volume for a global equity. Use after confirming the ticker symbol when you need end-of-month adjusted price and dividend data.

Action Parameters

apikey

string

datatype

stringDefaults to json

symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_TIME_SERIES_WEEKLY

Tool Name: Weekly Time Series

Description

Tool to fetch weekly open, high, low, close, and volume for a global equity symbol. Use after confirming the target symbol to obtain its historical weekly OHLCV series.

Action Parameters

apikey

string

datatype

stringDefaults to json

symbol

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

ALPHA_VANTAGE_WHEAT

Tool Name: WHEAT

Description

Tool to fetch global price of wheat. Use when you need historical wheat prices in monthly, quarterly, or annual intervals.

Action Parameters

datatype

stringDefaults to json

interval

stringDefaults to monthly

Action Response

Data

objectRequired

Meta Data

objectRequired

error

string

successful

booleanRequired