StockUp Quan API Developer Hub

{
  "model": "quan-3.4",
  "messages": [
    { "role": "user", "content": "Compare Apple and Microsoft valuation." }
  ],
  "googleSearch": true,
  "stream": true,
  "temperature": 0.2
}

curl -X POST "https://stockup.cc/v1/query" \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk_quan_your_secret_key" \
  -d '{
    "model": "quan-3.4",
    "messages": [
      { "role": "user", "content": "How does compound interest work?" }
    ],
    "stream": false
  }'

const apiKey = "sk_quan_your_secret_key";
const url = "https://stockup.cc/v1/query";

async function streamResponse() {
  const response = await fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": apiKey
    },
    body: JSON.stringify({
      model: "quan-3.4",
      messages: [{ role: "user", content: "Analyze Apple stock setup." }],
      stream: true
    })
  });

  const reader = response.body.getReader();
  const decoder = new TextDecoder();
  let buffer = "";

  while (true) {
    const { done, value } = await reader.read();
    if (done) break;

    buffer += decoder.decode(value, { stream: true });
    const lines = buffer.split("\n");
    buffer = lines.pop(); // Keep partial line in buffer

    for (const line of lines) {
      if (line.startsWith("data: ")) {
        const payload = line.slice(6).trim();
        if (payload === "[DONE]") {
          console.log("\n--- Stream Finished ---");
          break;
        }
        
        try {
          const chunk = JSON.parse(payload);
          const text = chunk.candidates?.[0]?.content?.parts?.[0]?.text || "";
          process.stdout.write(text);
        } catch (err) {
          // Skip non-JSON chunks or log metadata
        }
      }
    }
  }
}

streamResponse();

import requests

url = "https://stockup.cc/v1/query"
headers = {
    "Content-Type": "application/json",
    "x-api-key": "sk_quan_your_secret_key"
}
payload = {
    "model": "quan-3.4",
    "messages": [
        {"role": "user", "content": "Explain the difference between P/E and forward P/E."}
    ],
    "stream": False
}

response = requests.post(url, headers=headers, json=payload)
if response.status_code == 200:
    data = response.json()
    text = data['candidates'][0]['content']['parts'][0]['text']
    print(text)
else:
    print(f"Error {response.status_code}: {response.text}")

curl -X POST "https://stockup.cc/v1/query" \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk_quan_your_secret_key" \
  -d '{
    "model": "quan-3.5",
    "messages": [
      { "role": "user", "content": "Explain the difference between P/E and forward P/E." }
    ],
    "stream": false,
    "answerStyle": "balanced"
  }'

const apiKey = "sk_quan_your_secret_key";
const url = "https://stockup.cc/v1/query";

async function askQuan35() {
  const response = await fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": apiKey
    },
    body: JSON.stringify({
      model: "quan-3.5",
      messages: [{ role: "user", content: "Summarize the most recent reported quarter for Microsoft." }],
      stream: false
    })
  });

  if (!response.ok) {
    const error = await response.json().catch(() => null);
    throw new Error(`${response.status} ${error?.code || ""} ${error?.error || ""}`);
  }

  const data = await response.json();
  console.log(data.candidates?.[0]?.content?.parts?.[0]?.text || "");
  console.log("version:", response.headers.get("X-Quan-Model-Version")); // "3.5"
  console.log("charge (USD):", response.headers.get("X-StockUp-Charge"));
  console.log("balance (USD):", response.headers.get("X-StockUp-Balance"));
}

askQuan35();

import requests

url = "https://stockup.cc/v1/query"
headers = {
    "Content-Type": "application/json",
    "x-api-key": "sk_quan_your_secret_key"
}
payload = {
    "model": "quan-3.5",
    "messages": [
        {"role": "user", "content": "Explain the difference between P/E and forward P/E."}
    ],
    "stream": False
}

response = requests.post(url, headers=headers, json=payload)
if response.status_code == 200:
    data = response.json()
    text = data['candidates'][0]['content']['parts'][0]['text']
    print(text)
    print("charge (USD):", response.headers.get("X-StockUp-Charge"))
else:
    print(f"Error {response.status_code}: {response.text}")

const response = await fetch("https://stockup.cc/v1/query", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.STOCKUP_API_KEY
  },
  body: JSON.stringify({
    model: "quan-3.5",
    messages: [{ role: "user", content: "What is moving the semiconductor sector today?" }],
    stream: true
  })
});

const reader = response.body.getReader();
const decoder = new TextDecoder();
let buffer = "";
let eventName = "message";

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });
  const lines = buffer.split("\n");
  buffer = lines.pop();

  for (const line of lines) {
    if (line.startsWith("event: ")) { eventName = line.slice(7).trim(); continue; }
    if (!line.startsWith("data: ")) { if (line === "") eventName = "message"; continue; }
    const payload = line.slice(6).trim();
    if (payload === "[DONE]") continue;
    const data = JSON.parse(payload);
    if (eventName === "billing") {
      console.log("\ncharge (USD):", data.charge, "balance:", data.remainingBalance);
    } else if (eventName === "message") {
      process.stdout.write(data.candidates?.[0]?.content?.parts?.[0]?.text || "");
    }
  }
}

<link rel="stylesheet" href="/assets/quan-visual-demo.css">
<script src="/assets/quan-visual-demo.js" defer></script>

<section class="quan-visual-demo"
  data-default-stock="VOO"
  data-default-visual="dca"
  data-demo-context="api"
  data-demo-guide-href="/docs#visual-elements"
  data-demo-stocks="VOO,NVDA,AMZN,MSFT">
  <div class="qvd-showcase">
    <div class="qvd-visual-column">
      <div class="qvd-shell">
        <div class="qvd-controls">
          <div class="qvd-control-group">
            <div class="qvd-control-label">Stock</div>
            <div class="qvd-button-row" data-demo-stock-buttons></div>
          </div>
          <div class="qvd-control-group">
            <div class="qvd-control-label">Visual element</div>
            <div class="qvd-button-row" data-demo-visual-buttons></div>
          </div>
        </div>
        <div class="qvd-view" data-demo-view aria-live="polite"></div>
      </div>
    </div>
    <div class="qvd-copy">
      <span class="qvd-kicker">Interactive visual elements</span>
      <h2>Quan visual elements</h2>
      <p>Use trusted backend values to render app-ready financial visuals.</p>
      <div class="qvd-explain-card" data-demo-explanation aria-live="polite"></div>
    </div>
  </div>
</section>

window.QuanVisualDemoData = {
  VOO: {
    name: "Vanguard S&P 500 ETF",
    dca: {
      monthly: 1000,
      years: 10,
      annualReturn: 7.4,
      cagr: 3.73
    },
    audit: {
      verdict: "Clean broad-market exposure with macro sensitivity",
      confidence: "High",
      checks: [
        ["Source coverage", "Broad ETF data is easy to cross-check", "good"],
        ["Narrative risk", "Mostly index-level claims", "good"],
        ["Key watch", "Multiple compression if rates stay elevated", "warn"]
      ]
    },
    risk: {
      score: 42,
      summary: "Balanced",
      factors: [
        ["Valuation", 48, "Market multiple is the main sensitivity."],
        ["Concentration", 36, "Diversified, with mega-cap weight."],
        ["Volatility", 40, "Lower than most single-name equities."],
        ["Earnings sensitivity", 44, "Index EPS revisions matter."],
        ["Macro exposure", 52, "Rate and growth expectations matter."]
      ]
    },
    analyst: {
      consensus: "Broad market proxy",
      asOf: "Provider snapshot",
      buy: 65,
      hold: 30,
      sell: 5,
      low: 455,
      average: 520,
      high: 585
    }
  }
};

// Use this when you update data after the page has already loaded.
window.initQuanVisualDemos?.();

import express from "express";

const app = express();
app.use(express.json());

app.post("/api/quan-visual", async (req, res) => {
  const ticker = String(req.body.ticker || "VOO").toUpperCase();

  const quanResponse = await fetch("https://stockup.cc/v1/query", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": process.env.STOCKUP_API_KEY
    },
    body: JSON.stringify({
      model: "quan-3.4",
      stream: false,
      googleSearch: true,
      temperature: 0.2,
      messages: [{
        role: "user",
        content: `Summarize ${ticker} risk, DCA assumptions, audit concerns, and analyst context. Separate confirmed facts from judgment.`
      }]
    })
  });

  const quanJson = await quanResponse.json();
  const analysisText =
    quanJson?.candidates?.[0]?.content?.parts?.[0]?.text || "";

  // Replace these placeholders with verified values from your own provider.
  const providerValues = await loadVerifiedMarketValues(ticker);

  res.json({
    ticker,
    analysisText,
    visualData: mapToQuanVisualData(ticker, providerValues)
  });
});

function mapToQuanVisualData(ticker, values) {
  return {
    [ticker]: {
      name: values.name,
      dca: {
        monthly: values.monthlyContribution,
        years: values.projectionYears,
        annualReturn: values.assumedAnnualReturn,
        cagr: values.estimatedCagr
      },
      audit: {
        verdict: values.auditVerdict,
        confidence: values.auditConfidence,
        checks: values.auditChecks
      },
      risk: {
        score: values.riskScore,
        summary: values.riskSummary,
        factors: values.riskFactors
      },
      analyst: {
        consensus: values.consensus,
        asOf: values.asOf,
        buy: values.buyCount,
        hold: values.holdCount,
        sell: values.sellCount,
        low: values.targetLow,
        average: values.targetAverage,
        high: values.targetHigh
      }
    }
  };
}

async function loadQuanVisual(ticker) {
  const response = await fetch("/api/quan-visual", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ ticker })
  });

  const payload = await response.json();
  window.QuanVisualDemoData = payload.visualData;
  window.initQuanVisualDemos?.();

  // Optional: display Quan's written analysis beside the visual.
  document.querySelector("#analysisText").textContent = payload.analysisText;
}

loadQuanVisual("VOO");