Docs / Reference / Endpoints & Pairs

Endpoints & Pairs

176 endpoints across four layers — Layer 1 Oracle Data (raw prices, indices, derivatives, DeFi, compute, gas, marine, weather, history), Layer 2 Oracle Information (market synopsis, perp regime, crypto indices, equity indices, TradFi regime, liquidity regime), and Layer 3 Oracle Intelligence (macro risk, perp setup, DeFi opportunity, regime change, divergence, consensus, persistence).

Base URL: https://api.myceliasignal.com

All paid endpoints are available on both L402 (Lightning) and x402 (USDC on Base). Append /preview to any paid endpoint for unsigned sample data at no cost.

Legacy paths

Old paths such as /oracle/btcusd redirect 301 permanently to the new namespace. Update integrations to use /oracle/price/btc/usd style paths.

Crypto Pairs

15 pairs — spot prices and VWAP across BTC, ETH, SOL, XRP, ADA, and DOGE. Multi-exchange median aggregation. secp256k1 ECDSA signed (L402) or Ed25519 signed (x402).

EndpointPairSourcesMethodL402x402
/oracle/price/btc/usdBTC/USD9Median10 sats$0.01
/oracle/price/btc/usd/vwapBTC/USD VWAP9VWAP20 sats$0.02
/oracle/price/btc/eurBTC/EUR9Median10 sats$0.01
/oracle/price/btc/eur/vwapBTC/EUR VWAP9VWAP20 sats$0.02
/oracle/price/btc/jpyBTC/JPY4Median10 sats$0.01
/oracle/price/eth/usdETH/USD9Median10 sats$0.01
/oracle/price/eth/usd/vwapETH/USD VWAP5VWAP20 sats$0.02
/oracle/price/eth/eurETH/EUR4Hybrid median10 sats$0.01
/oracle/price/eth/jpyETH/JPY4Cross-rate10 sats$0.01
/oracle/price/sol/usdSOL/USD9Median10 sats$0.01
/oracle/price/sol/eurSOL/EUR4Hybrid median10 sats$0.01
/oracle/price/sol/jpySOL/JPY2Median10 sats$0.01
/oracle/price/xrp/usdXRP/USD6Median10 sats$0.01
/oracle/price/ada/usdADA/USD6Median10 sats$0.01
/oracle/price/doge/usdDOGE/USD6Median10 sats$0.01

Stablecoin Pegs

4 stablecoin peg attestations — USDT and USDC against major currencies. 5-decimal precision for depeg detection. Multi-source median aggregation.

EndpointPairSourcesMethodL402x402
/oracle/price/usdt/usdUSDT/USD4Median10 sats$0.01
/oracle/price/usdc/usdUSDC/USD4Median10 sats$0.01
/oracle/price/usdt/eurUSDT/EUR9Cross-rate10 sats$0.01
/oracle/price/usdt/jpyUSDT/JPY7Cross-rate10 sats$0.01

Market Indices

5 signed composite index endpoints — volatility (MSVI), sentiment (MSXI), stress (MSSI), and contagion (MSTI). These are Layer 2 Oracle Information products — computed composites, not raw measurements. All Deribit-derived, Ed25519 signed, with component weights in canonical string for independent reconstruction. Full methodology at Market Indices docs.

EndpointIndexRangeComponentsL402x402
/oracle/volatility/btc/usdBTC MSVI — Volatility0–100RV, IV, Term Structure, Funding, PCR500 sats$0.05
/oracle/volatility/eth/usdETH MSVI — Volatility0–100RV, IV, Term Structure, Funding, PCR500 sats$0.05
/oracle/sentiment/btc/usdBTC MSXI — Sentiment−100 to +100Funding direction, 25D Skew, PCR, Term Structure slope, Basis500 sats$0.05
/oracle/sentiment/eth/usdETH MSXI — Sentiment−100 to +100Funding direction, 25D Skew, PCR, Term Structure slope, Basis500 sats$0.05
/oracle/stress/marketMSSI — Systemic Stress0–100Vol regime, Stablecoin peg deviation, Funding extremity500 sats$0.05
/oracle/contagion/marketMSTI — Crypto-TradFi Contagion0–100Equity vol, DXY, Credit spreads, Beta correlation500 sats$0.05

FX Pairs

20 currency pairs — major and cross rates sourced from central banks (ECB, Frankfurter, Bank of Canada, Norges Bank, RBA) and exchanges.

EndpointPairL402x402
/oracle/price/eur/usdEUR/USD10 sats$0.01
/oracle/price/eur/jpyEUR/JPY10 sats$0.01
/oracle/price/eur/gbpEUR/GBP10 sats$0.01
/oracle/price/eur/chfEUR/CHF10 sats$0.01
/oracle/price/eur/cnyEUR/CNY10 sats$0.01
/oracle/price/eur/cadEUR/CAD10 sats$0.01
/oracle/price/gbp/usdGBP/USD10 sats$0.01
/oracle/price/gbp/jpyGBP/JPY10 sats$0.01
/oracle/price/gbp/chfGBP/CHF10 sats$0.01
/oracle/price/gbp/cnyGBP/CNY10 sats$0.01
/oracle/price/gbp/cadGBP/CAD10 sats$0.01
/oracle/price/usd/jpyUSD/JPY10 sats$0.01
/oracle/price/usd/chfUSD/CHF10 sats$0.01
/oracle/price/usd/cnyUSD/CNY10 sats$0.01
/oracle/price/usd/cadUSD/CAD10 sats$0.01
/oracle/price/chf/jpyCHF/JPY10 sats$0.01
/oracle/price/chf/cadCHF/CAD10 sats$0.01
/oracle/price/cny/jpyCNY/JPY10 sats$0.01
/oracle/price/cny/cadCNY/CAD10 sats$0.01
/oracle/price/cad/jpyCAD/JPY10 sats$0.01

Economic Indicators

14 macro indicators — US (BLS/FRED) and Euro Area (Eurostat). Signed canonical string includes period, vintage date, source agency, and series ID.

EndpointDescriptionSourceCadenceL402x402
/oracle/econ/us/cpiUS CPI HeadlineBLSMonthly1000 sats$0.10
/oracle/econ/us/cpi_coreUS CPI Core (ex food & energy)BLSMonthly1000 sats$0.10
/oracle/econ/us/unrateUS Unemployment RateBLSMonthly1000 sats$0.10
/oracle/econ/us/fedfundsFed Funds RateFREDPer-decision1000 sats$0.10
/oracle/econ/us/nfpNonfarm PayrollsBLSMonthly1000 sats$0.10
/oracle/econ/us/gdpUS Real GDPFRED/BEAQuarterly1000 sats$0.10
/oracle/econ/us/pcePCE Price IndexFRED/BEAMonthly1000 sats$0.10
/oracle/econ/us/yield_curve10Y–2Y Yield SpreadFREDDaily1000 sats$0.10
/oracle/econ/eu/hicpEU HICP HeadlineEurostatMonthly1000 sats$0.10
/oracle/econ/eu/hicp_coreEU HICP CoreEurostatMonthly1000 sats$0.10
/oracle/econ/eu/hicp_servicesEU HICP ServicesEurostatMonthly1000 sats$0.10
/oracle/econ/eu/unrateEU Unemployment RateEurostatMonthly1000 sats$0.10
/oracle/econ/eu/gdpEU Real GDPEurostatQuarterly1000 sats$0.10
/oracle/econ/eu/employmentEU Total EmploymentEurostatQuarterly1000 sats$0.10

Commodities

8 commodity benchmarks — precious metals, energy, and dollar index. Gold sourced from multi-exchange median; energy and base metals from EIA and Federal Reserve via FRED.

EndpointDescriptionSourceCadenceL402x402
/oracle/price/xau/usdGold/USD spot8 exchanges + dealersReal-time10 sats$0.01
/oracle/price/xau/eurGold/EUR cross-rateCombinedReal-time10 sats$0.01
/oracle/price/xau/jpyGold/JPY cross-rateCombinedReal-time10 sats$0.01
/oracle/econ/commodities/wtiWTI Crude OilEIA/FREDWeekly1000 sats$0.10
/oracle/econ/commodities/brentBrent Crude OilEIA/FREDWeekly1000 sats$0.10
/oracle/econ/commodities/natgasHenry Hub Natural GasEIA/FREDWeekly1000 sats$0.10
/oracle/econ/commodities/copperCopper spotFREDMonthly1000 sats$0.10
/oracle/econ/commodities/dxyUS Dollar IndexFed/FREDDaily1000 sats$0.10

Gas Oracle

Real-time gas prices for 6 chains plus a cross-chain index. Direct RPC queries to public endpoints, median aggregation across multiple providers.

EndpointDescriptionSourceCadenceL402x402
/oracle/gas/ethereumEthereum mainnet gas price3+ RPCsReal-time10 sats$0.01
/oracle/gas/baseBase L2 gas price3+ RPCsReal-time10 sats$0.01
/oracle/gas/arbitrumArbitrum L2 gas price3+ RPCsReal-time10 sats$0.01
/oracle/gas/polygonPolygon gas price3+ RPCsReal-time10 sats$0.01
/oracle/gas/optimismOptimism L2 gas price3+ RPCsReal-time10 sats$0.01
/oracle/gas/solanaSolana transaction cost3+ RPCsReal-time10 sats$0.01
/oracle/gas/indexCross-chain gas index — 6 chains rankedAll chainsReal-time50 sats$0.05

Marine Oracle

Real-time maritime data — sea state conditions, vessel tracking, route planning, and voyage forecasts at any global coordinates.

EndpointDescriptionSourceCadenceL402x402
/oracle/marine/{lat}/{lon}/seastateSea state at coordinatesMaritime APIsReal-time133 sats$0.10
/oracle/marine/vessel/{mmsi}Vessel position + sea stateAIS + maritimeReal-time667 sats$0.50
/oracle/marine/route/summaryRoute sea state summaryMaritime APIsReal-time267 sats$0.20
/oracle/marine/voyage/forecastVoyage forecast with weather windowsMaritime + weatherReal-time667 sats$0.50

Weather Oracle

Global weather data at any coordinates with configurable time windows. Agricultural water stress, rainfall, temperature, and wind speed.

EndpointDescriptionSourceCadenceL402x402
/oracle/weather/{lat}/{lon}/wrsi/{window}dWater Requirement Satisfaction IndexWeather APIsDaily100 sats$0.10
/oracle/weather/{lat}/{lon}/rainfall/{window}dRainfall accumulationWeather APIsDaily100 sats$0.10
/oracle/weather/{lat}/{lon}/temperature/{window}dTemperature historyWeather APIsDaily100 sats$0.10
/oracle/weather/{lat}/{lon}/wind/{window}dWind speed historyWeather APIsDaily100 sats$0.10

COT Positioning

CFTC Commitments of Traders data for BTC CME futures. Institutional positioning breakdown with leveraged fund and asset manager net positions.

EndpointDescriptionSourceCadenceL402x402
/oracle/cot/btcBTC CME COT positioningCFTCWeekly (Friday)1000 sats$1.00

Free Endpoints

EndpointDescription
/healthProxy health check
/sho/infox402 protocol info — public key, payment address, endpoint pricing
/sho/enforcement/{address}Check enforcement status for a Base wallet address
/.well-known/x402x402 discovery document — all 176 endpoints with payment terms
/oracle/price/{base}/{quote}/previewUnsigned preview data — any price pair, up to 5 minutes stale
/oracle/econ/{region}/{indicator}/previewUnsigned preview data — any econ indicator
/oracle/volatility/{pair}/previewUnsigned preview data — MSVI volatility index
/oracle/sentiment/{pair}/previewUnsigned preview data — MSXI sentiment index
/oracle/stress/market/previewUnsigned preview data — MSSI stress index
/dlc/oracle/pubkeyDLC oracle Schnorr public key (BIP-340, secp256k1)
/dlc/oracle/statusDLC oracle status
/oracle/gas/{chain}/previewUnsigned preview data — gas price per chain
/oracle/gas/index/previewUnsigned preview data — cross-chain gas index
/oracle/gas/catalogueGas oracle catalogue — supported chains and metadata
/oracle/econ/commodities/catalogueCommodities catalogue — available indicators

Response Timing

Endpoint TypeExpected LatencyNotes
Direct spot pairs1–2 secondsParallel source fetching
Cross-rate pairs3–5 secondsFetches component feeds before computing cross-rate
Market indices (MSVI, MSXI, MSSI)3–5 secondsLive computation from Deribit options + perpetuals data
Economic indicators<1 secondServed from local DB, updated on release cadence
Commodities<1 secondServed from local DB, updated weekly/daily
Timeout configuration

Set your HTTP client timeout to at least 15 seconds for cross-rate pairs. These endpoints fetch two or more component feeds before computing the final rate.

← MCP Server Response Schema →

Derivatives

Funding rates, open interest, basis, orderbook depth, implied volatility, liquidation flow, and term structure for BTC, ETH, and SOL. See Derivatives docs for full details.

EndpointDescriptionx402
/oracle/funding/btc/usdBTC composite funding rate — 10 exchanges, regime classification$0.05
/oracle/funding/eth/usdETH composite funding rate$0.05
/oracle/funding/sol/usdSOL composite funding rate$0.05
/oracle/oi/btc/usdBTC open interest — cross-exchange deltas (1h, 4h, 24h)$0.02
/oracle/oi/eth/usdETH open interest deltas$0.02
/oracle/oi/sol/usdSOL open interest deltas$0.02
/oracle/basis/btc/usdBTC futures basis — CONTANGO/BACKWARDATION regime$0.02
/oracle/basis/eth/usdETH futures basis$0.02
/oracle/basis/sol/usdSOL futures basis$0.02
/oracle/orderbook/btc/usdBTC cross-exchange orderbook depth imbalance$0.05
/oracle/orderbook/eth/usdETH cross-exchange orderbook depth imbalance$0.05
/oracle/iv/btc/usdBTC implied volatility — ATM IV, skew, SVI parameters$0.05
/oracle/iv/eth/usdETH implied volatility$0.05
/oracle/liq-flow/btcBTC liquidation flow — dominant side, imbalance, notional (1h/4h/24h)$0.05
/oracle/liq-flow/ethETH liquidation flow$0.05
/oracle/liq-flow/solSOL liquidation flow$0.05
/oracle/term-structure/btc/usdBTC futures term structure$0.05
/oracle/term-structure/eth/usdETH futures term structure$0.05

DeFi Yield & Metrics

Supply/borrow APR and protocol metrics across 15+ protocols. See DeFi docs for full details.

EndpointDescriptionx402
/oracle/defi/yield/allAll yield rates — 15+ protocols, Base/Ethereum/Arbitrum$0.05
/oracle/defi/yield/best/usdcBest USDC supply APR right now$0.05
/oracle/defi/yield/compareProtocol comparison — supply APR, borrow APR, utilization$0.05
/oracle/defi/metricsProtocol metrics — TVL, utilization, chain breakdown$0.05

Compute & Inference

GPU compute and LLM inference pricing. See Compute docs for full details.

EndpointDescriptionx402
/oracle/compute/allAll GPU instances — H100, A100, A10G across providers$0.05
/oracle/compute/best/h100_sxmCheapest H100 SXM right now$0.02
/oracle/compute/compareGPU price comparison across providers$0.05
/oracle/inference/allLLM inference costs — GPT-4o, Claude, Gemini, Llama$0.02
/oracle/inference/best/codingBest price-performance model for coding$0.02
/oracle/inference/compareModel pricing comparison$0.02

Econ Calendar

High-impact macro events, surprise index, options expiry. See Econ Calendar docs for full details.

EndpointDescriptionx402
/oracle/econ/calendar/todayToday's high-impact macro events with times and forecasts$0.05
/oracle/econ/surprisesMacro surprise index — last 20 releases, actual vs estimate$0.10
/oracle/econ/expiry/btcBTC options expiry dates — next 8 Deribit expiries$0.05
/oracle/econ/expiry/ethETH options expiry dates$0.05

Signed History

Per-row original Ed25519 signatures on all historical data. See Signed History docs for full details.

EndpointDescriptionx402
/oracle/history/spot/btcBTC spot OHLCV history with per-row original signatures$0.05
/oracle/history/spot/ethETH spot history$0.05
/oracle/history/funding/btcBTC funding rate history — 10 exchanges, per-row signatures$0.10
/oracle/history/funding/ethETH funding rate history$0.10
/oracle/history/funding/solSOL funding rate history$0.10
/oracle/history/index/msxiMSXI sentiment index history — 56+ days, per-row signatures$0.10
/oracle/history/index/msviMSVI volatility index history$0.10
/oracle/history/index/mssiMSSI stress index history$0.10
/oracle/history/index/mstiMSTI contagion index history$0.10

Layer 2 — Oracle Information

Single-call aggregated signals. One payment, one signature over a multi-signal snapshot. See Layer 2 Oracle Information docs.

EndpointDescriptionx402Cache
/oracle/synopsis/market15-signal market state snapshot — all 4 indices, funding, OI, liq flow, price, VWAP, basis, econ calendar$0.2560s
/oracle/perp/btcBTC perp regime — 10-signal classification with signal alignment, confidence, risk$0.1530s
/oracle/perp/ethETH perp regime$0.1530s
/oracle/perp/solSOL perp regime$0.1530s
/oracle/volatility/btc/usdMSVI — BTC volatility composite 0–100 (RV, IV, term structure, funding, PCR)$0.0560s
/oracle/volatility/eth/usdMSVI — ETH volatility composite 0–100$0.0560s
/oracle/sentiment/btc/usdMSXI — BTC sentiment composite −100 to +100 (funding, skew, PCR, term structure, basis)$0.0560s
/oracle/sentiment/eth/usdMSXI — ETH sentiment composite −100 to +100$0.0560s
/oracle/stress/marketMSSI — market stress composite 0–100 (vol, stablecoin peg, funding extremity, dispersion)$0.0560s
/oracle/contagion/marketMSTI — crypto-TradFi contagion 0–100. Regimes: DECOUPLED / MIXED / COUPLED / CONTAGION$0.0560s
/oracle/stress/equityMESI — equity stress composite 0–100 (VIX, credit spreads, yield curve, STLFSI4, DXY)$0.05300s
/oracle/volatility/nq/usdMNVI — NQ volatility composite 0–100 (RV, IV, term structure, skew, PCR)$0.05114s
/oracle/regime/equityTradFi Regime — RISK_ON / NEUTRAL / STRESS / PANIC from MESI + MNVI + yield curve$0.10300s
/oracle/regime/liquidityLiquidity Regime — DEEP / NORMAL / THIN / FRAGILE from funding, OI, basis, liq flow, orderbook$0.1060s

Layer 3 — Oracle Intelligence

Cross-domain pattern recognition. Every response includes a disclaimer field — regime classifications, not financial advice. See Oracle Intelligence docs.

EndpointDescriptionx402Cache
/oracle/intel/macro/riskCross-domain macro risk score 0–100 — MSSI + MSTI + econ calendar. Regimes: LOW / MODERATE / ELEVATED / HIGH / CRITICAL.$1.0060s
/oracle/intel/perp/setupScans BTC, ETH, SOL simultaneously — highest-confidence setup with signal alignment, edge, invalidation conditions$1.0030s
/oracle/intel/defi/opportunityRisk-adjusted DeFi yield — stress + contagion penalized APR ranking across 15+ protocols$0.7560s
/oracle/intel/regime/changeBTC/ETH/SOL perp regime transitions vs 2 hours ago — from_regime, to_regime, bias_changed$0.5030s
/oracle/intel/divergenceCross-asset divergence — NONE / LOW / MODERATE / HIGH / EXTREME with score, direction, contagion flag$0.5060s
/oracle/intel/consensusWeighted regime consensus across all signals — STRONG / MODERATE / WEAK / CONFLICTED with per-signal votes$0.5060s
/oracle/intel/regime/persistenceCurrent regime duration, historical_percentile, typical_remaining_hours. ?currency=BTC/ETH/SOL$0.1530s