Authentication

All requests require an X-API-Key header with your VectorFin API key. Get your key from app.vectorfinancials.com.

bash

# Get AAPL earnings embeddings for Q3 2024 (fiscal_period is required)
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: a JSON array of EmbeddingRecord
[
  {
    "ticker": "AAPL",
    "fiscal_period": "2024-Q3",
    "chunk_idx": 0,
    "embedding": [0.023, -0.091, 0.142, ...],  // 768 dimensions
    "effective_ts": "2024-11-01T00:00:00Z",
    "knowledge_ts": "2024-11-02T08:30:00Z",
    "model_version": "gemini/gemini-embedding-2-preview"
  }
]