Handling Errors

response=$(curl -s -w "\n%{http_code}" "https://api.vulcx.xyz/api/v1/quote?inputMint=INVALID&outputMint=uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG&amount=1000000000&swapMode=ExactIn" \
  -H "Authorization: Bearer $VULCX_KEY")
http_code=$(echo "$response" | tail -1)
body=$(echo "$response" | head -1)

if [ "$http_code" != "200" ]; then
  echo "Error ($http_code): $body"
fi

const response = await fetch(
  "https://api.vulcx.xyz/api/v1/quote?" +
    new URLSearchParams({
      inputMint: "So11111111111111111111111111111111111111112",
      outputMint: "uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG",
      amount: "1000000000",
      swapMode: "ExactIn",
    }),
  { headers: { Authorization: `Bearer ${process.env.VULCX_KEY}` } }
);

const result = await response.json();

if (!result.success) {
  const err = result.error ?? "";

  // Match by PREFIX, not equality. Most messages carry detail after the stem —
  // "insufficient liquidity" arrives as "no route found: insufficient liquidity",
  // so an === comparison silently never matches.
  if (err === "missing api key" || err === "invalid api key") {
    console.log("Check your Authorization header / API key.");
  } else if (err.startsWith("no route found: insufficient liquidity")) {
    console.log("Not enough liquidity. Reduce the amount.");
  } else if (err.startsWith("no route found")) {
    console.log("No swap route available. Try a smaller amount.");
  } else if (err.startsWith("multi-hop ExactOut")) {
    console.log("ExactOut is single-hop only — use ExactIn with a buffer.");
  } else if (err.startsWith("ExactOut is only supported on Vortex")) {
    console.log("Re-quote as ExactIn, or excludeDexes to force a Valiant route.");
  } else {
    console.error(`API error: ${err}`);
  }
}

import os, requests

resp = requests.get(
    "https://api.vulcx.xyz/api/v1/quote",
    params={
        "inputMint": "So11111111111111111111111111111111111111112",
        "outputMint": "uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG",
        "amount": "1000000000",
        "swapMode": "ExactIn",
    },
    headers={"Authorization": f"Bearer {os.environ['VULCX_KEY']}"},
)

result = resp.json()

if not result["success"]:
    error = result["error"]
    if error == "no route found":
        print("No swap route available. Try a smaller amount.")
    elif error == "insufficient liquidity":
        print("Not enough liquidity. Reduce the amount.")
    else:
        print(f"API error: {error}")