Authenticating Session...

Corporate Tier API & Methodology Documentation

Comprehensive technical reference for integrating global T+5 predictive spatial likelihood grids (fishing, dark hull, and AIS-spoofed vessel activity), the 8-Zone Physical Flashpoint Anomaly Index (T-2 consolidated baseline), and CFTC-regulated event-contract market divergence spreads into your operational intelligence or quantitative workflows.

Authentication & Subscription Verification

All Corporate Tier API endpoints validate your provisioned API key generated in the Corporate Dashboard. Simply click Generate Key in the Developer API Access section of your dashboard, copy the generated API key string, and pass it in your request header.

Supported Request Header Formats

You may pass your Corporate API key using either a standard Bearer authorization header or the x-api-key header:

# Option 1: Authorization Bearer Header
Authorization: Bearer YOUR_API_KEY_HERE

# Option 2: x-api-key Header
x-api-key: YOUR_API_KEY_HERE

Global T+5 Spatial Grid Forecast

27,186 Grid Polygons

Retrieve the global T+5 forward likelihood across 27,186 oceanic grid cells. Due to the large size of the uncompressed GeoJSON payload, the endpoint returns a JSON envelope containing a high-speed, pre-signed S3 stream URL valid for 15 minutes (900 seconds).

GET https://api.androai.us/v1/target-prediction
Alias: /v1/spatial-grid

Example Request

curl -X GET "https://api.androai.us/v1/target-prediction" \
     -H "Authorization: Bearer YOUR_API_KEY_HERE"

JSON Response Envelope

{
  "status": "large_payload_presigned_stream",
  "file_size_bytes": 47435483,
  "expires_in_seconds": 900,
  "geojson_url": "https://fishing-heat-map-public-1.s3.amazonaws.com/inference_all_time_columns/inference_stage_1.geojson?AWSAccessKeyId=..."
}

GeoJSON Feature Properties Schema

Executing a GET request against geojson_url streams a standard GeoJSON FeatureCollection (CRS84 / EPSG:4326) where each grid polygon contains the following predictive indicators:

Property Type Description
score_fishing Float (0.0 – 1.0) T+5 predicted likelihood of concentrated fishing fleets or dual-use maritime militia swarms inside the grid cell.
score_dark Float (0.0 – 1.0) T+5 predicted likelihood of non-broadcasting ("dark") vessels operating with suppressed AIS transponders detected via SAR.
score_ghost Float (0.0 – 1.0) T+5 predicted likelihood of electronic warfare (EW) AIS spoofing, circle-spoofing, or falsified MMSI positional broadcasts ("ghost" vessels).

Physical Flashpoint Anomaly Index

Defense & Security Feed

Built for defense and maritime security workflows that only need physical vessel and satellite anomaly scores without prediction-market odds. Returns 8 strategic maritime zones scored from 0.0 to 100.0 on the consolidated T-2 baseline date alongside the T+5 prediction.

GET https://api.androai.us/v1/flashpoints/physical

Example Request

curl -X GET "https://api.androai.us/v1/flashpoints/physical" \
     -H "x-api-key: YOUR_API_KEY_HERE"

JSON Response Structure

{
  "date": "2026-10-25",
  "forecast_horizon": "T+5",
  "feed_type": "physical_defense_security",
  "flashpoints": [
    {
      "zone_id": "FP-HORMUZ",
      "name": "Strait of Hormuz",
      "date": "2026-10-25",
      "bbox": [54.0, 24.0, 58.2, 27.5],
      "center": [56.2, 26.1],
      "zoom": 5.8,
      "primary_layer": "ghost",
      "primary_property": "score_ghost",
      "driver_label": "AIS Spoofing & Dark Tankers",
      "t_minus_2_score": 85.4,
      "t_plus_5_delta": "+17.0%",
      "regime": "HIGH_FRICTION",
      "color": "#f43f5e",
      "metrics": {
        "observed_vessels": 42,
        "dark_hulls": 11,
        "spoofed_hulls": 24,
        "catalyst_severity": 0.88
      }
    }
  ]
}

Event-Contract Market Divergence Index

Event-Contract & Macro Feed

Pairs the 8-Zone Physical Flashpoint Anomaly Index (T-2 baseline + T+5 prediction) with live implied probabilities from CFTC-regulated event contracts (Kalshi) to quantify physical-vs-market divergence spreads.

GET https://api.androai.us/v1/flashpoints/market-divergence

Example Request

curl -X GET "https://api.androai.us/v1/flashpoints/market-divergence" \
     -H "Authorization: Bearer YOUR_API_KEY_HERE"

JSON Response Structure

{
  "date": "2026-10-25",
  "forecast_horizon": "T+5",
  "feed_type": "event_market_divergence",
  "flashpoints": [
    {
      "zone_id": "FP-HORMUZ",
      "name": "Strait of Hormuz",
      "date": "2026-10-25",
      "bbox": [54.0, 24.0, 58.2, 27.5],
      "center": [56.2, 26.1],
      "zoom": 5.8,
      "primary_layer": "ghost",
      "primary_property": "score_ghost",
      "driver_label": "AIS Spoofing & Dark Tankers",
      "t_minus_2_score": 85.4,
      "t_plus_5_delta": "+17.0%",
      "regime": "HIGH_FRICTION",
      "color": "#f43f5e",
      "kalshi_contract": "Hormuz Transit Disruption",
      "kalshi_yes_prob": 22.0,
      "divergence_spread_pts": 63.4,
      "divergence_signal": "PHYSICAL_ELEVATED_VS_MARKET"
    }
  ]
}

Temporal Architecture: T-2 Consolidated Baseline vs. T+5 Forecast

The Corporate Tier dashboard and API deliver two distinct dates to maintain strict analytical separation between observed physical reality and the prediction:

Flashpoint Index Date (T-2 Baseline)

48-Hour Multi-Pass Data Consolidation

Global Synthetic Aperture Radar (SAR) detections, terrestrial and satellite AIS telemetry, and NGA NAVAREA / GDELT CAMEO geopolitical catalysts undergo multi-pass aggregation, sea-ice false-positive scrubbing, and spatial correlation across a 48-hour data consolidation window. The T-2 Anomaly Score (0–100) reflects the consolidated SAR-to-AIS vessel anomaly and navigational interference baseline for that observation date.

Forecast Date (T+5 Projection)

5-Day Forward Spatio-Temporal Projection

Powered by Andromeda AI's analytics engine, the platform projects fleet staging concentrations 5 days forward from the current day. The T+5 Delta (e.g., +17.0%) measures the percentage expansion or contraction of high-probability grid cells (score ≥ 0.50) inside each strategic flashpoint bounding box over the upcoming 5-day operational window.

T-2 Physical Flashpoint Composite Formula (0 – 100 Scale)

For each strategic basin z, the daily physical anomaly score Sz, t-2 ∈ [0, 100] is computed as a weighted composite of four normalized physical sub-indices relative to the zone's 30-day rolling baseline:

Sz, t-2 = clip( 0.35 · Zdark + 0.35 · Zghost + 0.15 · Zswarm + 0.15 · Ccatalyst , 0, 100 )
70.0 – 100.0 (HIGH_FRICTION)
Severe EW AIS spoofing, active blockade/interdiction posturing, or kinetic corridor avoidance.
55.0 – 69.9 (ELEVATED)
Above-trend shadow tanker staging, dark STS transfers, or militia reef congregation.
0.0 – 54.9 (MODERATE)
Normal seasonal commercial transit and fishing baseline.

8 Strategic Flashpoint Zones Reference

Each regional flashpoint is bounded by a calibrated geographic box, linked to the primary predictive layer (score_fishing, score_dark, or score_ghost) that historically precedes kinetic, regulatory, or supply-chain disruptions in that basin, and paired with its corresponding CFTC-regulated event contract benchmark:

Zone ID Strategic Basin Bounding Box [minLon, minLat, maxLon, maxLat] Primary Layer Core Physical Anomaly Driver Mapped Event-Contract Benchmark (YES %)
FP-HORMUZ Strait of Hormuz [54.0, 24.0, 58.2, 27.5] score_ghost EW AIS circle-spoofing & sanctioned dark crude tanker staging Hormuz Transit DisruptionPrices whether commercial tanker or maritime transit through the Strait of Hormuz is halted, interdicted, or materially disrupted.
FP-TAIWAN Taiwan Strait & Median [117.0, 21.8, 122.2, 26.2] score_fishing Dual-use maritime militia swarms, median-line loitering & dark escort hulls Taiwan Quarantine / Blockade ActionPrices whether a maritime customs quarantine, inspection regime, or military blockade of Taiwan is instituted.
FP-REDSEA Bab el-Mandeb & Red Sea [41.0, 11.5, 45.5, 16.8] score_dark Defensive AIS transponder deactivation through kinetic hazard corridors Red Sea Commercial Transit HaltPrices whether major commercial shipping lines halt transits or face severe kinetic strikes in the Bab el-Mandeb / Red Sea corridor.
FP-SCS South China Sea (Spratlys) [111.5, 8.0, 118.5, 16.5] score_fishing Contested reef anchorage swarming & localized AIS identity spoofing SCS Maritime ConfrontationPrices whether a direct maritime confrontation, vessel ramming, or armed interdiction occurs around contested Spratly reefs/shoals.
FP-BLACKSEA Black Sea & Kerch Approach [28.0, 41.5, 38.5, 46.8] score_ghost Wide-area EW GPS spoofing & dark grain/crude terminal approaches Black Sea Maritime Corridor StrikePrices whether commercial grain/energy vessels, port terminals, or the Kerch Strait approach suffer a kinetic strike or closure.
FP-BALTIC Danish & Baltic Straits [9.5, 53.8, 21.5, 59.5] score_dark Shadow fleet crude transits & anomalous loitering near subsea cables/pipelines Baltic Shadow Tanker Seizure/SanctionPrices whether coastal states detain, board, or enforce new sanctions interdictions on shadow-fleet tankers or subsea infrastructure incidents in the Baltic/Danish Straits.
FP-CARIB Venezuelan EEZ & Caribbean [-71.5, 9.5, -59.5, 14.5] score_dark Sanctions-evading dark ship-to-ship (STS) crude transfers & MMSI masking Venezuela Sanctions / Tanker EnforcementPrices whether energy licenses are revoked, oil sanctions are tightened, or sanctioned dark tankers operating in the Venezuelan EEZ are interdicted.
FP-MALACCA Strait of Malacca & Riau [98.0, 1.0, 104.8, 6.2] score_dark East Johor / Riau dark floating storage anchorage & chokepoint queuing Malacca Turnstile Congestion ShockPrices whether severe chokepoint queuing, regulatory detention of dark STS tankers off Riau/East Johor, or a navigation bottleneck disrupts Malacca transit velocity.

Note: Event-contract benchmarks reflect publicly traded implied probabilities from CFTC-regulated Designated Contract Markets (Kalshi) and are provided strictly as open-source financial market reference indicators.

Event-Contract Market Divergence Methodology

When the optional CFTC Event Market Odds Overlay is toggled on in the dashboard (or queried via /v1/flashpoints/market-divergence), Andromeda AI compares each zone's physical anomaly score against the implied probability (0% – 100% YES) of corresponding maritime and geopolitical disruption contracts traded on CFTC-regulated prediction markets (Kalshi).

Divergence_Spread_Pts = T_Minus_2_Physical_Anomaly_Score − Kalshi_Implied_YES_Prob
Divergence Regime Spread Threshold Analytical Interpretation
PHYSICAL_ELEVATED_VS_MARKET ≥ +20.0 pts Physical SAR and AIS anomaly buildup (dark hull concentration, AIS spoofing, and T+5 predicted staging) is significantly elevated relative to public prediction-market pricing—indicating potential unpriced physical friction on the water.
CONVERGENT_PRICING -15.0 to +19.9 pts Physical maritime telemetry and event-contract implied odds are broadly aligned.
MARKET_OVERPRICED_VS_PHYSICAL ≤ -15.0 pts Prediction markets are pricing high headline disruption risk without corroborating physical fleet anomalies or EW spoofing in the maritime corridor.