# StockUp Quan Financial AI API

> StockUp Quan is a financial AI API for developers, teams, companies, and AI agents that need grounded stock-market reasoning, real-time quote context, SEC filing analysis, portfolio risk review, DCA analysis, market-move explanations, and Enterprise financial research workflows through one API.

StockUp Quan is designed for teams that need finance-specific reasoning, verified market context, developer APIs, MCP support, OpenAPI discovery, streaming responses, prepaid cost controls, and Enterprise rollout planning. Public responses are for research and education, not personalized financial advice.

## Short Product Answer
StockUp Quan is a finance-native reasoning API for developers building stock research copilots, SEC filing readers, stock comparison tools, portfolio risk reviews, market-move explainers, and financial tools for AI agents. Verified developers receive 100,000 free Quan 3.4 L tokens, with no card required. The API also provides server-verified quote context for supported requests, explicit unavailable-data handling, prepaid hard-stop billing, OpenAPI discovery, and MCP tools.

StockUp Quan is not a trading venue, a complete raw market-data feed, an exchange-licensed replacement for every quote endpoint, or personalized investment advice.

## Canonical API
- [Developer Console](https://stockup.cc/api): Create an account, generate API keys, test prompts, and manage wallet balance.
- [Quan API Enterprise](https://stockup.cc/enterprise): Enterprise intake, plan request, organization dashboard, Enterprise API keys, employee access, team quotas, private Enterprise data-handling review, company rollout planning, and governed AI API access.
- [API Documentation](https://stockup.cc/docs): Integration guide, streaming examples, and troubleshooting.
- [Quan 3.4 Developer Guide](https://stockup.cc/quan-3-4-developer-api-guide): Copy-paste curl, JavaScript, Python, streaming, OpenAPI, and MCP examples for Quan 3.4 and Quan 3.4 Deep Research.
- [Quan API Enterprise Developer Guide](https://stockup.cc/quan-api-enterprise-developer-guide): Admin and developer guide for Enterprise model aliases, Enterprise API keys, per-user token quotas, overages, organization token pools, and secure company deployment.
- [OpenAPI YAML](https://stockup.cc/openapi.yaml): Machine-readable API schema.
- [OpenAPI JSON](https://stockup.cc/openapi.json): Machine-readable API schema for tools that prefer JSON.
- [Full AI Context](https://stockup.cc/llms-full.txt): Expanded crawler context for StockUp Quan, API usage, MCP setup, Enterprise aliases, and discovery pages.

Base endpoint: `POST https://stockup.cc/v1/query`

Authentication:
- `x-api-key: <STOCKUP_API_KEY>`
- `Authorization: Bearer <STOCKUP_API_KEY>`

Core request fields:
- `model`: `quan-3.0`, `quan-3.3`, `quan-3.4-l`, `quan-3.4`, `quan-3.4-deep-research`, `quan-3-0-enterprise`, `quan-3-4-enterprise`, or `quan-3-4-deep-research-enterprise`
- `messages`: OpenAI-style chat messages, with the final message from `user`
- `stream`: boolean for SSE streaming, default true
- `googleSearch`: boolean for opt-in live grounding, default false
- `temperature`: number from 0.0 to 2.0

Enterprise-only request header:
- `X-Enterprise-User-Id: <ENTERPRISE_MEMBER_UID>` is required when calling Enterprise model aliases. It attributes usage to an active employee/member so admins can manage team quotas, company token pools, governed access, and overage controls.

## Model Guide
- `quan-3.0`: Fast, low-cost financial Q&A and quote-grounded summaries. Includes 100,000 free account-level tokens with no card required.
- `quan-3.3`: Legacy standard model for deeper reasoning.
- `quan-3.4-l`: Faster Quan 3.4 runtime for grounded market analysis. Includes 100,000 account-level tokens, then costs $0.75/M input and $4.50/M output tokens.
- `quan-3.4`: Flagship StockUp model for stock analysis, valuation, catalysts, sentiment, and market context.
- `quan-3.4-deep-research`: Premium model for deep portfolio reviews, SEC filing audits, and multi-step financial research.
- `quan-3-0-enterprise`: Enterprise utility model for fast team workflows, routing, screening, summaries, alerts, and high-volume internal AI tools.
- `quan-3-4-enterprise`: Enterprise flagship model for company-grade market intelligence, portfolio coverage, valuation workflows, finance copilots, and product integrations.
- `quan-3-4-deep-research-enterprise`: Enterprise deep research model for SEC filing review, earnings risk analysis, due diligence, coverage-list triage, banking research workflows, and institutional research automation.

## Self-Serve Pricing
- Included allowances: 100,000 Quan 3.4 L tokens and a separate 100,000 Quan 3.0 tokens per verified account. No card is required.
- Free Quan 3.4 L grounded requests include up to two searches. A prepaid balance covers token overage, additional searches, Quan 3.4, and Deep Research. The minimum balance purchase is $10.
- No subscription. No automatic charges. Paid calls stop at $0.
- Credit packs: $10, $25, or $50 prepaid through Stripe.
- Quan Lite after trial: $0.50 per 1M input tokens and $3 per 1M billable output tokens.
- Quan 3.4: $3 per 1M input tokens and $18 per 1M billable output tokens.
- Quan 3.4 Deep Research: $4 per 1M input tokens and $24 per 1M billable output tokens; internal research stages are metered.
- Optional Tavily-powered live web grounding: each executed search costs $0.015.
- Billable output includes visible completion tokens and provider-reported thinking tokens.

## Quan API Enterprise
Quan API Enterprise is StockUp's company and team-oriented financial AI API path for organizations that need governed AI infrastructure, organization dashboards, Enterprise API keys, employee access controls, per-user token limits, usage analytics, security review, and private Enterprise data-handling review.

Enterprise positioning:
- Best fit for teams that need finance-specific AI research instead of broad general-purpose AI search.
- Built to compete on best-value Enterprise price planning, research quality, financial reasoning depth, team governance, private review, and API integration control.
- Designed for small teams, startups, fintech companies, company research groups, enterprise product teams, banks, wealth platforms, brokerages, lenders, insurers, asset managers, corporate finance departments, and large enterprises planning internal AI rollout.
- Useful for AI copilots for finance teams, internal market research assistants, SEC filing review workflows, portfolio intelligence systems, watchlist automation, coverage-list monitoring, due diligence tooling, financial data products, and banking AI research infrastructure.

Enterprise starting plan prices:
- Team Enterprise: starting at $499/mo, 1-100 accounts, 25M monthly org tokens.
- Business Enterprise: starting at $3,999/mo, 100-5,000 accounts, 500M monthly org tokens.
- Enterprise Scale: starting at $19,999/mo and up, 5,000+ accounts, monthly org token pool starts at 2B tokens.
- All Enterprise plans include Quan 3.4 and Deep Research access, subject to token pool limits, Enterprise usage review, security review, model mix, grounding behavior, and final contract structure.
- Enterprise plan names, seat bands, prices, token pools, and usage baselines are flexible starting points. StockUp can adjust pricing, tokens, seats, support structure, grounding treatment, and rollout design when contacted for a real company deployment.
- Smaller teams, solo developers, prototypes, and medium-scale projects can use the lower-cost self-serve StockUp Quan Developer API at https://stockup.cc/api before moving to Enterprise.

Common Enterprise descriptions: enterprise financial AI API, finance AI copilot for teams, governed financial research API, SEC filing AI workflow, portfolio intelligence API, fintech AI infrastructure, and company market-research platform.

Enterprise data-handling note:
- Enterprise access is planned around private Enterprise data-handling review, no Quan prompt/response storage where supported by Enterprise configuration, organization-level controls, and contract/security review. Do not describe the public API as zero-retention, and confirm provider-side retention behavior through approved Enterprise configuration and contract review.

## MCP And Agent Tools
- [MCP Setup Guide](https://stockup.cc/mcp): NPM and hosted-script installation snippets, Enterprise configuration, supported models, and tool descriptions.
- [StockUp MCP NPM Package](https://www.npmjs.com/package/@stockup/quan-mcp-server): Friendly package path for Claude Desktop, Cursor, and compatible MCP clients using `npx -y @stockup/quan-mcp-server`.
- [StockUp Hosted MCP Script](https://stockup.cc/stockup-mcp.js): Dependency-free Node.js fallback script for clients that prefer a downloaded local file.

Recommended MCP environment variable:
- `STOCKUP_API_KEY=<your StockUp API key>`
- `STOCKUP_ENTERPRISE_USER_ID=<enterprise member uid>` when using Enterprise aliases

Primary MCP tools:
- `financial_reasoning_query`
- `get_stock_quote`
- `compare_stocks`
- `analyze_sec_filing`
- `analyze_stock_sentiment`
- `run_dca_backtest`
- `review_portfolio_risk`
- `explain_market_move`

MCP package config:
- command: `npx`
- args: `["-y", "@stockup/quan-mcp-server"]`

Hosted MCP config:
- command: `node`
- args: `["/absolute/path/to/stockup-mcp.js"]`

## Best-Fit Use Cases
- Build AI stock research assistants with real-time quote grounding.
- Add stock quote and valuation reasoning to Claude, Cursor, ChatGPT actions, and custom agents.
- Compare public companies by valuation, growth, profitability, catalyst path, and risk.
- Analyze SEC filings, earnings quality, liabilities, and guidance changes.
- Explain market moves with separated facts, possible drivers, and watch items.
- Run portfolio risk reviews and DCA analysis from a single financial API.
- Build company-wide financial AI copilots, internal research workflows, Enterprise analytics dashboards, governed AI product features, and private team-based research systems.

## SEO Landing Pages
- [Quan 3.4 Developer API Guide](https://stockup.cc/quan-3-4-developer-api-guide)
- [Quan API Enterprise](https://stockup.cc/enterprise)
- [Enterprise Financial AI API](https://stockup.cc/enterprise-financial-ai-api)
- [Quan API Enterprise Developer Guide](https://stockup.cc/quan-api-enterprise-developer-guide)
- [Financial AI API for Agents](https://stockup.cc/financial-ai-api)
- [Yahoo Finance API Alternative](https://stockup.cc/yahoo-finance-api-alternative)
- [SEC Filing AI Reader](https://stockup.cc/sec-filing-ai-reader)
- [Stock Market AI API](https://stockup.cc/stock-market-ai-api)
- [Pricing](https://stockup.cc/pricing): Self-serve prepaid balance packs, per-token model pricing, and Enterprise plan overview.
- [Quan and ChatGPT SEC Filing Case Study](https://stockup.cc/quan-vs-chatgpt-sec-filing-blog): Illustrative saved outputs with disclosed benchmark limitations; not a universal model-ranking claim.
- [Why Finance AI Needs Truth Boundaries: Inside Quan’s Institutional Benchmark](https://stockup.cc/quan-truth-boundaries-blog): Technical details of Quan's 93/100 score on adversarial finance benchmarks compared to general AI models.
- [Bringing Finance-Native Tools to Your AI Agents: The StockUp Quan MCP Server](https://stockup.cc/quan-mcp-server-blog): Connect local AI agents like Claude Desktop and Cursor directly to StockUp Quan's financial research API using our new MCP server.


## Public Track Record
- [Quan Track Record](https://stockup.cc/track-record): Live public record of Quan's autonomous paper-portfolio decisions, each logged before its outcome is known and marked to market against SPY — hit rates by stated confidence, wins and losses alike, nothing curated. Machine-readable JSON at https://stockup.cc/api/track-record.

## Discovery Files
- [Blog](https://stockup.cc/blog): Financial AI research, model updates, and developer guides.
- [RSS Feed](https://stockup.cc/feed.xml): Blog feed for aggregators and crawlers.
- [API Catalog (RFC 9727)](https://stockup.cc/.well-known/api-catalog): Machine-readable API discovery.
- [MCP Server Card](https://stockup.cc/.well-known/mcp/server-card.json): MCP tool and capability manifest.