ATHENA · Analysis

ATHENA base URL: https://athena-api.trinitytrade.io

A public GET to / returns JSON with name, version, and status.

This page documents public GET /health and authenticated GET /api/v1/results/analysis/{symbol} on the ATHENA host. The try-it control uses a read-only demo route on the TRINITY API host for symbol MSFT only. Use the sections below for paths, parameters, example curls, and sample responses.

Production access. Demos are for evaluation. For authenticated APIs, tokens, quotas, and SLAs, contact [email protected].

Endpoints

GET

Health

/health

Returns a small JSON status payload so you can confirm the API is reachable.

Auth: None — /health is public on the ATHENA production host.

Responses

Status Description
200 JSON with status, version, timestamp
503 Unavailable

Example

export ATHENA_API="${ATHENA_API:-https://athena-api.trinitytrade.io}"
curl -sS "$ATHENA_API/health"
GET

Get analysis results

/api/v1/results/analysis/{symbol}

Single-symbol analysis snapshot: Weinstein stage, indicators, patterns, regime, and related fields. Without query params, returns the latest stored document; omit date for the default latest slice.

Production ATHENA. Direct calls to the ATHENA host need credentials we provide after you register as a partner developer (the curl is illustrative). Run request uses a read-only demo path on the TRINITY API host for symbol MSFT only—the same envelope as production (AnalysisResultResponse), with a demo-safe subset of result fields (see schema). The date query param is ignored for unauthenticated demo traffic; latest only.

Auth: Analysis routes on the ATHENA host require approved access. Exact headers and flows are documented when you onboard as a partner developer.

Parameters

Name In Type Required Description
symbol path string Yes Ticker (interactive demo uses MSFT only).
date query string No Optional calendar date <code>YYYY-MM-DD</code> for a historical Firestore slice; omit for latest results. <strong>Authenticated</strong> calls only—ignored in demo / unauthenticated mode (always latest).

Responses

Status Description
200 AnalysisResultResponse — success, timestamp, result object
404 No stored analysis for symbol (or date)
401 Missing or invalid authentication
500 Server error

Example

export ATHENA_API="${ATHENA_API:-https://athena-api.trinitytrade.io}"
# Bearer value and any other required headers are provided after partner onboarding.
export ATHENA_TOKEN="your_access_token"
curl -sS -H "Authorization: Bearer $ATHENA_TOKEN" \
  "$ATHENA_API/api/v1/results/analysis/MSFT"
# Optional historical slice:
# curl -sS -H "Authorization: Bearer $ATHENA_TOKEN" \
#   "$ATHENA_API/api/v1/results/analysis/MSFT?date=2026-01-15"
Sample JSON response 
{
  "success": true,
  "timestamp": "2026-04-08T16:30:00.000000",
  "result": {
    "stage": "Stage 2",
    "stage_strength": "STRONG",
    "price": 190.42,
    "volume": 52000000,
    "indicators": {
      "rsi": 58.2,
      "sata_score": 6
    },
    "detected_patterns": [],
    "market_regime": "bull",
    "sector": "Technology",
    "analysis_date": "2026-04-07",
    "analysis_timestamp": "2026-04-07T21:15:00Z"
  },
  "error": null
}

AnalysisResultResponse

Response body for GET /api/v1/results/analysis/{symbol} on ATHENA (response_model=AnalysisResultResponse in the API). The interactive Run request panel shows a real payload with this structure; field presence varies slightly by symbol and pipeline version.

Show full AnalysisResultResponse field reference (tables)

Root object

Field Type Description
success boolean true when the snapshot was returned successfully.
timestamp string (ISO-8601) Server time when the response was built (not necessarily the analysis run time).
result object Analysis snapshot from Firestore (AnalysisLatestResult). See the table below.
error string or null Error message when success is false; otherwise null.

result — AnalysisLatestResult

Demo / unauthenticated responses only include the fields below that ATHENA exposes in public demo mode (no risk_parameters, transition_probabilities, or ad-hoc Firestore extras). Authenticated production responses may include those additional keys and the full document shape.

Field Type Description
stage string or object Weinstein-style stage label or structured stage payload.
stage_strength string, number, or null Qualitative or numeric strength of the current stage.
price number or null Reference price (typically last close used in the analysis).
volume integer or null Volume associated with the analysis bar.
indicators object or null Technical indicators (nested structure; often includes keys like RSI, SATA scores, moving averages).
detected_patterns array or null List of PatternEntry objects (pattern type, dates, confidence, target, etc.).
best_pattern object or null Single PatternEntry highlighted as primary.
pattern_signal object or null Aggregated pattern bias (PatternSignalModel): direction, net/bull/bear confidence.
price_targets array of objects or null Derived price target structures from pattern / stage logic.
support_levels array of numbers or null Support prices.
resistance_levels array of numbers or null Resistance prices.
recent_patterns array or null Recent PatternEntry items (shorter horizon than detected_patterns).
best_recent_pattern object or null Top recent PatternEntry.
recent_pattern_signal object or null PatternSignalModel for recent patterns.
market_regime string or null High-level regime (e.g. bull / bear / sideways).
sector string or null Equity sector classification.
signal string, object, or null Composite or human-readable signal summary.
confidence number or null Overall confidence score where applicable.
ml_signal string, object, or null ML-derived signal payload.
enhanced_signal string, object, or null Enriched / blended signal (e.g. rules + ML).
analysis_date string or null Calendar date of the analysis (often YYYY-MM-DD).
analysis_timestamp string or null Finer-grained timestamp when the analysis was produced.
timestamp string or null Legacy or alternate document timestamp from Firestore.
risk_parameters object or null Authenticated only. Stops, sizing hints, etc.—omitted in public demo responses.
transition_probabilities object or null Authenticated only. Stage transition model outputs—omitted in demo.

PatternEntry (elements of pattern arrays)

Field Type Description
type string Pattern classifier name.
status string or null Lifecycle state (e.g. active, completed).
start_date / end_date string or null Pattern span in ISO date strings when available.
confidence number or null Detector confidence.
price_target number or null Pattern-implied price level.

Pattern objects may include additional keys from the pipeline (extra fields allowed in the API model).