FAQ - Frequently Asked Questions

Payment & Authentication

What is x402 protocol?

x402 is an open protocol that implements HTTP 402 Payment Required. When you request a paid endpoint, the server returns a 402 status with payment details in the X-PAYMENT header. x402-compatible clients automatically parse this, send the USDC payment on Base L2, and retry the request. No API keys, no registration, no billing dashboards needed.

Benefits:

• Permissionless access for any AI agent or developer
• Instant payment settlement on Base L2 (sub-second)
• Sub-cent transaction fees
• No recurring billing or subscription management

Do I need an API key?

No. MoonMaker uses x402 protocol instead of API keys. Authentication and payment happen at the protocol level. Just make an HTTP request with an x402-compatible client like x402-fetch or manually handle the 402 payment flow.

What wallet setup do I need?

Any wallet that holds USDC on Base L2 (Chain ID: 8453). You'll need:

• USDC balance: Minimum $1-5 for meaningful usage
• ETH on Base: Small amount for gas fees (< $0.01 per transaction)

Popular wallet options:

• Coinbase Wallet (native Base support)
• MetaMask (add Base network)
• Hardware wallets via Base bridge
• Agent wallets via x402 libraries

Pricing & Costs

How much does each endpoint cost?

Is this cheaper than subscription APIs?

Yes, dramatically. Most crypto signal APIs charge $50-200/month. With MoonMaker:

• $1 USDC = 20-50 API calls (depending on endpoint)
• $10 USDC = 200-500 API calls per month
• No unused subscription costs if you don't trade actively

Data Quality & Performance

How accurate are the trading signals?

MoonMaker uses a 25-indicator ensemble voting system covering:

• Trend: Moving averages, MACD, Ichimoku, Parabolic SAR
• Momentum: RSI, Stochastic, Williams %R, CCI
• Volume: OBV, A/D Line, VWAP, Chaikin MF
• Sentiment: Fear & Greed, funding rates, social metrics

Current performance (check /stats endpoint for live metrics):

• 68% win rate (24-hour timeframe)
• +15.2% alpha vs buy-and-hold
• 1.8 profit factor (gains/losses ratio)
• 2.34% expectancy per signal

Important: Use signals as one input among many, not as sole trading advice. Always implement proper risk management.

How often is data updated?

Every 15 minutes. Calling more frequently returns cached data with the same timestamp. This ensures you're not paying for duplicate information.

What coins are supported?

Currently: Bitcoin (BTC), Ethereum (ETH), and Solana (SOL).

Additional coins may be added based on:

• Community demand
• Data quality availability
• Market volume and relevance

Technical Integration

Can AI agents use this API?

Yes — that's the primary use case. MoonMaker is specifically designed for AI agents with:

• Machine-readable docs: /llms.txt and /llms-full.txt
• OpenAPI spec: /openapi.json
• Agent discovery: /.well-known/agents.json
• No authentication complexity: x402 handles payment automatically
• Structured responses: Consistent JSON format optimized for parsing

What programming languages are supported?

Any language with HTTP support. x402 libraries available for:

• JavaScript/TypeScript: x402-fetch, @x402/client
• Python: requests-x402, x402-python
• Go: x402-go
• Rust: x402-rs

Manual integration is also straightforward — just handle the 402 payment flow.

Are there rate limits?

No traditional rate limits. The pay-per-call model naturally limits excessive usage. However:

• Free endpoints: 100 requests/minute per IP
• Concurrent requests: 10 per client (managed by x402 libraries)
• Payment window: 5 minutes to complete payment after 402 response

What if I hold ETH instead of USDC?

Use PayGate — our auto-swap contract that converts ETH to USDC in one transaction:

Contract: 0x8dcFb0F5981BE9B8943C6d6aeeed6000C44B0583 (Base Mainnet)
Fee: 0.5% on swap amount
Process: Send ETH → Receive USDC → Use API

Reliability & Support

What's the API uptime?

99.8% uptime (30-day average) with monitoring:

• Status endpoint: /health (always available)
• Performance metrics: /stats (updated hourly)
• Incident notifications: Telegram channel

What if the API is temporarily down?

1. Check /health endpoint first
2. Data collection continues independently during outages
3. Signals remain available once API recovers
4. No payment charged for failed requests

Where can I get support?

• Documentation: https://moonmaker.cc/docs
• Community: https://t.me/MoonMakerSignals
• Technical issues: GitHub repositories
• Status updates: Telegram channel

Comparison with Alternatives

How is this different from traditional signal APIs?

What about accuracy vs premium services?

MoonMaker's ensemble approach often outperforms single-algorithm services:

• Diversified indicators reduce single-point-of-failure
• Category voting (sentiment vs technical vs macro) provides context
• Public performance metrics allow verification
• Pay-per-use aligns incentives with quality

Advanced Usage

Can I build my own signals with the raw data?

Yes! Use /context/{coin} endpoint ($0.05) to get all 25 indicator values organized by category. This lets you:

• Feed data into custom ML models
• Implement your own scoring algorithms
• Debug signal generation logic
• Combine with your proprietary indicators

Is there a sandbox or test environment?

Free endpoints (/health, /stats) work as a test environment:

• Verify API connectivity
• Check response formats
• Test x402 client integration
• Monitor system performance

Can I get historical signal performance?

Current limitations: MoonMaker focuses on real-time signals. Historical backtesting data is not currently available via API.

Alternative: Use /stats endpoint to see:

• 30-day performance metrics
• Win rate and expectancy stats
• Live signal previews
• System reliability data

Getting Started

What's the quickest way to try MoonMaker?

1. Test free endpoints first:

   curl https://api.moonmaker.cc/health
   curl https://api.moonmaker.cc/stats

2. Set up Base L2 wallet with USDC

3. Install x402 client for your language

4. Make your first paid call:

   from x402.client import x402_fetch
   
   response = x402_fetch(
       "https://api.moonmaker.cc/signal/BTC",
       wallet=your_wallet
   )

Need help getting started?

Check our Quick Start Guide or join the Telegram community for real-time support.