https://satsapi.dev

# Step 1 — request returns 402 + invoice
curl -s https://satsapi.dev/v1/price
# → { "invoice": "lnbc30n1p...", "payment_hash": "fa7f01...", "amount_sats": 3 }

# Step 2 — pay the invoice with any Lightning wallet
# (Phoenix, Alby, Breez, lncli…)

# Step 3 — retry with payment_hash as query param
curl -s "https://satsapi.dev/v1/price?payment_hash=fa7f01..." | jq .

# After paying the invoice, retry with the payment_hash
curl "https://satsapi.dev/v1/price?payment_hash=fa7f01e2d3c4b5a6..."

# Response: 200 OK with full data

async function callSatsAPI(path) {
  // 1. Initial request
  let res = await fetch(`https://satsapi.dev${path}`);

  // 2. Handle 402 — pay Lightning invoice
  if (res.status === 402) {
    const body = await res.json();
    // { invoice: "lnbc30n1...", payment_hash: "fa7f01...", amount_sats: 3 }

    // Pay with your Lightning wallet/library
    await wallet.payInvoice(body.invoice);

    // 3. Retry with payment_hash as query param
    res = await fetch(
      `https://satsapi.dev${path}?payment_hash=${body.payment_hash}`
    );
  }

  return res.json();
}

// Usage
const { data } = await callSatsAPI('/v1/price');
console.log(data.price);   // 84231.50
console.log(data.rsi_14);  // 44.2
console.log(data.trend);   // "BEARISH"

const { data } = await callSatsAPI('/v1/summary');
const b = data.bot_ready;

console.log(b.signal);        // "HOLD"
console.log(b.confluence);    // 52
console.log(b.price_usd);     // 84231.50
console.log(b.fear_greed);    // 28
console.log(b.leverage_risk); // "LOW"

import requests

def call_sats_api(path: str, wallet=None) -> dict:
    url = f"https://satsapi.dev{path}"

    # 1. Initial request
    r = requests.get(url)

    # 2. Handle 402 payment
    if r.status_code == 402 and wallet:
        body         = r.json()
        invoice      = body["invoice"]
        payment_hash = body["payment_hash"]

        # Pay invoice with any LN wallet/library
        wallet.pay(invoice)

        # 3. Retry with payment_hash as query param
        r = requests.get(url, params={"payment_hash": payment_hash})

    r.raise_for_status()
    return r.json()

# Usage
data = call_sats_api("/v1/signal")["data"]
print(data["signal"])      # "HOLD"
print(data["confluence"])  # 52
print(data["reasoning"])   # "Neutral RSI at 49.3..."

# Step 1 — get invoice
curl -s https://satsapi.dev/v1/price
# → {"invoice":"lnbc30n1p...","payment_hash":"fa7f01...","amount_sats":3}

# Step 2 — pay invoice with your wallet (Phoenix, lncli, Alby…)

# Step 3 — retry with payment_hash
curl -s "https://satsapi.dev/v1/price?payment_hash=fa7f01..." | jq .data

# Full summary
curl -s "https://satsapi.dev/v1/summary?payment_hash=..." | jq .data.bot_ready

# Transaction lookup
curl -s "https://satsapi.dev/v1/tx/4a5e1e4baab89f3a...?payment_hash=..." | jq .

# Using lnget (handles 402 automatically)
lnget https://satsapi.dev/v1/signal | jq .data.signal

# lnget handles 402 → pay → retry automatically
lnget https://satsapi.dev/v1/summary | jq .data.bot_ready

import { Tool } from "langchain/tools";

class BitcoinIntelligenceTool extends Tool {
  name = "bitcoin_market_intelligence";
  description = "Returns BTC market signal (BUY/SELL/HOLD), " +
    "price, RSI, risk and confluence score. " +
    "Call before any Bitcoin-related decision.";

  async _call() {
    // Step 1 — get invoice
    let res = await fetch("https://satsapi.dev/v1/summary");
    if (res.status === 402) {
      const { invoice, payment_hash } = await res.json();
      await this.wallet.payInvoice(invoice); // pay 200 sats
      res = await fetch(
        `https://satsapi.dev/v1/summary?payment_hash=${payment_hash}`
      );
    }
    const { data } = await res.json();
    return JSON.stringify(data.bot_ready);
  }
}

// Agent receives a flat object — no parsing needed:
// { signal:"HOLD", confluence:52, price_usd:84231, fear_greed:28,
//   support:79400, resistance:91200, leverage_risk:"LOW" }

// Runs every 4 hours — costs 200 sats/run (~1,200 sats/day)
async function tradingCycle() {
  // Fetch + pay in one helper
  const { data } = await callSatsAPI("/v1/summary");
  const b = data.bot_ready;

  // Only act on high-confluence signals
  if (b.signal === "BUY" && b.confluence >= 65 && b.leverage_risk !== "EXTREME") {
    await exchange.createOrder("BTC/USDT", "buy", b.price_usd * 0.995);
    log(`BUY @ ${b.price_usd} — confluence ${b.confluence}% — stop ${b.support}`);
  }

  if (b.signal === "SELL" && b.confluence >= 70) {
    await exchange.closePositions();
    log(`SELL @ ${b.price_usd} — market score ${b.market_score}/100`);
  }
}

cron.schedule("0 */4 * * *", tradingCycle);

tools = [{
    "type": "function",
    "function": {
        "name": "get_bitcoin_signal",
        "description": "Get current BTC market signal and risk. Returns bot_ready object.",
        "parameters": { "type": "object", "properties": {} }
    }
}]

def get_bitcoin_signal():
    # Step 1 — request
    r = requests.get("https://satsapi.dev/v1/summary")
    if r.status_code == 402:
        body = r.json()
        wallet.pay(body["invoice"])
        r = requests.get(
          "https://satsapi.dev/v1/summary",
          params={"payment_hash": body["payment_hash"]}
        )
    return r.json()["data"]["bot_ready"]