The Wealthnow API serves live US equity quotes, 1-minute bars and trade prints to your code over REST and server-sent events (SSE), and the same data to AI agents through a hosted MCP server. One wn_ key, one credit wallet, and an OpenAPI 3.1 spec. Real-time where licensed, and every response says how fresh it is.
What does the Wealthnow stock market data API return?
A quote call returns the last print, the bid and ask when the session has a book, sizes, day volume, previous close, change and the current US market session (pre, open, post or closed, from the exchange calendar). Every quote carries meta.as_of, so your code can tell a fresh price from an old one. Beyond quotes, the same key reaches fundamentals and financial statements, SEC filings, and, on higher plans, congressional trades, 13F and insider data, news sentiment, macro series, options flow and private-markets data: 300+ REST endpoints across 22 data products.
How do I get a live quote?
Create a free key, then send it as X-API-Key or Authorization: Bearer wn_...:
curl -H "X-API-Key: wn_YOUR_KEY" \
https://firm.wealthnow.io/api/market/quote/AAPLThe quote endpoint is on the Free plan. The full list of endpoints, parameters and response shapes is in the OpenAPI 3.1 spec and the quickstart.
Which real-time streams are available?
Starter and above add three server-sent event streams for US equities:
- Quotes (
/api/v3/stream/quotes): per-venue bid and ask events for the symbols you request. - 1-minute bars (
/api/v3/stream/bars): live OHLCV and VWAP candles for every US-listed ticker, each closed a few seconds after the minute ends. - Trades (
/api/v3/stream/ticks): live US equity trade prints.
curl -N -H "X-API-Key: wn_YOUR_KEY" \
"https://firm.wealthnow.io/api/v3/stream/bars?symbols=AAPL,NVDA"Streams are quiet outside US market hours, which is expected. For chart history, use the REST aggregates rather than a stream.
Can AI agents like Claude and ChatGPT use the same data?
Yes. The hosted MCP server at https://mcp.wealthnow.io/mcp exposes the REST endpoints as tools with the same names as the OpenAPI operationIds, the same plan access and the same credit costs. Claude, ChatGPT, Cursor, VS Code and Codex connect by signing in with OAuth, so there is no key to paste. Every tool is read-only. The SSE streams stay on REST, because MCP cannot relay a stream. Setup for each client: connect Claude, ChatGPT or Cursor to stock market data.
How much does it cost?
Each plan includes a monthly credit grant. Free stops at its grant; paid tiers can spend into metered overage. Annual billing is two months free.
| Plan | Price | Credits a month | Rate limit |
|---|---|---|---|
| Free | $0 | 1,000 | 30 req/min |
| Starter | $99/mo | 250,000 | 120 req/min |
| Pro | $499/mo | 2,000,000 | 600 req/min |
| Expert | $999/mo | 11,200,000 | 1,500 req/min |
Free covers market data, fundamentals and public filings. Starter adds the real-time SSE streams, congressional trades, funds, institutional and insider data, news and macro. Details: API pricing and credits.
Frequently asked
Is there a free stock market data API?
Yes. The Wealthnow Free plan includes 1,000 credits a month at 30 requests per minute, with no card required, and covers market data, fundamentals and public filings, including the quote endpoint.
Is the data real-time?
Real-time where licensed. Every quote states when its last trade happened (meta.as_of), and the SSE streams deliver live quotes, 1-minute bars and trades for US equities on Starter and above. It is not a terminal feed.
Which markets are covered?
The real-time streams cover US equities. The REST API also serves crypto quotes, macro, rates, FX and commodities data on the plans that include them.
Is there an OpenAPI spec?
Yes, an OpenAPI 3.1 document at https://firm.wealthnow.io/api/openapi.json. MCP tool names match its operationIds.
Can I use the API to place trades?
No. The API and MCP server are read-only data. Nothing places orders or moves money.
