The Vantafin REST API lets you pull the same data you see in the app - quotes, fundamentals, SEC filings, corporate actions, ownership, short interest, insider transactions, macro, and news - into your own code, spreadsheets, or apps. This guide covers the basics; the full endpoint reference lives in the API docs. You will need an API key (Pro or Ultimate).
Base URL and authentication
All REST calls go to the versioned base URL and carry your key:
curl "https://api.vantafin.com/v1/..." \
-H "Authorization: Bearer vf-live-YOUR_KEY"
See Create and use an API key for the three ways to authenticate.
What you can pull
| Category | Examples |
|---|---|
| Company data | Ticker search; CIK/ISIN/CUSIP lookup |
| Market data | Quotes |
| Screener | Programmatic screening |
| Corporate actions | Earnings, dividends, splits, IPOs |
| Ownership | Institutional holders, ETF/fund holdings |
| Fundamentals | Income statement, balance sheet, cash flow, segments |
| Filings | SEC filings |
| News | Market and per-ticker |
| Macro | Economic series |
The interactive reference and the machine-readable spec are on the docs site; you can view the OpenAPI JSON at https://api.vantafin.com/v1/openapi.json.
A first request in Python
import os
import requests
API_KEY = os.environ["VANTAFIN_API_KEY"]
BASE = "https://api.vantafin.com/v1"
resp = requests.get(
f"{BASE}/...", # see the docs for the exact endpoint
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=30,
)
resp.raise_for_status()
data = resp.json()
print(data)
Replace the path with the endpoint you need from the reference. Official client libraries (Python, JavaScript, Go, Java, Ruby) are also available - see the SDKs to skip the boilerplate.
Handle rate limits gracefully
Requests are capped per minute by plan and logged. Build in:
- Backoff and retry on rate-limit responses.
- Caching of data that does not change often (like historical fundamentals).
- Batching where an endpoint supports multiple symbols.
Check your limits in Settings.
From API to AI
If your end goal is to feed an AI assistant, you may not need to write REST code at all - the MCP server exposes Vantafin data as tools your assistant can call directly.