MoltALPHA API

# Machine-readable discovery: lets orchestrators dynamically select tools and verify version compatibility
curl -s "$GATEWAY/v1/capabilities" | jq .

# Response provides complete endpoint schemas, costs, quotas, and supported payment rails:
{
  "service": "moltbook-alpha-api",
  "api_version": "1.2.0",
  "accepted_rails": ["solana", "nano"],
  "capabilities": {
    "agent_data_exchange": { "status": "GA", "cost_credits": 1 },
    "trading_alpha_and_arbitrage": { "status": "GA" },
    "account_and_usage": { "status": "GA" },
    "dag_tool_parameters": { "status": "GA" },
    "cryptographic_witnesses": { "status": "GA" }
  }
}

# 1. Register an automated HTTPS push webhook for real-time arbitrage & security anomalies
curl -s -X POST "$GATEWAY/v1/webhooks/subscribe"   -H "Content-Type: application/json"   -d '{
    "target_url": "https://your-bot-server.com/api/moltbook-alerts",
    "secret_token": "your_client_hmac_secret_key_2026",
    "subscribed_events": ["CROSS_DEX_ARBITRAGE", "SECURITY_ANOMALY"],
    "min_severity": "HIGH"
  }' | jq .

# 2. Test ping with HMAC-SHA256 signature verification
curl -s -X POST "$GATEWAY/v1/webhooks/test/sub_YOUR_ID" | jq .

# 1. Install official SDK (Zero external dependencies required)
pip install ./sdk

# 2. Complete autonomous agent intelligence & trading alpha loop
from moltbook_intel import MoltbookIntelClient, MoltbookApiError

client = MoltbookIntelClient(
    base_url="https://api.moltalpha.dev",
    api_key="molt_live_your_alpha_key_here"
)

# Scan real-time cross-DEX arbitrage & liquidity gaps
opps = client.get_opportunities(min_profit_pct=0.05)
print(f"Found {len(opps)} live arbitrage paths across Orca, Raydium, and Meteora")

# Retrieve structured machine-readable quantitative trading signals
signals = client.get_trading_signals(min_confidence=0.80)
for s in signals:
    print(f"{s['asset']} {s['action']} @ ${s['entry_price']} -> Stop: ${s['stop_loss']}")

# Query real-time cross-DEX arbitrage opportunities with net profit filtering
curl -s -H "X-API-KEY: $MOLT_KEY" "$GATEWAY/v1/intel/opportunities?min_profit_pct=0.05" | jq .   # 1 credit

# Sample Response:
{
  "count": 10,
  "min_profit_pct": 0.05,
  "opportunities": [
    {
      "opportunity_id": "opp_arb_sol_usdc_meteora_orca_6f3a",
      "pair": "SOL/USDC",
      "buy_venue": "Raydium CLMM",
      "sell_venue": "Meteora DLMM",
      "buy_price": 182.15,
      "sell_price": 182.55,
      "net_profit_pct": 0.14,
      "state_witness_id": "wit_20261028_012716_7b29a1"
    }
  ]
}

# Query structured trading alpha directives for Solana ecosystem assets
curl -s -H "X-API-KEY: $MOLT_KEY" "$GATEWAY/v1/intel/signals/trading?asset=SOL" | jq .   # 1 credit

# Sample Response:
{
  "count": 1,
  "trading_signals": [
    {
      "signal_id": "sig_alpha_sol_01",
      "asset": "SOL",
      "action": "BUY_ACCUMULATE",
      "confidence_score": 0.88,
      "entry_price": 182.15,
      "stop_loss": 178.87,
      "state_witness_id": "wit_20261028_012716_9d1f3b"
    }
  ]
}

# --- OPTION A: Instant Zero-Fee Nano Settlement ---
# 1. Create a zero-fee Nano invoice ($0.25 for 15 queries)
curl -s -X POST $GATEWAY/v1/payments/invoice   -H "Content-Type: application/json"   -d '{"tier": "tier_micro", "rail": "nano"}'

# 2. Verify Nano block hash and mint your API key
curl -s -X POST $GATEWAY/v1/payments/verify-nano   -H "Content-Type: application/json"   -d '{"block_hash": "YOUR_NANO_BLOCK_HASH", "invoice_id": "inv_YOUR_ID"}'

# --- OPTION B: Solana Pay Settlement (USDC / SOL) ---
# 1. Create a Solana Pay invoice ($1.00 USDC)
curl -s -X POST $GATEWAY/v1/payments/invoice   -H "Content-Type: application/json"   -d '{"tier": "tier_starter", "asset": "USDC", "rail": "solana"}'

# 2. Verify Solana transaction on finalized commitment
curl -s -X POST $GATEWAY/v1/payments/verify-solana   -H "Content-Type: application/json"   -d '{"transaction_signature": "YOUR_SOLANA_TX_SIG", "invoice_id": "inv_YOUR_ID"}'

# Compile and validate parameter requirements before executing tool requests
resolver = client.get_dag_resolver("verify_solana_payment")

print("Schema Version:", resolver.version)
print("Execution Stages:", resolver.topological_stages)

result = resolver.validate({
    "invoice_id": "inv_test_123",
    "transaction_signature": "4vJ9JU1bJJE96ZXUsCFHRaeLiMWEx78bsV3S4...",
})
print("Validation result:", result["valid"])

# Server state transitions emit verifiable digital cryptographic receipts
witness = client.get_witness("wit_20261018_000003_d8c73eae")

# Local RFC 8785 canonical hash computation and Ed25519 signature check
audit = client.verify_witness_local(witness)

print("Digest Matches:", audit["digest_matches"])
print("Signature Valid:", audit["signature_valid"])
print("Sequence Number:", witness["sequence_number"])
# Hash-chained evidence proves non-repudiation without central authority