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.

Release files for autogen-maxia-oracle 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for autogen-maxia-oracle 0.2.1
File	Size	Uploaded
autogen_maxia_oracle-0.2.1.tar.gz	5.3 kB	May 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for autogen-maxia-oracle 0.2.1
File	Interpreter	ABI	Platform	Reset
autogen_maxia_oracle-0.2.1-py3-none-any.whl 6.1 kB May 17, 2026	Python 3	none	any	Details

Total release size: 11.3 kB

Release files / autogen_maxia_oracle-0.2.1.tar.gz

Download URL	autogen_maxia_oracle-0.2.1.tar.gz
Size	5.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`2340962837b19451d97e5ef804ffdc915c86ef5fa66c24270b2d8ec89deca809`
BLAKE2b-256 checksum How to use checksums	`e15a08cc8c4b9a49107fc045a2ea2aaf234c1e378a3165b5fbfa685e3910afaa`
Upload date	May 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.13`

Release files / autogen_maxia_oracle-0.2.1-py3-none-any.whl

Download URL	autogen_maxia_oracle-0.2.1-py3-none-any.whl
Size	6.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4c1a765a57d07db3d36dab5b1205d9a8cc585a5d0bf973acb136fc71cf5aa7e7`
BLAKE2b-256 checksum How to use checksums	`2d5b7c58028047e6a3c2d86806d584a1a5fd2784b8c6164d4fe4b971417013fd`
Upload date	May 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.13`