Get v1 dilution score

GET /v1/dilution/score

Per-issuer Dilution Score — singleton view returning the latest dilution rating row for a ticker. Requires ?ticker.

Audience: application and coding agent.

Canonical metadata

• requestId
• traceparent
• verification
• provenance

Query parameters

Param	Type	Description
ticker	string (required)	Issuer ticker. Returns the latest rating row.
view	enum	Response shape (default | compact | agent).

Example request

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

Example response

{
  "object": "dilution_rating",
  "id": "dil_rate_acme_2026q1",
  "ticker": "ACME",
  "overallRisk": "high",
  "offeringAbilityRisk": "high",
  "dilutionRisk": "high",
  "historicalRisk": "medium",
  "cashNeedLevel": "low",
  "warrantExerciseRating": "high",
  "regsho": false,
  "numericScore": 78,
  "factorExposures": {
    "atm_recent": 0.8,
    "warrant_overhang": 0.6,
    "convertible_overhang": 0.5
  },
  "computedAt": "2026-02-13T01:00:00.000Z",
  "verification": {
    "sourceSpan": "rating-engine#acme#2026q1",
    "extractionTraceId": "rate_compute_acme_2026q1",
    "confidence": 0.85,
    "crossValidations": [{ "name": "factor_sum", "passed": true }],
    "modelVersion": "dilution-rating-v2.1",
    "verifiedAt": "2026-02-13T01:00:00.000Z"
  },
  "requestId": "req_example_123",
  "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}

Errors

• 400 missing_ticker — ?ticker is required.
• 404 dilution_score_not_found — no rating row for the ticker yet.

Give this prompt to your agent

CopiedCopy prompt

Failure posture

• treat non-2xx responses as contract-aware failures, not free-form errors
• preserve requestId and traceparent
• on 404 dilution_score_not_found, fall back to GET /v1/dilution/ratings?ticker=… for the historical timeseries