Mycelia Signal Documentation

176 endpoints across four layers. Every response cryptographically signed. Two payment rails. No API keys.

Quick Start

Get your first signed attestation with a single curl command. Includes both x402 and L402 examples.

Agent Payment Setup

Configure x402 (USDC) or L402 (Lightning) payment for your AI agent. Step-by-step for LangChain, MCP, and generic HTTP clients.

Guide

Signature Verification

Verify Ed25519 and secp256k1 attestations in Python, JavaScript, and Rust. Reconstruct the canonical payload and validate the proof.

Layer 1 — Oracle Data

Raw signed measurements. Every endpoint returns a canonical attestation with value, sources, timestamp, and Ed25519 signature.

Reference

All Endpoints

Complete list of 176 paid endpoints — crypto, FX, stablecoin, commodities, derivatives, DeFi, compute, gas, marine, weather, history. URLs, pricing, source counts.

Guide

Derivatives

Funding rates, open interest, basis, orderbook depth, implied volatility, liquidation flow, and term structure across BTC, ETH, and SOL.

Guide

DeFi Yield & Metrics

Supply and borrow APR across 15+ protocols on Base, Ethereum, and Arbitrum. TVL, utilization, and protocol health metrics.

Guide

Compute & Inference

GPU compute pricing (H100, A100, A10G) across cloud providers. LLM inference costs for GPT-4o, Claude, Gemini, Llama — input/output per million tokens.

Guide

Econ Calendar

High-impact macro events, economic surprises, options expiry proximity. Essential context for regime-aware agents.

Guide

COT Positioning

BTC CME Commitments of Traders data. Institutional net long/short ratios from CFTC filings. Weekly signed attestation.

Guide

Gas Oracle

Cross-chain gas prices for Ethereum, Base, Arbitrum, Polygon, Optimism, and Solana. Ranked index comparing all chains by USD transaction cost.

Guide

Marine Oracle

Sea state, vessel tracking, route summaries, and voyage forecasts. Real-time maritime data signed and delivered over HTTP.

Guide

Weather Oracle

Water stress, rainfall, temperature, and wind speed at any global coordinates. Configurable time windows. Signed attestations.

Guide

Signed History

Cryptographically signed historical data — spot OHLCV, funding rates, and index history with per-row original Ed25519 signatures. Foundation for Layer 4 Wisdom.

Layer 2 — Oracle Information

Structured context synthesised from Layer 1. Single call, single payment, single signature over a multi-signal snapshot.

$0.25 · Layer 2

Market Synopsis

15-signal market state snapshot in one call — all four indices, funding, OI, liquidation flow, price, VWAP, basis, and economic calendar context. $0.25. 60s cache.

$0.15 · Layer 2

Perp Regime

10-signal perp trading regime for BTC, ETH, and SOL. Returns regime classification (BEARISH_MOMENTUM, SQUEEZE_SETUP, LONG_TRAP…) with signal alignment, confidence, and risk. $0.15. 30s cache.

$0.05 · Layer 2

Crypto Indices

Four composite indices: MSVI (volatility 0–100), MSXI (sentiment −100 to +100), MSSI (market stress 0–100), MSTI (crypto-TradFi contagion 0–100). Cryptographically signed. BTC and ETH.

$0.05 · Layer 2

Equity Indices

MESI — equity stress composite (VIX, credit spreads, yield curve, FRED STLFSI4, DXY). MNVI — NQ volatility composite (RV, IV, term structure, skew, PCR). Cross-asset context for crypto.

$0.10 · Layer 2

TradFi Regime

RISK_ON / NEUTRAL / STRESS / PANIC classification from MESI + MNVI + yield curve. Tells agents whether traditional finance is in risk-on or risk-off mode. $0.10. 300s cache.

$0.10 · Layer 2

Liquidity Regime

DEEP / NORMAL / THIN / FRAGILE classification from funding rates, OI, basis, liquidation flow, and orderbook imbalance. Real-time market depth signal. $0.10. 60s cache.

Layer 3 — Oracle Intelligence

Cross-domain pattern recognition. Interpreted, machine-actionable signals. Every response includes a disclaimer field — regime classifications, not financial advice.

$1.00 · Layer 3

Macro Risk Score

Cross-domain risk score 0–100 combining MSSI crypto stress (40%), MSTI contagion (30%), and economic calendar events (30%). Regimes: LOW / MODERATE / ELEVATED / HIGH / CRITICAL. $1.00. 60s cache.

$1.00 · Layer 3

Perp Setup Scanner

Scans BTC, ETH, and SOL perp regimes simultaneously. Returns highest-confidence setup with signal alignment, edge, invalidation conditions, and MSSI market bias overlay. $1.00. 30s cache.

$0.75 · Layer 3

DeFi Opportunity

Risk-adjusted DeFi yield across 15+ protocols. Raw APR penalized by MSSI stress and MSTI contagion for cross-chain exposure. Returns risk_adjusted_apr with full penalty breakdown. $0.75. 60s cache.

$0.50 · Layer 3

Regime Change

Detects BTC, ETH, and SOL perp regime transitions in the last 2 hours. Returns from_regime, to_regime, and bias_changed flag per currency. $0.50. 30s cache.

$0.50 · Layer 3

Cross-Asset Divergence

Measures alignment between crypto and TradFi regimes. NONE / LOW / MODERATE / HIGH / EXTREME with dominant direction, score 0–10, and contagion amplification flag. $0.50. 60s cache.

$0.50 · Layer 3

Regime Consensus

Weighted vote aggregation across all active regime signals. Returns STRONG / MODERATE / WEAK / CONFLICTED with dominant theme and per-signal vote breakdown. $0.50. 60s cache.

$0.15 · Layer 3

Regime Persistence

How long has the current perp regime held, and how unusual is that historically? Returns duration_hours, historical_percentile, and typical_remaining_hours. BTC/ETH/SOL. $0.15. 30s cache.

Layer 4 — Oracle Wisdom coming Sep 2026

Longitudinal pattern synthesis across signed historical regime data. What typically follows this regime? How unusual is current market structure? Requires 90 days of history — logging started June 2026.

Coming Soon

Oracle Wisdom

Pattern recognition across regime sequences. Historical analogues. Regime transition probabilities. Available when 90 days of signed history accumulates.