langchain-twelvedata

LangChain tools for Twelve Data market data. The toolkit makes four read-only REST endpoints available to an agent: quote, historical time series, symbol search, and Relative Strength Index (RSI).

Install

pip install langchain-twelvedata

Tools

• twelvedata_quote — symbol
• twelvedata_time_series — symbol, interval, outputsize
• twelvedata_symbol_search — query (company name or partial ticker, not symbol)
• twelvedata_rsi — symbol, interval, time_period

Each tool returns a JSON string with the Twelve Data response.

Quick start

Set a Twelve Data API key in your environment:

export TWELVE_DATA_API_KEY="your-api-key"

Invoke a tool directly:

import json

from langchain_twelvedata import TwelveDataToolkit

tools = TwelveDataToolkit().get_tools()
quote = next(tool for tool in tools if tool.name == "twelvedata_quote")
data = json.loads(quote.invoke({"symbol": "AAPL"}))
print(data["close"])

Pass the same tools list to a LangChain agent or a tool-calling model:

history = next(tool for tool in tools if tool.name == "twelvedata_time_series")
print(history.invoke({"symbol": "AAPL", "interval": "1day", "outputsize": 5}))

search = next(tool for tool in tools if tool.name == "twelvedata_symbol_search")
print(search.invoke({"query": "Apple"}))

The API key can also be passed explicitly with TwelveDataToolkit(TwelveDataClient(api_key="...")) after importing TwelveDataClient from langchain_twelvedata. Twelve Data API errors and HTTP errors are raised to the caller.

Development

git clone https://github.com/MazeBraker/langchain-twelvedata.git
cd langchain-twelvedata
pip install -e '.[test]'
pytest

License

MIT