autogen-maxia-oracle 0.2.1

AutoGen tool wrappers for MAXIA Oracle — multi-source price feeds for AI agents. Data feed only.

autogen-maxia-oracle

AutoGen (autogen-core 0.4+) 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 autogen-maxia-oracle

Depends on maxia-oracle (the Python SDK) and autogen-core>=0.4.

Quick start

from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient

from autogen_maxia_oracle import get_all_tools

tools = get_all_tools(api_key="mxo_xxxxxxxx...")
# or rely on MAXIA_ORACLE_API_KEY env var:
# tools = get_all_tools()

model_client = OpenAIChatCompletionClient(model="gpt-4o-mini")

agent = AssistantAgent(
    name="market_data_analyst",
    model_client=model_client,
    tools=tools,
    system_message=(
        "You are a cautious market data analyst. Always report the source "
        "count and divergence when returning a price."
    ),
)

Tools

All 17 tools are FunctionTool instances, one per SDK method:

Tool name	SDK method
maxia_oracle_get_price	price(symbol)
maxia_oracle_get_prices_batch	prices_batch(symbols)
maxia_oracle_get_sources_status	sources()
maxia_oracle_get_cache_stats	cache_stats()
maxia_oracle_get_confidence	confidence(symbol)
maxia_oracle_list_supported_symbols	list_symbols()
maxia_oracle_get_chainlink_onchain	chainlink_onchain(symbol, chain)
maxia_oracle_health_check	health()
maxia_oracle_get_redstone	redstone(symbol)
maxia_oracle_get_pyth_solana	pyth_solana(symbol)
maxia_oracle_get_twap	twap(symbol, chain, window_s)
maxia_oracle_get_price_context	price_context(symbol)
maxia_oracle_get_metadata	metadata(symbol)
maxia_oracle_get_price_history	price_history(symbol, range)
maxia_oracle_create_alert	create_alert(...)
maxia_oracle_list_alerts	list_alerts()
maxia_oracle_delete_alert	delete_alert(alert_id)

Configuration

Variable	Purpose
MAXIA_ORACLE_API_KEY	The mxo_-prefixed key from POST /api/register
MAXIA_ORACLE_BASE_URL	Override backend URL (default https://oracle.maxiaworld.app)

Non-goals

Read-only data feed: no order routing, no swap, no custody, no KYC, no tokenized securities, no yield execution.

License

Apache-2.0.