Authentication
All requests require an X-API-Key header with your VectorFin API key. Get your key from app.vectorfinancials.com.
# Get AAPL earnings embeddings for Q3 2024
curl https://api.vectorfinancials.com/v1/embeddings/AAPL \
-H "X-API-Key: vf_sk_your_key_here" \
-G \
-d "fiscal_period=2024-Q3" \
-d "limit=10"
# Response
{
"data": [{
"ticker": "AAPL",
"fiscal_period": "2024-Q3",
"chunk_idx": 0,
"text": "Good afternoon, everyone...",
"embedding": [0.023, -0.091, ...], // 1536 dimensions
"effective_ts": "2024-11-01T00:00:00Z",
"knowledge_ts": "2024-11-02T08:30:00Z",
"model_version": "text-embedding-004"
}],
"next_cursor": "eyJvZmZzZXQiOjEwfQ=="
}Getting Started
AuthenticationAPI key authentication via X-API-Key headerRate limitingPer-plan limits, 429 responses with Retry-AfterPaginationcursor-based pagination on all list endpointsErrorsStandard error codes and messagesEmbeddings API
GET /v1/embeddings/{ticker}List embedding chunks for a tickerGET /v1/embeddings/{ticker}/{fiscal_period}Embeddings for a specific quarterPOST /v1/embeddings/searchSemantic similarity search across all tickersGET /v1/embeddings/filings/{ticker}SEC filing embeddings (10-K/10-Q sections)Signals API
GET /v1/signals/{ticker}All signals for a tickerGET /v1/signals/{ticker}/regimeMarket regime classificationGET /v1/signals/{ticker}/volatilityGARCH volatility forecasts (1d/5d/21d)GET /v1/signals/{ticker}/sentiment_driftEarnings sentiment drift vectorsGET /v1/signals/{ticker}/anomalyAnomaly detection scores and flagsGET /v1/signals/{ticker}/scoreWhyStock composite quant scorePOST /v1/signals/batchBatch signals for up to 500 tickersDelivery
REST APIJSON, all plans. Base URL: api.vectorfinancials.comGCS ParquetStarter+: raw parquet files pushed to your GCS bucketIceberg via PolarisPro+: Polaris REST catalog at catalog.vectorfinancials.comBigQuery Analytics HubPro+: shared datasets via Analytics HubSnowflake MarketplacePro+: native Iceberg tables in Snowflake