FR

FinRAG Engine

Citation-Enforced SEC Research Assistant API

Interactive Docs

API Authentication Protocol Active

This API engine enforces security tokens in production. For all API endpoints (excluding /healthz and /docs), you must present your configured FINRAG_API_KEY token inside the X-API-Key or Authorization: Bearer <token> headers.

Core API Endpoints

GET /api/v1/available-filings List ingested SEC filings
Example Request
Copy
curl -X GET https://acxxxy-finrag.hf.space/api/v1/available-filings \
  -H "X-API-Key: YOUR_API_KEY"
POST /api/v1/query Trigger a citation-enforced RAG query
Example Request
Copy
curl -X POST https://acxxxy-finrag.hf.space/api/v1/query \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "query": "What is Apples total net sales for fiscal year 2025?",
    "filters": {
      "ticker": "AAPL",
      "filing_type": "10-K"
    }
  }'
POST /api/v1/ingest Asynchronously ingest SEC filings
Example Request
Copy
curl -X POST https://acxxxy-finrag.hf.space/api/v1/ingest \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "ticker": "AAPL",
    "filing_type": "10-K"
  }'

System Status

2074
Ingested Chunks
5
Active Tickers
Pipeline Engine Active
ChromaDB Store Online
Upstash Cache Online
Neon Postgres Online

Ingested Tickers & Filings

  • AAPL
    10-K Date: 2025-10-31
  • AAPL
    10-Q Date: 2026-05-01, 2026-01-30
  • AAPL
    8-K Date: 2026-04-30, 2026-04-20, 2026-02-24
  • TSLA
    10-K Date: 2026-01-29
  • TSLA
    10-Q Date: 2026-04-23, 2025-10-23
  • TSLA
    8-K Date: 2026-04-22, 2026-04-02, 2026-01-28
  • MSFT
    10-K Date: 2025-07-30
  • MSFT
    10-Q Date: 2026-04-29, 2026-01-28
  • MSFT
    8-K Date: 2026-05-14, 2026-04-29, 2026-01-28
  • GOOGL
    10-K Date: 2026-02-05
  • GOOGL
    10-Q Date: 2026-04-30, 2025-10-30
  • GOOGL
    8-K Date: 2026-05-11, 2026-04-29, 2026-04-10
  • AMZN
    10-K Date: 2026-02-06
  • AMZN
    10-Q Date: 2026-04-30, 2025-10-31
  • AMZN
    8-K Date: 2026-04-29, 2026-04-14, 2026-04-09