# Introduction

A single REST API for every dataset Vantafin offers - company data, quotes, corporate actions, ownership, fundamentals, SEC filings, news, earnings transcripts - plus real-time WebSocket streams for per-second and per-minute live quotes and trading halts. Authenticate with your API key and start making requests in seconds.

## Base URL

`https://api.vantafin.com/v1`

## WebSocket

`wss://socket.vantafin.com/v1/stocks` - subscribe to per-second live quotes (`LS.{ticker}`), per-minute live quotes (`LM.{ticker}`), live news (`N.{ticker}` or `N.*`), live SEC filings (`F.{ticker}` or `F.*`), and trading halts (`H.{ticker}` or `H.*`).

## Authentication

Pass `?apiKey=YOUR_KEY` or header `Authorization: Bearer YOUR_KEY`. For WebSocket connections, pass `?apiKey=YOUR_KEY` or send `{"action":"auth","key":"YOUR_KEY"}` as the first message.

## Rate limit

1,000 requests per minute per key. Responses include `X-RateLimit-*` headers.

## Python client

```
pip install vantafin
```