Mycelia Signal Documentation
Real-time, paid, verifiable data for AI agents over x402 (USDC on Base) and L402 (Lightning). 85 paid endpoints across crypto, FX, commodities, economic indicators, weather, marine, gas, and proprietary indices (MSVI, MSXI, MSSI). No API keys. No accounts. One HTTP call.
Quick Start
Get your first signed price attestation with a single curl command. Includes both L402 and x402 examples.
Agent Payment Setup
Configure x402 (USDC) or L402 (Lightning) payment for your AI agent. Step-by-step for ElizaOS, LangChain, and generic HTTP clients.
Signature Verification
Verify attestation signatures in Python, JavaScript, and Rust. Reconstruct the canonical payload and validate the proof.
x402 — USDC on Base
Pay with USDC on Base L2. Ideal for AI agents and EVM-native applications. Ed25519 signatures.
L402 — Lightning Network
Pay with Lightning sats. Native Bitcoin integration for wallets and Lightning-enabled applications. secp256k1 ECDSA signatures.
DLC Oracle
Schnorr-signed threshold and numeric attestations for Discreet Log Contracts. Trustless Bitcoin L1 settlement. L402 and x402 payment rails.
MSVI Volatility Index
Five-component signed volatility index for BTC and ETH. Realized vol, implied vol, term structure, funding rate, and put/call ratio — combined into a cryptographically attested 0-100 index.
Market Indices
Three signed composite indices: MSVI (volatility 0–100), MSXI (sentiment −100 to +100), MSSI (market stress 0–100). Use together to identify market regimes — orderly bull, euphoria, accumulation, or panic.
COT Positioning
BTC CME Commitments of Traders data. Institutional positioning breakdown with net long/short ratios from CFTC filings. Signed attestation.
Embed Widgets
Embed live MSVI, MSXI, and MSSI on any website. One script tag each, no API key, auto-refreshes every 5 minutes. Free delayed data.
MCP Server
Model Context Protocol integration for AI agents. Query oracle data natively from Claude, GPT, and other LLMs.
LangChain Plugin
Native LangChain tool for Python AI pipelines. Free preview mode included — no wallet needed to get started.
ElizaOS Plugin ↗
Native ElizaOS integration. Agents respond to natural language price queries and pay automatically via x402 or L402.
Gas Oracle
Cross-chain gas prices for Ethereum, Base, Arbitrum, Polygon, Optimism, and Solana. Includes a ranked index comparing all 6 chains by USD transaction cost.
Marine Oracle
Sea state, vessel tracking, route summaries, and voyage forecasts. Real-time maritime data signed and delivered over HTTP.
Weather Oracle
Water stress (WRSI), rainfall, temperature, and wind speed at any global coordinates. Configurable time windows. Signed attestations.
Endpoints & Pairs
All 85 paid endpoints — crypto pairs, stablecoin pegs, market indices (MSVI/MSXI/MSSI), FX rates, economic indicators, commodities, gas, marine, and weather. URLs, pricing, source counts, and aggregation methods.
Response Schema
Complete JSON response format with field definitions for each protocol.
Canonical Format
The v1 pipe-delimited canonical payload specification. How to reconstruct for signature verification.
Test Vectors
SHA-256 digests and field positions for every canonical type. Verify your parsing and hashing implementation.
Error Codes
HTTP status codes, error payloads, and troubleshooting for common integration issues.
Source Methodology
Which exchanges and data providers feed each pair. Minimum thresholds, USDT normalization, and safety mechanisms.
Public Keys
All signing keys in one place. secp256k1, Ed25519, and Schnorr public keys for each protocol.
OpenAPI Spec ↗
OpenAPI 3.0 specification for all endpoints. Import directly into Postman, Insomnia, or any API tool.