Concepts

Concepts & positioning

The core ideas behind Poseidon's data: what it covers, how scores and severity relate, and the standardized-data framing that governs every response.

Coverage

Poseidon covers four data domains:

Commodities (8). Corn, soybeans, wheat, coffee, sugar, orange juice, cocoa — plus natural gas, scored as weather-driven energy demand.
Crop regions (~23). US, Brazil, Argentina, Black Sea, Australia, Canada, EU.
US grid ISOs (7). ERCOT, CAISO, PJM, MISO, SPP, NYISO, ISO-NE.
Shipping lanes (24). Worldwide chokepoints and export corridors — Suez, Hormuz, Panama, Gulf, Black Sea, and more.
Weather history. Back to 1981.

For the exact, current set of valid IDs, call list_coverage (MCP) or GET /api/v1/grid/coverage (REST) — don't hard-code IDs against this list.

Scoring & severity

Impact and outlook scores are standardized on a 0–10 scale. Alerts also carry a severity band: low, moderate, high, or critical.

Severity and impact_score can diverge

severity (the band) and impact_score (a magnitude) are separate dimensions and can disagree — a low-severity alert can carry a high impact_score. Rank importance by severity, not by impact_score.

The get_alerts response includes a summary with max_severity and counts_by_severity — read those for "highest severity right now" instead of scanning the capped, recency-ordered list.

Positioning

Poseidon publishes standardized data and indices, identically to all subscribers. It is not investment advice and does not make trading recommendations — this keeps the product inside the CFTC publisher's exemption.

Throughout the docs and the tool descriptions, everything is framed as data and indices. Poseidon describes conditions, projections, and standardized indices — never "signals to trade on," buy/sell calls, or advice tailored to an individual user.