langchain-pythia

LangChain integration for Pythia Oracle — on-chain calculated crypto indicators via Chainlink.

Access EMA, RSI, Bollinger Bands, Volatility, and more for 22 crypto tokens directly from your LangChain agents. Pythia is the first oracle delivering calculated technical indicators on-chain, not just prices. Includes Pythia Events (indicator alert subscriptions) and Pythia Visions (AI-calibrated market intelligence).

Installation

pip install langchain-pythia

Quick Start

from langchain_pythia import PythiaListTokensTool, PythiaTokenFeedsTool

# Use with any LangChain agent
tools = [PythiaListTokensTool(), PythiaTokenFeedsTool()]

# Or call directly
list_tool = PythiaListTokensTool()
print(list_tool.invoke(""))

feeds_tool = PythiaTokenFeedsTool()
print(feeds_tool.invoke({"engine_id": "bitcoin"}))

With a LangChain Agent

from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent
from langchain_pythia import (
    PythiaListTokensTool,
    PythiaTokenFeedsTool,
    PythiaHealthCheckTool,
    PythiaContractsTool,
    PythiaPricingTool,
    PythiaEventsInfoTool,
    PythiaSubscribeInfoTool,
    PythiaVisionsInfoTool,
    PythiaVisionHistoryTool,
)

tools = [
    PythiaListTokensTool(),
    PythiaTokenFeedsTool(),
    PythiaHealthCheckTool(),
    PythiaContractsTool(),
    PythiaPricingTool(),
    PythiaEventsInfoTool(),
    PythiaSubscribeInfoTool(),
    PythiaVisionsInfoTool(),
    PythiaVisionHistoryTool(),
]

llm = ChatOpenAI(model="gpt-4o")
agent = create_react_agent(llm, tools)

# Ask about on-chain indicators
response = agent.invoke(
    {"messages": [{"role": "user", "content": "What RSI feeds does Pythia have for Bitcoin?"}]}
)

Available Tools

What Pythia Provides

• A growing catalog of indicator feeds across multiple tokens — for the live token list and feed count, run PythiaListTokensTool or fetch feed-status.json
• Indicator types: EMA, RSI, Bollinger Bands, VWAP, Volatility, USD Price (catalog evolves; PythiaTokenFeedsTool returns the active list per token)
• Timeframes: 5-minute, 1-hour, 1-day, 1-week
• On-chain delivery via Chainlink
• Free trial via PythiaFaucet — no LINK needed
• Pythia Events: Subscribe to indicator conditions (ABOVE/BELOW thresholds), get triggered on-chain
• Pythia Visions: AI-calibrated market intelligence on-chain — walk-forward validated patterns, FREE. Live catalog via PythiaVisionsInfoTool.

Use Cases

• AI trading agents that need on-chain technical signals
• DeFi vault rebalancing based on RSI or volatility thresholds
• Risk management using Bollinger Band width
• Portfolio analysis with real-time calculated metrics

Related

• Pythia MCP Server — MCP integration for Claude, Cursor, VS Code
• Integration Examples — Solidity contracts with Hardhat
• Website & Feed Explorer

License

MIT