llama-index-tools-maxia-oracle
LlamaIndex (llama-index-core 0.11+) 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 llama-index-tools-maxia-oracle
Depends on maxia-oracle
(the Python SDK) and llama-index-core>=0.11.
Quick start
from llama_index.llms.openai import OpenAI
from llama_index.core.agent import ReActAgent
from llama_index_tools_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()
llm = OpenAI(model="gpt-4o-mini")
agent = ReActAgent.from_tools(tools, llm=llm, verbose=True)
agent.chat("What is BTC trading at right now?")
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.
1 maintainer
Release files for llama-index-tools-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)
| File | Size | Uploaded | |
|---|---|---|---|
| llama_index_tools_maxia_oracle-0.2.1.tar.gz | 5.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| llama_index_tools_maxia_oracle-0.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.3 kB
Release files / llama_index_tools_maxia_oracle-0.2.1.tar.gz
| Download URL | llama_index_tools_maxia_oracle-0.2.1.tar.gz |
|---|---|
| Size | 5.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1baf23415b16d655e440f51de23f6defe6cd76b097fb044ca57941ccc59f137b
|
|
BLAKE2b-256 checksum How to use checksums |
1327f70811de86d70050e6b47ed0549482b12a3fd1de12868cdc4eb8ba4abb0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.13
|
Release files / llama_index_tools_maxia_oracle-0.2.1-py3-none-any.whl
| Download URL | llama_index_tools_maxia_oracle-0.2.1-py3-none-any.whl |
|---|---|
| Size | 6.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
61c40ee61eabd55caed1b036545d894ae7b90114fe5d4901c52c5490c09c4e76
|
|
BLAKE2b-256 checksum How to use checksums |
1b61ef38b02407e2f9e5a66e4087c23be3f8281416d1fee9075081626c4f3eda
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.13
|
