Metadata-Version: 2.4
Name: openai-agents-maxia-oracle
Version: 0.1.0
Summary: OpenAI Agents SDK tools for MAXIA Oracle — multi-source crypto price feeds.
Project-URL: Homepage, https://oracle.maxiaworld.app
Project-URL: Repository, https://github.com/maxiaworld/oracleforge
Author-email: MAXIA <ceo@maxiaworld.app>
License: Apache-2.0
Keywords: agents,ai-agents,chainlink,crypto,openai,oracle,price-feed,pyth
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: openai-agents>=0.10.0
Description-Content-Type: text/markdown

# openai-agents-maxia-oracle

OpenAI Agents SDK tools for [MAXIA Oracle](https://oracle.maxiaworld.app) — multi-source crypto price feeds for AI agents.

## Install

```bash
pip install openai-agents-maxia-oracle
```

## Usage

```python
import os
from agents import Agent, Runner
from openai_agents_maxia_oracle import get_price, get_price_context, get_batch_prices

os.environ["MAXIA_API_KEY"] = "mxo_..."  # or set in env

agent = Agent(
    name="crypto-assistant",
    instructions="Use MAXIA Oracle to answer price questions accurately.",
    tools=[get_price, get_price_context, get_batch_prices],
)

result = Runner.run_sync(agent, "What is ETH trading at right now?")
print(result.final_output)
```

Get a free API key (100 req/day, no email): [oracle.maxiaworld.app](https://oracle.maxiaworld.app)

## Tools

| Tool | Description |
|---|---|
| `get_price` | Multi-source median price (8 sources: Pyth, Chainlink, RedStone, Binance, Kraken…) |
| `get_price_context` | Price + confidence score + anomaly flag |
| `get_batch_prices` | Prices for up to 50 symbols in one request |

## License

Apache-2.0
