HomeChatAlertsCalendarScreenerWatchlistsFiles
Docs
Sign upJoinLog inLogin

Docs

Overview

IntroductionMCP ServerOpenAPI Spec

REST API

Overview

WebSocket API

OverviewLive Quotes (Per Second)Live Quotes (Per Minute)Live NewsLive SEC FilingsTrading Halts

Introduction

View as markdown

One API for US equities and ETFs - company profiles, live quotes, fundamentals, SEC filings, news, earnings transcripts, and real-time WebSocket streams. Authenticate with your Vantafin API key and call https://api.vantafin.com/v1 from any language, or plug the MCP server into Claude, Cursor, and other agent tools. REST for request/response workflows; WebSocket for sub-second market data; MCP for tool-using agents.

Important disclaimer
Vantafin data is for informational purposes only and is not investment advice. Quotes, fundamentals, filings metadata, and other fields may be delayed, incomplete, or incorrect. Independently verify critical information before trading. See the Terms of Service.
Get your API keyCreate or copy a vf-live-… key from Settings → API Usage.Make your first requestFetch a live quote for any supported ticker in one GET call.Connect via MCPGive agents typed tools for quotes, filings, financials, and more.

What is the Vantafin API?

The Vantafin API is a hosted data platform for US-listed stocks, ETFs, and funds. It exposes the same datasets that power the Vantafin web app - reference data, market snapshots, corporate actions, ownership, fundamentals, regulatory filings, and news - through a stable REST surface, optional real-time WebSocket channels, and an MCP server for AI agents.

Who is it for? Developers building trading tools, research dashboards, alerting systems, and agent workflows who want institutional-grade market data without operating their own ingestion pipelines.

  • REST-first: predictable JSON, cursor pagination, OpenAPI schema
  • Real-time: per-second and per-minute quote streams, live filings and news
  • Agent-ready: MCP tools map directly to the same datasets as the REST API
  • Official clients: Python, JavaScript, Go, Java, and Ruby SDKs - source on github.com/vantafin/vantafin

What do you need? A Vantafin account, an API key, and your HTTP client of choice. The Python client is the fastest path: pip install vantafin, or browse the SDKs on github.com/vantafin/vantafin.

How it works

Your application or agent calls the Vantafin API over HTTPS (or opens a WebSocket for streams). Vantafin handles authentication, rate limits, and routing to the underlying quote store, company profiles index, filing corpus, and sync jobs - you work with clean JSON responses.

Your stackApp, agent, or notebookPython · JavaScript · curl · MCP clients
Vantafin APIREST · WebSocket · MCPapi.vantafin.com · socket.vantafin.com
DatasetsQuotes · profiles · filingsFinancials · news · transcripts · live streams

Key capabilities

Company profilesIssuer reference data - sector, CIK, ISIN, CUSIP, description, and officers.Live quotesLast price, change, volume, day range, market cap, and shares.WebSocket streamsSubscribe to per-second quotes, news, SEC filings, and trading halts.SEC filingsEDGAR metadata by ticker; fetch full filing details by Vantafin id.Financial statementsIncome statement, balance sheet, and cash flow - annual or quarterly.NewsMarket-wide and ticker-specific headlines and press releases.Corporate actionsEarnings, dividends, and splits with actuals vs estimates.Earnings transcriptsList and retrieve full earnings call transcript text.Batch quotesUp to 200 tickers in one request for watchlists and dashboards.Institutional ownershipETFs and funds holding a stock, with weights and as-of dates.Short interestFINRA short volume and days-to-cover for equity tickers.Revenue segmentationProduct and geographic revenue breakdown by fiscal period.

Quick start

  1. Install the Python client
    pip install vantafin
  2. Copy your API key

    Open Settings → API Usage and copy your vf-live-… key.

  3. Fetch a quote
    from vantafin import RESTClient

client = RESTClient("vf-live-your_api_key")
print(client.get_quote("AAPL"))

    Prefer curl? See the Quote endpoint for a ready-made sample.

  4. Stream live data (optional)

    Connect to wss://socket.vantafin.com/v1/stocks, authenticate with your API key, and subscribe to a channel such as LS.AAPL for per-second quotes. See Live Quotes (Per Second).

Reference

Base URL
https://api.vantafin.com/v1
WebSocket
wss://socket.vantafin.com/v1/stocks
Authentication
Pass ?apiKey=YOUR_KEY, header Authorization: Bearer YOUR_KEY, or X-API-Key: YOUR_KEY.
Rate limit
1,000 requests per minute per key. Responses include X-RateLimit-* headers.
Python client
pip install vantafin
Official SDKs
github.com/vantafin/vantafin

Start here

Jump to the guides and endpoints most teams reach for first.

All tickersWalk the full supported universe with cursor pagination.Company profile (search)Resolve a company name or CIK to full profile rows.OpenAPI specMachine-readable schema for codegen and API explorers.Live SEC filingsWebSocket stream pushed when new EDGAR filings are indexed.Batch quotesUp to 200 tickers in one request for watchlists and dashboards.MCP serverStreamable HTTP MCP endpoint and tool reference for agents.SDKs on GitHubOfficial Python, JavaScript, Go, Java, and Ruby client source.

Frequently asked questions

Last updated: 2026-07-31

What APIs does Vantafin offer?
Vantafin developer docs cover the REST API, WebSocket streams, and MCP server for affordable financial data. Authenticate with an API key, call typed JSON endpoints for quotes, profiles, filings, and more, or connect Claude and Cursor through MCP on Pro or Ultimate. WebSocket streaming is exclusive to the Ultimate plan.
How do I authenticate to the Vantafin API?
Use your vf-live API key from Settings → API Usage as a query parameter (apiKey), Authorization Bearer token, or X-API-Key header. Keys require a Pro or Ultimate plan.
How do I connect Claude or Cursor to Vantafin?
Subscribe to Pro or Ultimate, create an API key, then add the Vantafin MCP server to your client config. Full setup steps are in the MCP Server docs.
MCP Server