Quick Start
Get started with MoonMaker API in 2 minutes
Quick Start
1. Check the API is online
curl https://api.moonmaker.cc/health
# → {"status": "ok", "timestamp": "..."}2. See available endpoints
curl https://api.moonmaker.cc/Returns all endpoints with pricing and documentation links.
3. Get a trading signal
With x402-compatible client (recommended)
# pip install x402
from x402.client import x402_fetch
response = x402_fetch(
"https://api.moonmaker.cc/signal/BTC",
wallet=your_wallet
)
signal = response.json()
print(f"Direction: {signal['signal']['direction']}")
print(f"Confidence: {signal['signal']['confidence']}")
print(f"Entry: ${signal['levels']['entry']:,.2f}")
print(f"Stop Loss: ${signal['levels']['stop_loss']:,.2f}")
print(f"Take Profit: ${signal['levels']['take_profit_1']:,.2f}")With curl (manual)
# This returns 402 with payment details
curl -v https://api.moonmaker.cc/signal/BTC
# Parse X-PAYMENT header, send USDC on Base L2, then retry4. Get market overview
response = x402_fetch(
"https://api.moonmaker.cc/market/overview",
wallet=your_wallet
)
market = response.json()
print(f"BTC: ${market['prices']['BTC']['price']:,.0f}")
print(f"Fear & Greed: {market['fear_greed']['value']}")
print(f"ETF Flow: ${market['etf_flows']['daily_total_m']:.1f}M")5. Get risk assessment
response = x402_fetch(
"https://api.moonmaker.cc/risk/BTC",
wallet=your_wallet
)
risk = response.json()
print(f"Verdict: {risk['verdict']}")
print(f"Stop Loss: ${risk['levels']['stop_loss']:,}")
print(f"TP1: ${risk['levels']['take_profit_1']:,}")
print(f"R:R (TP1): {risk['risk_reward']['tp1']}")
print(f"Position Size: ${risk['position_sizing']['example_1pct_risk']['position_size']:,.0f}")6. Check upcoming economic events
response = x402_fetch(
"https://api.moonmaker.cc/events",
wallet=your_wallet
)
events = response.json()
if events.get("warning"):
print(f"⚠️ {events['warning']}")
for ev in events["upcoming_7d"]:
print(f"{ev['date']} — {ev['event']} (importance: {ev['importance']})")For AI Agents
If you're an AI agent (OpenClaw, etc.), check these machine-readable resources:
- llms.txt — Human/AI readable overview
- openapi.json — OpenAPI 3.0 spec
- agents.json — Agent discovery metadata
OpenClaw agents
Free endpoints work with web_fetch:
web_fetch("https://api.moonmaker.cc/health")For paid endpoints, you'll need x402 wallet integration. Install the moonmaker skill for guided usage.