REST API

Base URL https://stockpilot-ai.com/api/v1

API access is included with the Quant Developer plan. Create a key from your account. A key is shown once at creation and stored only as a hash — if you lose it, revoke it and make another.

Authentication

Send your key in the X-API-Key header. A missing key returns 401 — it is not silently downgraded to a free tier.

curl https://stockpilot-ai.com/api/v1/layer2/factor-scores/AAPL \
  -H "X-API-Key: sk_live_..."

Rate limits

Limits are per key, per UTC day, and are enforced. Every response carries:

Header	Meaning
`X-RateLimit-Limit`	Your plan's daily allowance
`X-RateLimit-Remaining`	Requests left today
`X-RateLimit-Reset`	When the counter resets (UTC midnight)
`X-Legal-Disclaimer`	Publisher's disclaimer — present on every response

Exceeding the limit returns 429.

Tiers and layers

Each endpoint belongs to a layer. Your plan determines which layers you may call; calling one outside your plan returns 403 with the list you do have. Endpoints that name a ticker also check it against your plan's universe.

Endpoints

GET /pricing-matrixpublic

All plans, prices, trial lengths and daily limits. No key required.

GET /layer1/sec-filings/{ticker}Layer 1

The 25 most recent SEC filings, with direct EDGAR document links built from the company's CIK.

{
  "layer": 1,
  "ticker": "AAPL",
  "company_name": "Apple Inc.",
  "cik": "0000320193",
  "sec_url": "https://www.sec.gov/cgi-bin/browse-edgar?...",
  "filings": [
    { "form_type": "10-Q", "filing_date": "2026-07-31",
      "accession_number": "0000320193-26-000081",
      "document_url": "https://www.sec.gov/Archives/edgar/data/320193/..." }
  ]
}

GET /layer2/factor-scores/{ticker}Layer 2

Composite quant score, universe rank, the 10-model legendary composite and its three outlook horizons.

{
  "layer": 2,
  "ticker": "AAPL",
  "as_of": "2026-08-01",
  "composite_quant_score": 88.0,
  "quant_rank": 14,
  "legendary": { "composite": 76.2, "outlook_short": 0.61,
                 "outlook_medium": 0.58, "outlook_long": 0.64,
                 "confidence": 0.82, "data_completeness": 0.98 },
  "signals": { "earnings_sentiment": 0.71, "filing_quality": 0.88 }
}

GET /layer3/ai-pro-report/{ticker}Layer 3

Publication metadata and an authenticated URL for the full HTML Pro Report. The URL is session-gated, not a static path — it cannot be shared to bypass entitlement.

GET /universeLayer 2

Your plan's entitled universe, ranked by composite score. Query parameters: limit (max 500, default 100) and offset.

Errors

Status	Meaning
`401`	Missing, invalid or revoked key
`403`	Layer or ticker outside your plan
`404`	Unknown ticker, or nothing published for it
`429`	Daily limit exceeded

Publisher's Disclaimer · Terms of Service · support@stockpilot-ai.com