# 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 3.5 Developer Guide](https://stockup.cc/quan-3-5-developer-api-guide): Model id, pricing, what changes from Quan 3.4, curl, JavaScript and Python examples, streaming, billing headers and errors for Quan 3.5.
- [Quan API Enterprise Developer Guide](https://stockup.cc/docs#note-enterprise-admin-developer-setup): 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.
- [About StockUp](https://stockup.cc/about): Who publishes StockUp research, how Quan produces an answer, data sources, review process, and explicit model limitations.

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-nova`, `quan-3.4-l`, `quan-3.4`, `quan-3.5`, `quan-3.4-deep-research`, `quan-nova-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 (on `quan-3.5`, default false)
- `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.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.5`: Newer StockUp model, $5.50/M input and $28.00/M output tokens, no free allowance. Carries tickers and stated limits across a conversation, attaches the latest reported results from SEC filings, and checks short everyday answers before returning them. Returns JSON unless `stream` is true.
- `quan-3.4-deep-research`: Premium model for deep portfolio reviews, SEC filing audits, and multi-step financial research.
- `quan-nova-enterprise`: Quan Nova Enterprise 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: $2.50 per 1M input tokens and $15 per 1M billable output tokens; $3 / $18 from December 15, 2026 at 00:00 Central Time.
- Quan 3.4 Deep Research: $4 per 1M input tokens and $24 per 1M billable output tokens; internal research stages are metered.
- Optional Strut-powered live web grounding: each executed search costs $0.007.
- 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 launch plans:
- Pilot: $199 once for 30 days, $225 usage credit, 1,500 document credits, up to 10 seats.
- Team: $499/month, $600 monthly usage credit, 3,000 monthly document credits, up to 50 seats.
- Business: $1,999/month, $2,500 monthly usage credit, 15,000 monthly document credits, up to 500 seats.
- Custom: from $10,000/month, negotiated usage credit up to +35%, negotiated document credits, any seats.
- All models are included, including Quan 3.5. Usage draws API list prices plus $0.007 per search. Monthly usage credit resets; administrators choose hard stop or list-price overage billed at month end.
- Annual contracts are two months free, invoice net-30. Pilot's $199 counts toward the first Team month if upgraded during the Pilot.
- Coming: single sign-on, audit logs, uptime guarantee and security certification.
- 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/docs#note-enterprise-admin-developer-setup)
- [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.