HomeChatAlertsCalendarScreenerWatchlistsFiles
DocsSettings
Sign upJoinLog in

Docs

Overview

IntroductionMCP ServerOpenAPI Spec

REST API

WebSocket

Live 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.

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 on PyPI and npm

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.

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

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.
MCP Server