langchain-pythia 0.3.0

LangChain integration for Pythia Oracle — on-chain calculated crypto indicators (EMA, RSI, Bollinger, Volatility) via Chainlink

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

Tool	Description
PythiaListTokensTool	List all 22 tracked tokens with status, uptime, and data sources
PythiaTokenFeedsTool	Get all indicator feed names (EMA, RSI, Bollinger, Volatility) for a token
PythiaHealthCheckTool	Per-token 30-day uptime, data source health, incident report
PythiaContractsTool	Contract addresses (operator, consumers, faucet, LINK) for on-chain integration
PythiaPricingTool	Pricing tiers and free trial faucet info
PythiaEventsInfoTool	Pythia Events overview — indicator alert subscriptions
PythiaSubscribeInfoTool	Plan a specific event subscription with cost and exact calls
PythiaVisionsInfoTool	Pythia Visions overview — 6 backtested patterns, accuracy, integration guide
PythiaVisionHistoryTool	Recent Visions fired for a token with pattern breakdown

What Pythia Provides

• 484 indicator feeds across 22 tokens (BTC, SOL, TAO, RENDER, ONDO, AAVE, UNI, and more)
• 5 indicator types: EMA, RSI, Bollinger (upper/lower), Volatility, USD Price
• 4 timeframes: 5-minute, 1-hour, 1-day, 1-week
• On-chain delivery via Chainlink on Polygon
• Free trial via PythiaFaucet — no LINK needed, 5 requests/day
• Pythia Events: Subscribe to indicator conditions (ABOVE/BELOW thresholds), get triggered on-chain
• Pythia Visions: AI-calibrated market intelligence — 6 backtested patterns with 74-89% accuracy, FREE

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