Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
GET /v1/signals/dilution

Return the OMNI Dilution Score: factor-weighted 0-100 derived metric with sub-ratings, percentile, and optional rolling history
Audience: application and coding agent.

​
Canonical metadata

  • requestId
  • traceparent
  • provenance
  • freshness
  • methodologyVersion
  • factors
  • subRatings
  • regsho
  • percentile
  • degradedReasons

​
Query parameters

ParamTypeDescription
tickerstringIssuer ticker. Either ticker or cik is required.
cikstringIssuer CIK (10-digit zero-padded). Either ticker or cik is required.
historyenumOptional. 30d | 90d | 1y. Returns rolling timeseries under history[].
viewenumResponse shape (default | compact | agent). agent drops factors[] for token efficiency.

​
Example request

curl -X GET \
  -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  -H "omni-version: 2026-03-19" \
  "https://api.secapi.ai/v1/signals/dilution?ticker=MULN"

​
Example response

{
  "object": "dilution_signal",
  "id": "sig_dil_muln",
  "signalKey": "omni_dilution_score",
  "methodologyVersion": "2026-04-26.1",
  "entityId": "ent_muln",
  "ticker": "MULN",
  "cik": "0001893311",
  "companyName": "Mullen Automotive, Inc.",
  "asOf": "2026-04-26T16:00:00.000Z",
  "score": 88.5,
  "band": "high",
  "confidence": "medium",
  "summaryMd": "## OMNI Dilution Score for Mullen Automotive, Inc.\n\nScore: 88.5 (high). Strongest contributor: Active Offering Pressure.",
  "factors": [
    {
      "key": "active_offering_pressure",
      "label": "Active Offering Pressure",
      "score": 92,
      "weight": 0.30,
      "value": 2,
      "explanation": "Recent (≤90d) offering events sized against market cap; ATM and over-baby-shelf flags add ceiling penalty."
    },
    {
      "key": "cash_runway_pressure",
      "label": "Cash Runway Pressure",
      "score": 90,
      "weight": 0.25,
      "value": 2,
      "explanation": "Inverse of cash-remaining-months capped at 18mo; categorical cash_need bucket sets a floor (acute → 90, high → 70, moderate → 40, low → 10)."
    }
  ],
  "subRatings": {
    "overallRisk": "high",
    "offeringAbilityRisk": "high",
    "dilutionRisk": "high",
    "historicalRisk": "high",
    "cashNeedLevel": "high",
    "warrantExerciseRating": "high"
  },
  "regsho": false,
  "percentile": 95,
  "degradedReasons": [],
  "freshness": {
    "status": "fresh",
    "updatedAt": "2026-04-26T16:00:00.000Z",
    "reason": null
  },
  "provenance": {
    "source": "sec.gov",
    "accessionNumber": "0001234567-26-000099",
    "filingUrl": "https://www.sec.gov/Archives/edgar/data/1893311/000123456726000099/mullen-424b5.htm",
    "retrievedAt": "2026-04-26T16:00:00.000Z",
    "parserVersion": "dilution-score-v1.0"
  }
}

​
Give this prompt to your agent

​
Failure posture

  • treat non-2xx responses as contract-aware failures, not free-form errors
  • preserve requestId and traceparent in logs and downstream reports
  • when confidence is low or freshness.status is stale/degraded, surface the degradedReasons[] to the user verbatim so trust is not lost in the handoff
  • the score is deterministic given (inputs, methodologyVersion); a methodology bump is recorded in the persisted history table without overwriting prior rows