aibtcdev/lunarcrush

LunarCrush Skill

Provides paid access to LunarCrush social/market intelligence via the x402 protocol on Stacks. Each score call costs ~$0.005 USD worth of STX (the on-chain microSTX amount is recomputed at request time from live STX/USD, so you pay a stable dollar value regardless of STX volatility).

LunarCrush is the leading social intelligence platform for crypto and equities — Galaxy Score, AltRank, sentiment, social volume, and topic data are widely used by trading firms and quant strategies. This skill exposes a subset of that data on a per-call basis for autonomous agents that don't want to manage SaaS subscriptions or API keys.

Endpoints

| Subcommand | Network | Approx cost | Description | |---|---|---|---| | oracle | mainnet (default) or testnet | $0.025 USD in STX | Premium combined: verdict + confidence + reasoning + vibe one-liner + structured signals. One paid call, both trading-model and chatbot audiences served. | | score | mainnet (default) or testnet | $0.005 USD in STX | Galaxy Score, AltRank, market cap rank, price, 24h change | | health | n/a | free | Liveness probe | | meta | n/a | free | Live STX/USD price, full endpoint catalog with current microSTX amounts |

Endpoints planned (not yet live): altrank (dedicated), topic, social-velocity, sentiment, top-movers, whale-flow. The full catalog is documented at the meta endpoint.

Usage

bun run lunarcrush/lunarcrush.ts <subcommand> [options]

oracle

Premium combined call — returns verdict, confidence, reasoning, a vibe one-liner, AND the full structured signals in a single response. Costs ~$0.025 USD in STX (~5x a score call) but saves you 5+ separate paid calls if you'd otherwise compose this yourself.

bun run lunarcrush/lunarcrush.ts oracle --symbol BTC
bun run lunarcrush/lunarcrush.ts oracle --symbol ETH --network testnet

Options:

• --symbol (required) — Crypto ticker symbol (e.g. BTC, ETH, STX).
• --network (optional, default mainnet) — mainnet or testnet.

Output:

{
  "symbol": "BTC",
  "name": "Bitcoin",
  "verdict": "BUY",
  "confidence": 0.691,
  "reasoning": "Galaxy Score 58.8, AltRank 85, 24h price +0.60%, top-10 market cap → composite 69/100 (Galaxy 45% / AltRank 35% / momentum 20%) → BUY.",
  "vibe": "BTC is feeling itself 💪 Galaxy 58.8 on the up, momentum constructive. Mid-confidence vote.",
  "signals": {
    "galaxy_score": 58.8,
    "alt_rank": 85,
    "market_cap_rank": 1,
    "price_usd": 76369.76,
    "percent_change_24h": 0.59
  },
  "source": "lunarcrush",
  "network": "mainnet",
  "endpoint": "https://lunarcrush-x402-poc-prod.lunarcrush.workers.dev/oracle/btc",
  "payment_receipt": { "success": true, "payer": "SP...", "transaction": "...", "network": "stacks:1" }
}

Verdict tiers (deterministic synthesis from a weighted composite — Galaxy 45% / AltRank 35% / 24h momentum 20%):

• STRONG-BUY (composite ≥ 75)
• BUY (60-74)
• NEUTRAL (45-59)
• WATCH (30-44)
• AVOID (< 30)
• UNKNOWN (insufficient data)

The vibe field is a personality-laden one-liner usable directly in chatbots, Telegram bots, agent narrative output, or anywhere you'd prefer human-readable over structured. The signals block is for quant models that want raw inputs.

score

Fetch Galaxy Score and other current metrics for a symbol. Pays via x402.

bun run lunarcrush/lunarcrush.ts score --symbol BTC
bun run lunarcrush/lunarcrush.ts score --symbol ETH --network testnet

Options:

• --symbol (required) — Crypto ticker symbol (e.g. BTC, ETH, STX).
• --network (optional, default mainnet) — mainnet or testnet. Mainnet uses real STX, testnet uses Hiro testnet faucet STX.

Output (fields surfaced by the worker; payment_receipt is decoded from the payment-response header when present):

{
  "symbol": "BTC",
  "name": "Bitcoin",
  "galaxy_score": 59,
  "alt_rank": 63,
  "market_cap_rank": 1,
  "price_usd": 76244.42,
  "percent_change_24h": 1.40,
  "source": "lunarcrush",
  "network": "mainnet",
  "endpoint": "https://lunarcrush-x402-poc-prod.lunarcrush.workers.dev/galaxy-score/btc",
  "payment_receipt": {
    "success": true,
    "payer": "SP...",
    "transaction": "...",
    "network": "stacks:1"
  }
}

health

Liveness probe (free). Returns { ok: true, ts: ... }.

bun run lunarcrush/lunarcrush.ts health
bun run lunarcrush/lunarcrush.ts health --network testnet

meta

Returns the live endpoint catalog with current microSTX amounts (USD-pegged; recomputed hourly from STX/USD).

bun run lunarcrush/lunarcrush.ts meta

Output:

{
  "name": "lunarcrush-x402-poc",
  "version": "0.0.2",
  "network": "mainnet",
  "server_address": "SP3TH5S631RYN7Z485TY0KPFVX24R7RW7P25HVZ73",
  "facilitator": "https://x402-relay.aibtc.com",
  "pricing": {
    "stx_price_usd": 0.2212,
    "stx_price_cache_ttl_seconds": 3600,
    "endpoints": [
      { "key": "galaxy-score", "price_usd": 0.005, "price_microSTX": "22605", "price_STX": 0.022605 }
    ]
  }
}

Pricing strategy

• USD-pegged. Each endpoint has a fixed USD price target ($0.005 → $0.0275 across the catalog). The microSTX amount required is recomputed from live STX/USD and cached at the edge for one hour.
• Premium over the LunarCrush Individual subscription per-call effective rate ($90/mo ≈ $0.003/call). Agents pay a convenience premium; heavy users self-funnel into the $90/mo Individual tier.

Worker Hosts

• Mainnet (real money): https://lunarcrush-x402-poc-prod.lunarcrush.workers.dev
• Testnet (faucet STX): https://lunarcrush-x402-poc.lunarcrush.workers.dev

Recipient wallet on Stacks mainnet: SP3TH5S631RYN7Z485TY0KPFVX24R7RW7P25HVZ73 (Prime Spoke, on-chain identity registered with aibtc.news).

Notes

• The skill reads your wallet via the shared getAccount() helper (env mnemonic or unlocked wallet skill). x402 payment is handled automatically by createApiClient.
• LunarCrush API quota is protected by 60-second Cloudflare edge cache; multiple agents requesting the same symbol within 60s share a single upstream LC fetch.
• All data sourced from the LunarCrush public v4 API. LunarCrush is the canonical source.