langchain-maxia-oracle

LangChain tool wrappers for MAXIA Oracle — multi-source crypto and equity price feeds for AI agents.

Data feed only. Not investment advice. No custody. No KYC.

Install

pip install langchain-maxia-oracle

This plugin depends on maxia-oracle (the Python SDK) and langchain-core. The SDK ships a synchronous httpx client with zero other runtime dependencies.

Quick start

Register a free API key against the hosted backend:

curl -X POST https://oracle.maxiaworld.app/api/register
# → {"data": {"api_key": "mxo_xxxxxxxx...", "daily_limit": 100}, ...}

Then wire the tools into any LangChain agent:

from langchain_openai import ChatOpenAI
from langchain.agents import AgentExecutor, create_tool_calling_agent
from langchain_core.prompts import ChatPromptTemplate

from langchain_maxia_oracle import get_all_tools

tools = get_all_tools(api_key="mxo_xxxxxxxx...")
# or rely on the MAXIA_ORACLE_API_KEY environment variable:
# tools = get_all_tools()

prompt = ChatPromptTemplate.from_messages(
    [
        ("system", "You are a market data assistant. Use the tools to answer."),
        ("user", "{input}"),
        ("placeholder", "{agent_scratchpad}"),
    ]
)

llm = ChatOpenAI(model="gpt-4o-mini")
agent = create_tool_calling_agent(llm, tools, prompt)
executor = AgentExecutor(agent=agent, tools=tools, verbose=True)

executor.invoke({"input": "What is BTC trading at right now?"})

Tools

All 17 tools mirror the MCP surface and the Python SDK methods:

Every tool returns a JSON string that includes the mandatory disclaimer field so the LLM sees the non-advice notice every time.

Configuration

The tools read configuration from the SDK, which in turn reads from its constructor arguments or from environment variables:

You can also pass a pre-built client instead of letting get_all_tools construct one:

from maxia_oracle import MaxiaOracleClient
from langchain_maxia_oracle import get_all_tools

with MaxiaOracleClient(api_key="mxo_...") as client:
    tools = get_all_tools(client=client)
    # ... use the tools ...

Non-goals

These tools are read-only:

• No order routing, no swap execution, no custody
• No KYC, no wallet creation, no signing
• No tokenized securities (xStocks, etc.)
• No yield routing or DeFi execution

MAXIA Oracle is positioned as a data feed, not a trading engine.

License

Apache-2.0 — same as the maxia-oracle SDK.