v0.1.0 · apache-2.0 · multi-source

Multi-source price feed
for AI agents.

A drop-in oracle for autonomous agents. Three upstreams — Pyth Hermes, Chainlink on Base, and a spot venue — aggregated and reconciled into a single call, with a divergence figure you can trust or refuse.

Six client libraries. One MCP server. Zero custody.


Six feeds. One answer. An audit trail either way.

No statistical magic, no secret weighting. The request returns every source that spoke, every age, and the divergence between them. You decide what to do with outliers.

01

Pyth Hermes

Decentralized first-party publishers. Sub-second staleness, confidence intervals built-in, wide symbol coverage including equities.

02

Chainlink on-chain

Direct reads from aggregator contracts on Base, Ethereum, and Arbitrum. What on-chain contracts see is what you see.

03

Coinpaprika

Spot market aggregator as independent price reference. If the two oracles disagree, you know it — before your agent commits.

04

RedStone

Fourth independent oracle with 400+ assets. Dynamic coverage across crypto, forex, and equities.

05

Pyth Solana on-chain

Native Solana reads from Pyth Push Oracle accounts. Fully verified on-chain data, no intermediary.

06

Uniswap v3 TWAP

Time-weighted average prices from high-liquidity Uniswap v3 pools on Base and Ethereum. DEX-native, manipulation-resistant.

Seventeen tools. Every agent framework speaks them.

The same surface is available as REST endpoints, MCP tools, and typed methods in our SDKs. Swap frameworks without teaching your agent anything new.

T.01get_priceAggregated price for one symbol across every live source.
T.02get_prices_batchUp to 50 symbols in one call. Same shape, same disclaimer.
T.03get_sources_statusWhich upstreams answered, which feeds they expose, their last heartbeat.
T.04get_cache_statsHit ratio, median age, per-source breakdown — useful in observability pipelines.
T.05get_confidenceThe divergence figure split out, for policies that reject on drift.
T.06list_supported_symbolsAll symbols currently covered — crypto majors, select equities, forex, stablecoins.
T.07get_chainlink_onchainDirect on-chain read from Base, Ethereum, or Arbitrum. Round ID, contract, age.
T.08health_checkLiveness + env. One call, no auth required.
T.09get_redstone_priceSingle-source RedStone oracle. 400+ assets including forex and equities.
T.10get_pyth_solana_onchainNative Pyth Solana on-chain read. Fully verified, no intermediary.
T.11get_twap_onchainUniswap v3 TWAP from on-chain pools on Base and Ethereum.
T.12get_price_contextConfidence score, anomaly flag, sources agreement — one call for agent decisions.
T.13get_asset_metadataMarket cap, 24h volume, supply, ATH/ATL from CoinGecko.
T.14get_price_historyHistorical price snapshots. 5-minute sampling, 30-day retention.
T.15create_price_alertOne-shot webhook alert when a price crosses a threshold.
T.16list_price_alertsList all active alerts for the authenticated key.
T.17delete_price_alertDelete an alert by ID.

Install, or wire the MCP server. Pick any surface.

Seven first-party packages covering the Python and TypeScript ecosystems that actually ship agents. Each one is a thin adapter over the same HTTP API.

maxia-oracle pypi
pip install maxia-oracle
@maxia/oracle npm
npm install @maxia/oracle
langchain-maxia-oracle pypi · langchain
pip install langchain-maxia-oracle
crewai-tools-maxia-oracle pypi · crewai
pip install crewai-tools-maxia-oracle
autogen-maxia-oracle pypi · autogen
pip install autogen-maxia-oracle
llama-index-tools-maxia-oracle pypi · llamaindex
pip install llama-index-tools-maxia-oracle
eliza-plugin-maxia-oracle npm · eliza
npm install eliza-plugin-maxia-oracle

Live in two commands.

No signup, no dashboard, no email link. Register, get a key, price something. It's that flat.

# 1. claim a free daily quota (100 req/day) — no email, no dashboard
KEY=$(curl -s -X POST https://oracle.maxiaworld.app/api/register \
  | python -c "import sys,json;print(json.load(sys.stdin)['data']['api_key'])")

# 2. ask a price
curl -s -H "X-API-Key: $KEY" https://oracle.maxiaworld.app/api/price/BTC \
  | python -m json.tool

Two ways to pay. Neither of them is a subscription.

A free tier big enough to prototype with, and a pay-per-call path on Base so your agent can settle autonomously.

Free tier
$0 / day

An API key with a 100-request daily cap. Resets at midnight UTC. No card, no onboarding.

  • 100 requests / day / key
  • Every endpoint, no feature gating
  • Issued on-demand by POST /api/register
  • Keyed by header, nothing client-side

A reference. Not a tour.

The full API contract — every route, every parameter, every response shape — rendered as a single static page.

MAXIA Oracle — API reference

Full REST surface, OpenAPI 3.1, rendered with Scalar. Built from the prod schema, served as a frozen artefact — not the live backend.

What MAXIA Oracle is, and is not Data feed only. Not investment advice. No custody. No KYC. MAXIA Oracle reads public price data from upstream oracles and spot aggregators, reconciles it, and returns it. It does not place orders. It does not hold funds. It does not route trades. It does not onboard users. Nothing in a response constitutes investment advice, a solicitation to buy or sell any asset, or a recommendation of any kind. Every integrator is solely responsible for how the returned numbers are used, by whom, and under which regulatory regime.