Authenticating Session...

API Documentation

Comprehensive reference for ingesting structured daily fishing volume, global energy chokepoint flow volumes (including Cryogenic LNG BOE isolation), Rolling Dark Fleet Beta multipliers, Chokepoint Effective Transit Velocity (ETVI) freight indices, and decaying geopolitical/navigational hazard & OFAC sanctions telemetry directly into your commodities and shipping trading algorithms.

1. Gridded Tonnage Data Extraction

GeoJSON & parquet.gzip

Retrieve the complete global fishing capacity for a specific historical date. Represents aggregated fishing capacity per distinct geographic grid cell, available in spatial GeoJSON or columnar parquet.gzip formats.

GET https://api.androai.us/quant-finance-data/gridded-tonnage
?target_date=YYYY-MM-DD&format=geojson|parquet

Authentication

Requests must be authenticated using your provisioned API key passed in the headers.

x-api-key: YOUR_API_KEY_HERE
Content-Type: application/json

Query Parameters

Parameter Type Required Description
target_date String Yes The historical date to retrieve, formatted as YYYY-MM-DD (available up to T-2 days).
format String Optional Specify geojson (default) for spatial polygon features, or parquet for high-speed tabular ingestion (.parquet.gzip).

Response Payload

To accommodate large datasets without hitting API Gateway payload limits, the endpoint returns a JSON payload containing a secure, time-limited S3 pre-signed download URL valid for 1 hour (3600 seconds). 

{
    "status": "success",
    "target_date": "2026-10-25",
    "dataset": "gridded_tonnage",
    "format": "parquet.gzip",
    "download_url": "https://hedge-fund-data-730460775114-us-east-1-an.s3.amazonaws.com/quantitative-data/gridded-tonnage/2026/10/25/gridded_tonnage_20261025.parquet.gzip?AWSAccessKeyId=...",
    "expires_in_seconds": 3600
}

2. Row-Level Vessel Activity Extraction

parquet.gzip Only

Retrieve the underlying deduplicated vessel-level activity table for a specific historical date. Includes coordinates, timestamps, physical dimensions, and both raw and penalized Gross Tonnage (GT) for verified fishing vessels, dark vessels, and spoofed ghost vessels.

GET https://api.androai.us/quant-finance-data/vessel-activity
?target_date=YYYY-MM-DD

Query Parameters

Parameter Type Required Description
target_date String Yes The historical date to retrieve, formatted as YYYY-MM-DD (available up to T-2 days).

Response Payload

{
    "status": "success",
    "target_date": "2026-10-25",
    "dataset": "vessel_activity",
    "format": "parquet.gzip",
    "download_url": "https://hedge-fund-data-730460775114-us-east-1-an.s3.amazonaws.com/quantitative-data/vessel-activity/2026/10/25/vessel_activity_20261025.parquet.gzip?AWSAccessKeyId=...",
    "expires_in_seconds": 3600
}

3. Energy Chokepoints, Rolling Dark Fleet Beta & Geopolitical Decay

JSON

Retrieve the daily macro global energy transit summary and corridor throughput volumes across 9 critical global maritime chokepoints (Strait of Malacca, Strait of Hormuz, Suez Canal, Bab el-Mandeb, Cape of Good Hope, Panama Canal, Strait of Gibraltar, English Channel/Dover, and Danish Straits/Baltic). Includes the calibrated Rolling Dark Fleet Beta, interim event-driven dark evasion uplift, separated commodity breakdowns (VLCC Crude, Cryogenic LNG Carriers, Suezmax/Aframax Crude, and MR Clean Products), and each strait's active Geopolitical Catalyst Context with a 5-Day Forward Exponential Hazard Decay Curve.

GET https://api.androai.us/quant-finance-data/energy-chokepoints
?target_date=YYYY-MM-DD

Query Parameters

Parameter Type Required Description
target_date String Yes The historical date to retrieve, formatted as YYYY-MM-DD (available up to T-2 days).

Downloaded JSON Payload Structure (Sample from S3 Pre-Signed URL)

{
    "date": "2026-10-25",
    "global_energy_summary": {
        "total_unique_energy_vessels": 44,
        "global_ais_lit_tanker_count": 20,
        "global_sar_dark_and_ghost_tanker_count": 24,
        "global_lng_carrier_count": 1,
        "global_implied_dark_fleet_beta": 2.3627,
        "global_ais_unadjusted_barrels": 6000000.0,
        "global_sar_observed_dark_barrels": 8176000.0,
        "global_total_barrels_in_transit": 14176000.0,
        "total_ofac_sanctioned_vessels_tracked": 2159,
        "total_active_maritime_hazard_events": 468,
        "global_commodity_breakdown_barrels": {
            "vlcc_crude_bbl": 0.0,
            "lng_carrier_boe": 856000.0,
            "vlcc_crude_and_lng_bbl": 856000.0,
            "suezmax_aframax_crude_bbl": 0.0,
            "mr_clean_products_bbl": 13320000.0
        }
    },
    "chokepoints": {
        "hormuz": {
            "chokepoint_id": "hormuz",
            "name": "Strait of Hormuz",
            "date": "2026-10-25",
            "ais_lit_tanker_count": 4,
            "sar_observed_dark_tanker_count": 0,
            "lng_carrier_count": 1,
            "rolling_dark_fleet_beta": 1.306,
            "sar_baseline_dark_beta": 1.15,
            "event_dark_evasion_uplift": 0.156,
            "days_since_sar_calibration": 5,
            "last_sar_calibration_date": "2026-10-20",
            "uncertainty_band_pct": 7.0,
            "ais_unadjusted_barrels": 1970000.0,
            "sar_observed_dark_barrels": 0.0,
            "calibrated_total_barrels": 2572820.0,
            "calibrated_volume_lower_bound_bbl": 2392722.6,
            "calibrated_volume_upper_bound_bbl": 2845538.9,
            "commodity_breakdown_barrels": {
                "vlcc_crude_bbl": 0.0,
                "lng_carrier_boe": 1397420.0,
                "vlcc_crude_and_lng_bbl": 1397420.0,
                "suezmax_aframax_crude_bbl": 0.0,
                "mr_clean_products_bbl": 1175400.0
            },
            "geopolitical_catalyst_context": {
                "catalyst_regime": "MILITARY_KINETIC_HAZARD",
                "geopolitical_threat_index": 0.9,
                "sanctions_enforcement_intensity": 0.85,
                "gnss_jamming_active": true,
                "active_event_count": 6,
                "remaining_persistence_days": 14,
                "forward_5d_decay_curve": {
                    "T+1": 0.815,
                    "T+2": 0.739,
                    "T+3": 0.669,
                    "T+4": 0.606,
                    "T+5": 0.549
                }
            }
        }
    }
}

4. Energy Gridded Tonnage & Barrel Extraction

GeoJSON & parquet.gzip

Retrieve the spatial grid matrix of global commercial tanker and large dark/ghost fleet (≥150m) capacity per distinct geographic grid cell. Includes Gross Tonnage (GT), estimated barrel/BOE capacities (modified_barrels), and cell-level decaying navigational/geopolitical hazard scores (event_severity_score and active_event_count).

GET https://api.androai.us/quant-finance-data/energy-gridded-tonnage
?target_date=YYYY-MM-DD&format=geojson|parquet

Query Parameters

Parameter Type Required Description
target_date String Yes The historical date to retrieve, formatted as YYYY-MM-DD (available up to T-2 days).
format String Optional Specify geojson (default) for spatial polygon features, or parquet for columnar ingestion (.parquet.gzip).

5. Row-Level Energy Tanker Activity Extraction

parquet.gzip Only

Retrieve the underlying deduplicated vessel-level activity table for cooperative tankers and unlit SAR dark/ghost tankers (≥150m). Includes coordinates, SAR backscatter texture features (sar_mean_scr, sar_cov, sar_fill_ratio), commodity tier classification (vlcc_crude, lng_carrier, suezmax_aframax_crude, mr_clean_product), and both raw and penalized barrel/BOE capacities.

GET https://api.androai.us/quant-finance-data/energy-vessel-activity
?target_date=YYYY-MM-DD

Query Parameters

Parameter Type Required Description
target_date String Yes The historical date to retrieve, formatted as YYYY-MM-DD (available up to T-2 days).

6. Chokepoint Effective Transit Velocity (ETVI Freight Index & 5d Recovery)

JSON

Retrieve the daily macro Global Freight Velocity Index, bottleneck causal attribution, and 5-day forward recovery curves across 8 primary coastal shipping corridors (CHK-MALACCA, CHK-PANAMA, CHK-SUEZ, CHK-HORMUZ, CHK-GIBRALTAR, CHK-DOVER, CHK-BOSPHORUS, and CHK-US-WEST). Delivers Andromeda AI's proprietary 0–100 composite ETVI regime score, decoupled raw physical factor inputs, deterministic bottleneck causal attribution (GEOPOLITICAL_OR_REGULATORY_SHOCK vs. SEVERE_METOC_WEATHER_DRAG vs. TERMINAL_QUEUE_BACKLOG), and a 5-day projected ETVI recovery trajectory (T+1 to T+5).

GET https://api.androai.us/quant-finance-data/freight-velocity
?target_date=YYYY-MM-DD

Query Parameters

Parameter Type Required Description
target_date String Yes The historical date to retrieve, formatted as YYYY-MM-DD (available up to T-2 days).

Downloaded JSON Payload Structure (Sample from S3 Pre-Signed URL)

{
    "date": "2026-10-25",
    "global_freight_velocity_index": 58.4,
    "space_weather_kp_index": 4.3,
    "space_weather_friction_score": 0.478,
    "total_active_maritime_hazard_events": 468,
    "chokepoints": [
        {
            "chokepoint_id": "CHK-PANAMA",
            "name": "Panama Canal Approaches (Balboa / Cristobal)",
            "primary_exposure": "U.S. Gulf Grain, LNG, & Container Trade",
            "etvi_score": 41.2,
            "mean_transit_sog_knots": 8.4,
            "baseline_30d_sog_knots": 10.4,
            "speed_vs_30d_baseline_pct": -19.2,
            "transit_speed_ratio": 0.808,
            "queue_stagnation_ratio": 0.385,
            "queued_tonnage_mt": 3420000,
            "total_chokepoint_tonnage_mt": 8883116,
            "transiting_vessel_count": 18,
            "queued_vessel_count": 14,
            "sar_dark_queue_beta": 1.12,
            "metoc_drag_score": 0.65,
            "status": "SEVERE_CONGESTION",
            "primary_bottleneck_attribution": "GEOPOLITICAL_OR_REGULATORY_SHOCK",
            "catalyst_regime": "PORT_LABOR_DISPUTE",
            "geopolitical_threat_index": 0.75,
            "gnss_jamming_active": false,
            "active_event_count": 3,
            "remaining_persistence_days": 10,
            "forward_5d_hazard_decay_curve": {
                "T+1": 0.653,
                "T+2": 0.568,
                "T+3": 0.495,
                "T+4": 0.431,
                "T+5": 0.375
            },
            "projected_5d_etvi_recovery_curve": {
                "T+1": 45.1,
                "T+2": 48.6,
                "T+3": 51.5,
                "T+4": 54.1,
                "T+5": 56.4
            }
        }
    ]
}

7. Grid-Mapped Maritime Events & OFAC Sanctioned Vessels

parquet.gzip Only

Retrieve the standalone point-in-time Grid-Mapped Maritime Events table (dataset=grid_events, containing NGA NAVAREA warnings and GDELT CAMEO blockades/strikes/seizures joined to polygon IDs with exponential half-life decay scores) or the daily OFAC SDN Sanctioned Maritime Vessels lookup table (dataset=ofac_sanctions, containing 2,150+ sanctioned vessels with parsed IMO, MMSI, flag, tonnage, and sanctions program).

GET https://api.androai.us/quant-finance-data/gridded-tonnage
?target_date=YYYY-MM-DD&dataset=grid_events|ofac_sanctions

Query Parameters

Parameter Type Required Description
target_date String Yes The historical date to retrieve, formatted as YYYY-MM-DD (available up to T-2 days).
dataset String Yes Specify grid_events for spatially joined NGA/GDELT maritime events with exponential decay, or ofac_sanctions for the point-in-time US Treasury OFAC SDN maritime vessel table.

Tonnage Calculation Methodology

To assure data integrity and prevent supply overestimation, the Andromeda AI pipeline processes raw satellite detections through a strict sequence of filtration, physical proxy deduplication, and unverified asset discounting before exposing the data to quantitative trading models.

What is Gross Tonnage (GT)?

In maritime economics, Gross Tonnage (GT) is a dimensionless volumetric index (GT = K × V) representing a vessel's total enclosed internal volume rather than physical weight. Because vessel headcount alone is skewed by small coastal boats, Gross Tonnage serves as the institutional proxy for macro production and harvesting capacity. For non-cooperative SAR detections lacking AIS signal, GT is empirically derived from satellite radar bounding-box mensuration (GT ≈ 0.32 × Lengthm2).

1

Fleet & Polar Sea-Ice Filtration

Irrelevant commercial vessels (cargo, tankers, passenger lines), polar multi-year sea-ice / glacial iceberg zones, and proprietary environmental columns are purged from the published data. The engine strictly retains vessels classified as fishing, sar_dark_vessel, or ghost_vessel.

2

Spatial Proxy Deduplication

Because SAR dark vessels do not broadcast an MMSI identifier, the dataset is deduplicated within each cell using a composite physical proxy key of ['polygon', 'vessel_type', 'tonnage_gt', 'length_m']. A vessel signature is counted once per grid cell per day, preventing high-frequency AIS pings from inflating cell capacity.

3

Unverified Asset Discounting & Spatio-Temporal Nowcasting

Dark and ghost vessels represent unverified spatial capacity. While polar-orbiting SAR satellites operate on a 12-to-14-day local repeat cycle for any single fixed coordinate, they capture rolling radar swaths across different global fishing grounds every 24 hours. Between direct orbital passes, Andromeda AI utilizes multi-sensor spatio-temporal data fusion—fusing daily cooperative fleet AIS, environmental data, and spoofed AIS—to model continuous daily capacity across the grid.

Because nowcasted positions between radar passes and SAR bounding-box mensuration carry an inherent margin of error, all unverified assets are subjected to a flat 20% estimation penalty to price orbital revisit latency and sensor variance directly into the metric and prevent supply overestimation in downstream spot-price models:

Tonnagemodified = Tonnageraw × (1.0 - Penalty)
  • Verified Fishing: Penalty = 0.00 (100% of cooperative AIS-verified capacity counted)
  • Dark / Ghost Vessels: Penalty = 0.20 (80% of estimated capacity counted, discounting for SAR revisit latency and radar mensuration variance)
4

Global Macro Deduplication

When Andromeda AI aggregates the daily global fleet totals for our macro metadata feeds, the pipeline applies a global physical proxy deduplication across ['vessel_type', 'tonnage_gt', 'length_m']. If a vessel traverses three separate grid cells in one day, its capacity is mapped to all three spatial grid cells, but it is only counted once in the global macro supply metrics.

Gridded Tonnage Data Dictionary

Schema for /quant-finance-data/gridded-tonnage. When requested as geojson, each record is a spatial polygon feature in EPSG:4326. When requested as parquet, the geometry column is omitted for rapid tabular loading.

Property / Column Type Description
polygon String The unique identifier for the geographic grid cell.
fishing_tonnage Float Total adjusted Gross Tonnage (GT) of verified, cooperative fishing vessels within the grid cell.
dark_tonnage Float Total modified Gross Tonnage (GT) of SAR-detected dark vessels lacking AIS transponders (discounted by 20%).
ghost_tonnage Float Total modified Gross Tonnage (GT) of vessels actively spoofing AIS locations (discounted by 20%).
total_tonnage Float The sum of fishing_tonnage, dark_tonnage, and ghost_tonnage.
fishing_tonnage_gt / sar_dark_vessel_tonnage_gt / ghost_vessel_tonnage_gt Float Unpenalized raw Gross Tonnage (GT) sums per vessel class prior to the 20% estimation discount.
fishing_length_m / sar_dark_vessel_length_m / ghost_vessel_length_m Float Mean physical vessel length (in meters) per operational class within the grid cell.
density_fishing / density_dark Float Normalized relative volume (0.0 to 1.0) scaled against the daily 99th percentile.

Row-Level Vessel Activity Data Dictionary

Schema for /quant-finance-data/vessel-activity (delivered as compressed .parquet.gzip). Contains one record per unique vessel per grid cell per day.

Column Type Description
polygon String The geographic grid cell ID where the vessel was detected.
vessel_type String Operational classification: fishing, sar_dark_vessel, or ghost_vessel.
lat / lon Float WGS84 decimal coordinates of the vessel detection (rounded to 2 decimal places).
time Timestamp (UTC) UTC timestamp of the satellite AIS ping or SAR radar acquisition.
length_m Float Vessel length in meters (from registry lookup or SAR mensuration).
tonnage_gt Float Unpenalized Gross Tonnage (GT) capacity index.
estimation_penalty Float Discount factor applied to the vessel (0.0 for verified fishing, 0.20 for dark/ghost).
modified_tonnage Float Final risk-adjusted Gross Tonnage (GT) after applying the estimation penalty.

Energy Tanker, Cryogenic LNG & Rolling Dark Fleet Beta Methodology

Standard maritime logistics providers rely exclusively on cooperative AIS transponders, leaving commodity supply models blind when sanctioned "shadow fleet" crude and LNG tankers disable or spoof their transponders while transiting critical straits. Andromeda AI bridges this gap by combining physical hull mensuration, radar deck-scatter profiling, a Bi-Weekly Statistical Calibration Anchor, and Event-Driven Interim Dark Evasion Uplift to compute a dynamic Rolling Dark Fleet Beta (βdark).

1

SAR Hull Mensuration & Cryogenic LNG Backscatter Classification

Every marine radar anomaly detected by space-based SAR (10m spatial resolution) undergoes adaptive background-clutter segmentation, pixel bounding-box diagonal mensuration, and hull backscatter texture profiling (sar_mean_scr, sar_cov, and sar_fill_ratio). After scrubbing high-polar and glacial iceberg zones, vessels with measured hull length ≥ 150.0m (alongside cooperative AIS tanker and Type-84 lng_tanker broadcasts) are separated into four commercial energy classes:

MR / Clean Product
150.0m ≤ Length < 210.0m
Raw Capacity: 300,000 bbl
Dark Penalized (0.8x): 240,000 bbl
Suezmax / Aframax Crude
210.0m ≤ Length < 290.0m
Raw Capacity: 875,000 bbl
Dark Penalized (0.8x): 700,000 bbl
VLCC Crude
Length ≥ 290.0m (Flat Deck)
Raw Capacity: 2,000,000 bbl
Dark Penalized (0.8x): 1,600,000 bbl
Cryogenic LNG Carrier
AIS Type 84 or 215–335m Multi-Bounce SAR
Raw: 1,070,000 BOE (~3.6 Bcf)
Dark Penalized (0.8x): 856,000 BOE
2

The Rolling Dark Fleet Beta (βdark) & Interim Event Evasion Uplift

On days when a SAR orbital swath intersects a maritime chokepoint (Day 0 Calibration Anchor), the engine measures both cooperative AIS barrel/BOE volume and risk-adjusted SAR dark/ghost barrel/BOE volume inside the chokepoint corridor bounding box, updating the strait's persistent SAR Baseline Beta (sar_baseline_dark_beta, clamped to [1.00, 2.50]):

βSAR = 1.0 + (BarrelsSAR_Dark_Modified / BarrelsAIS_Cooperative)

On intermediate days between satellite passes (Days 1–14), if an active sanctions enforcement seizure or high-severity military hazard occurs inside the corridor (sanctions_enforcement_intensity > 0 or geopolitical_threat_index ≥ 0.75), shadow-fleet tankers immediately disable AIS transponders at an elevated rate. The engine computes an interim Event Dark Evasion Uplift (Δβevent = 0.12 · Isanctions + 0.06 · Ithreat) so your supply models capture dark evasion surges before the next satellite pass arrives.

Energy Chokepoints JSON Data Dictionary

Schema for /quant-finance-data/energy-chokepoints (delivered as structured JSON).

Field Type Description
global_energy_summary Object Macro global aggregate across all ocean grid cells: includes vessel counts, barrel/BOE totals, total_ofac_sanctioned_vessels_tracked, total_active_maritime_hazard_events, and global_commodity_breakdown_barrels.
chokepoint_id / name String Identifier (malacca, hormuz, suez, bab_el_mandeb, cape_good_hope, panama, gibraltar, dover_channel, danish_baltic) and human-readable name.
rolling_dark_fleet_beta / sar_baseline_dark_beta / event_dark_evasion_uplift Float Effective dark fleet multiplier (1.00–2.50), decomposed into the most recent direct SAR orbital calibration (sar_baseline_dark_beta) and any interim sanctions/kinetic evasion shock (event_dark_evasion_uplift).
calibrated_total_barrels Float Total Beta-calibrated barrel/BOE volume transiting the chokepoint, accompanied by calibrated_volume_lower_bound_bbl and asymmetric threat-expanded calibrated_volume_upper_bound_bbl.
commodity_breakdown_barrels Object Calibrated volume split by commodity class: vlcc_crude_bbl, lng_carrier_boe, vlcc_crude_and_lng_bbl, suezmax_aframax_crude_bbl, and mr_clean_products_bbl.
geopolitical_catalyst_context Object Contains catalyst_regime, geopolitical_threat_index (decayed 0.0–0.95), sanctions_enforcement_intensity, gnss_jamming_active (boolean), active_event_count, remaining_persistence_days, and forward_5d_decay_curve (T+1 to T+5).

Energy Gridded Barrels & Tonnage Data Dictionary

Schema for /quant-finance-data/energy-gridded-tonnage (GeoJSON or parquet.gzip).

Property / Column Type Description
polygon String Unique identifier for the geographic grid cell.
total_estimated_barrels Float Total risk-adjusted barrel/BOE capacity across all cooperative, dark, and ghost tankers within the grid cell.
cooperative_tanker_modified_barrels / sar_dark_tanker_modified_barrels / ghost_tanker_modified_barrels Float Estimated barrel/BOE capacity per fleet status within the cell (dark and ghost tankers discounted by 20%).
total_energy_tonnage Float Sum of modified Gross Tonnage (GT) across all energy tanker classes in the cell.
event_severity_score / active_event_count Float / Int Maximum exponentially decayed severity score (0.0–0.95) and count of active NGA NAVAREA or GDELT maritime hazard events inside the grid cell.
density_dark_tanker / density_coop_tanker Float Normalized relative barrel volume (0.0 to 1.0) scaled against the daily 99th percentile.

Row-Level Energy Tanker Activity Data Dictionary

Schema for /quant-finance-data/energy-vessel-activity (delivered as compressed .parquet.gzip).

Column Type Description
polygon / lat / lon / time Mixed Grid cell ID, WGS84 decimal coordinates, and UTC acquisition timestamp.
fleet_status String Standardized energy status: cooperative_tanker, sar_dark_tanker, or ghost_tanker.
tanker_class String Commodity tier derived from hull length & radar backscatter profile: vlcc_crude (≥290m), lng_carrier, suezmax_aframax_crude (210–289.9m), or mr_clean_product (150–209.9m).
length_m / tonnage_gt / modified_tonnage Float Physical vessel length (meters), raw Gross Tonnage (GT), and 20%-penalized Gross Tonnage.
sar_mean_scr / sar_cov / sar_fill_ratio Float SAR radar return metrics: Mean Signal-to-Clutter Ratio (sar_mean_scr), hull spatial Coefficient of Variation (sar_cov = σ/μ), and active bounding-box scatterer fill ratio (sar_fill_ratio).
estimated_barrels_raw / modified_barrels Float Unadjusted capacity and risk-adjusted capacity in Barrels (or BOE for lng_carrier) after applying the 20% dark/ghost estimation penalty.

Chokepoint Effective Transit Velocity (ETVI) & Event Persistence Decay Math

In global maritime economics, active shipping supply is governed not by nominal fleet headcount, but by how rapidly commercial tonnage clears critical coastal bottlenecks. Every 1% reduction in corridor transit velocity or 1% increase in anchorage queue stagnation effectively removes ~1% of active global carrying capacity, driving spot freight rate spikes (BDRY) and shipping equity repricing (ZIM, MATX, FRO, STNG) 5 to 15 days before consensus freight indices react.

1

The 4-Factor Composite ETVI Formula

ETVI = 100 × Vratio × (1.0 - Qratio) × (1.0 - 0.20 · Mdrag - 0.10 · Skp)
2

Deterministic Event Half-Life Decay & 5-Day ETVI Recovery Projection

Rather than relying on speculative text sentiment, Andromeda AI ingests authoritative NGA NAVAREA broadcast warnings and geocoded GDELT CAMEO events into a stateful rolling persistence ledger. Each hazard regime is assigned an empirical persistence horizon τ (e.g., MILITARY_KINETIC_HAZARD = 14d, SANCTIONS_SEIZURE_ENFORCEMENT = 21d, PORT_LABOR_DISPUTE = 10d, GNSS_JAMMING_SPOOFING = 7d) and decays according to an exact exponential half-life law (τ1/2 = τ / 2):

Severity(t + Δt) = S0 · exp( - [ln(2) / τ1/2] · Δt )

Using each turnstile's forward 5-day hazard decay schedule (forward_5d_hazard_decay_curve), the engine projects the expected 5-day ETVI recovery path (projected_5d_etvi_recovery_curve) toward the corridor's weather-adjusted ceiling, enabling systematic trading desks to distinguish short-lived weather lock-ins from multi-week geopolitical or labor blockades.

Freight Velocity (ETVI) JSON Data Dictionary

Schema for /quant-finance-data/freight-velocity (delivered as structured JSON).

Field Type Description
global_freight_velocity_index Float Equal-weighted composite ETVI score (0.0 to 100.0) across all 8 global turnstiles.
space_weather_kp_index / space_weather_friction_score Float Daily maximum geomagnetic Kp index (0.0–9.0) and normalized GPS/ECDIS friction factor (0.0–1.0).
chokepoint_id / name / primary_exposure String Turnstile identifier (CHK-MALACCA, CHK-PANAMA, CHK-SUEZ, CHK-HORMUZ, CHK-GIBRALTAR, CHK-DOVER, CHK-BOSPHORUS, CHK-US-WEST), corridor name, and primary freight/commodity exposure.
etvi_score / status Float / String Turnstile Effective Transit Velocity score (0.0–100.0) and categorical regime (FLUID_TRANSIT, NORMAL_FLOW, MODERATE_FRICTION, SEVERE_CONGESTION).
mean_transit_sog_knots / baseline_30d_sog_knots / speed_vs_30d_baseline_pct Float Current daily mean transit speed (knots), 30-day rolling baseline speed (knots), and percentage velocity deviation.
queue_stagnation_ratio / queued_tonnage_mt / total_chokepoint_tonnage_mt Float / Int Ratio of stagnant/anchored tonnage (0.0–0.90), SAR-calibrated queued commercial tonnage (GT/MT), and total turnstile commercial tonnage.
metoc_drag_score Float Normalized physical wave and opposing surface current drag score (0.00–1.00) inside the turnstile grid.
primary_bottleneck_attribution / catalyst_regime String Deterministic root-cause attribution (GEOPOLITICAL_OR_REGULATORY_SHOCK, SEVERE_METOC_WEATHER_DRAG, TERMINAL_QUEUE_BACKLOG, or NORMAL_OPERATIONAL_FLOW) and specific NGA/GDELT hazard category.
geopolitical_threat_index / remaining_persistence_days / gnss_jamming_active Float / Int / Bool Decayed threat severity score (0.0–0.95), remaining persistence days before hazard expiration, and active NGA GNSS jamming indicator.
forward_5d_hazard_decay_curve / projected_5d_etvi_recovery_curve Object 5-day forward trajectories (T+1 to T+5) for both the decaying hazard severity and the projected turnstile ETVI recovery score.