For developers and quants

The data behind the picture, as it stood on any past date

The QuantShip API serves 101 datasets across risk, news, chokepoints, markets and shipping. Its point is point-in-time history: you can ask what was known on a given day, so a back-test cannot see the future.

What makes it usable for back-testing

As-of queries

Add as_of to a request and you get each record as it stood at that moment, not as it reads today.

Revisions

Ask for a record's revision history to see every version we captured and when.

Honest first-seen times

Each record says how its first-seen time was established: captured live, taken from a publication schedule, or reconstructed. Where we cannot establish it, the API says so.

Continuous live capture began in October 2026. History before that is dated from publication schedules or reconstructed from public sources, and is labelled.

What a request looks like

Send your key in the X-API-Key header. Responses are JSON.

import os, requests

BASE = "https://quantship.ai/api/analytics/datasets"
headers = {"X-API-Key": os.environ["QUANTSHIP_API_KEY"]}

# Latest records
r = requests.get(f"{BASE}/crude-prices/records",
                 params={"limit": 50, "order": "desc"}, headers=headers, timeout=30)

# The same dataset as it stood on 1 October 2026
r = requests.get(f"{BASE}/crude-prices/records",
                 params={"limit": 50, "as_of": "2026-10-01T00:00:00Z"}, headers=headers, timeout=30)

The full reference, with every route and field, is in the API documentation once you have an account.

The catalogue

Every dataset currently served, with its fields. This list is generated from the live catalogue each time the page loads.

Markets: prices, spreads, inventories, positioning10 datasets

DatasetWhat it holdsFields
cftc-positionsCftc positionsid, report_date, contract_name, exchange, commercial_long, commercial_short, commercial_net, noncommercial_long, noncommercial_short, noncommercial_net, managed_money_long, managed_money_short, managed_money_net, open_interest and 7 more
crack-spreadsCrack spreadsid, report_date, crack_321, gasoline_crack, heating_oil_crack, wti_price, brent_price, gasoline_price, heating_oil_price, source, scraped_at
crude-intradayCrude price intradayid, recorded_at, wti_price, brent_price, source
crude-pricesCrude price historyid, recorded_date, wti_close, brent_close, wti_brent_spread, wti_change_1d, wti_change_1d_pct, brent_change_1d, brent_change_1d_pct, wti_change_3d_pct, wti_change_7d_pct, brent_change_3d_pct, brent_change_7d_pct, source and 1 more
eia-inventoryEia inventoryid, report_date, series_id, series_name, value, unit, change_week, change_year, five_year_avg, diff_from_avg, scraped_at, is_test, source_eia_receipt_id, source_eia_store_id and 1 more
market-data-floating-storageFloating storageid, report_date, region, vessel_count, total_dwt_million, estimated_barrels_million, avg_days_stationary, vlcc_count, suezmax_count, aframax_count, calculated_at
market-data-sanctioned-vesselsSanctioned vesselsimo, name, vessel_type, flag, programs, listed_source, first_seen, last_seen
official-flowsOfficial flowscountry_iso2, period, product, flow, unit, value, source, assessment_code, recorded_date
portwatch-transitsPortwatch chokepoint transitschokepoint_id, chokepoint_name, date, n_tanker, capacity_tanker, n_total, recorded_date
refinery-utilizationRefinery utilizationid, report_date, region, utilization_pct, gross_inputs_mbpd, operable_capacity_mbpd, scraped_at

Risk, news and intelligence63 datasets

DatasetWhat it holdsFields
ais-gaps-mmsiAis gap history mmsiid, recorded_date, recorded_at, mmsi, imo, vessel_name, flag, last_lat, last_lon, last_seen, gap_hours, near_chokepoint, risk_level, total_gaps
cargo-flowsCargo flow historyid, recorded_date, recorded_at, origin, origin_name, destination, destination_name, current_fixtures, previous_fixtures, change_pct, current_volume_mt, volume_change_pct, direction, is_anomaly and 4 more
chokepoint-trafficChokepoint ship countsid, recorded_date, chokepoint_id, total, trend, change_pct, daily_counts
chokepointsChokepoint historyid, chokepoint_id, recorded_at, disruption_probability, event_count, threat_level, volume_mbpd, price_impact_low, price_impact_high
country-riskCountry risk historyid, recorded_date, recorded_at, country, score, level, event_count, critical_count, high_count, de_escalation_count, center_lat, center_lon, top_headlines, total_countries
floating-storageFloating storage historyid, recorded_date, recorded_at, cluster_name, lat, lon, vessel_count, avg_dwell_days, estimated_barrels_m, vlcc_count, suezmax_count, other_count, vessels_json, global_total_barrels_m and 1 more
gps-jammingGps jamming cellsid, recorded_date, h3_id, quality, count_good, count_bad, region
hormuz-shipsHormuz ship historyid, recorded_date, recorded_at, ship_count, capture_date, detections_json, bbox_json, algorithm
hurricanesHurricane historyid, recorded_date, recorded_at, storm_id, name, lat, lon, max_wind, pressure, status, forecast_json, threatened_ports_json, total_storms
intel-zonesIntelligence zone historyid, recorded_at, recorded_date, region, zone_type, zone_fingerprint, lat, lon, radius_km, risk_score, severity, summary, event_count, categories and 4 more
macro-alerts-category-horizon-accuracyCategory horizon accuracycategory, horizon, total_predictions, correct_predictions, accuracy_pct, avg_price_change, avg_volatility, confidence_level, is_active, last_updated
macro-alerts-category-learningCategory learningcategory, avg_price_change, sample_size, learned_direction, direction_accuracy, volatility_avg, bullish_count, bearish_count, flat_count, last_updated
macro-alerts-chokepoint-analysis-historyChokepoint analysis historyid, recorded_at, chokepoint_id, disruption_probability, threat_level, event_count, volume_mbpd, daily_ship_count, ship_trend, ship_change_pct, price_impact_low, price_impact_high, expected_impact_low, expected_impact_high and 7 more
macro-alerts-cluster-summariesCluster summariesid, cache_key, location_key, summary_text, event_count, severity_breakdown, generated_at, expires_at, source
macro-alerts-curator-outputsCurator outputsid, ts, punchline, ranking_json, input_hash, trigger
macro-alerts-daily-analyticsDaily analyticsid, recorded_date, recorded_at, total_events, critical_events, high_events, medium_events, low_events, events_by_category, events_by_region, oil_related_events, oil_percentage, active_sources, total_scrapes and 2 more
macro-alerts-event-outcomesEvent outcomesalert_id, headline, source, severity, category, primary_location, created_at, outcome_checked_at, outcome_type, actual_disruption, confirmation_count, price_at_event, price_24h_later, price_48h_later and 7 more
macro-alerts-event-price-correlationEvent price correlationid, alert_id, event_date, headline, severity, category, chokepoint, assigned_score, wti_at_event, brent_at_event, wti_1d_later, wti_3d_later, wti_5d_later, wti_7d_later and 40 more
macro-alerts-facility-impact-eventsFacility impact eventsid, spill_id, facility_key, facility_name, owner, tier, eta_hours, closest_km, spill_lat, spill_lon, facility_lat, facility_lon, facility_radius_km, horizon_hours and 2 more
macro-alerts-floating-storage-calculationsFloating storage calculationsid, capture_mode, payload_json
macro-alerts-global-macro-narrativesGlobal macro narrativespanel_key, generated_at, narrative_md, input_signature, model
macro-alerts-gps-jamming-ingestionGps jamming ingestionrecorded_date, algorithm_version, source_row_count, stored_row_count, ingested_at
macro-alerts-horizon-accuracyHorizon accuracyhorizon, total_predictions, correct_predictions, accuracy_pct, avg_price_change, avg_volatility, is_active, last_updated
macro-alerts-intel-agent-outputsIntel agent outputsid, agent_name, ts, headline, narrative, facts_json, severity, importance_score, audience_tags_json, source_refs_json, visual_hints_json, confidence, input_hash, trigger and 1 more
macro-alerts-intel-brief-briefingsIntel brief briefingsid, generated_at, generator_type, subject, teaser, hero_image, hero_image_mime, full_html, pruned_at
macro-alerts-intel-brief-capturesIntel brief capturesscene_hash, visual_hint, path, ts
macro-alerts-intel-brief-story-capturesIntel brief story capturesitem_type, item_id, item_hash, recipe_json, recipe_source, capture_path, scene_label, status, attempt_count, last_error, captured_at
macro-alerts-intelligence-snapshotIntelligence snapshotid, recorded_at, recorded_date, supply_risk_score, severity_counts, critical_chokepoints, high_chokepoints, price_outlook_health, price_outlook_summary, price_outlook_text, bullish_score, bearish_score, net_score, signals and 20 more
macro-alerts-learned-scoring-weightsLearned scoring weightsid, updated_at, pattern_type, pattern_value, sample_size, accuracy_pct, avg_price_impact_pct, false_positive_rate, base_weight, current_weight, suggested_weight, confidence_level, last_validated
macro-alerts-lost-and-foundLost and foundrootpgno, pgno, nfield, id, c0, c1, c2, c3, c4, c5, c6, c7, c8, c9 and 4 more
macro-alerts-macro-alertsMacro alertsid, source, headline, summary, url, published_at, scraped_at, category, severity, primary_location, primary_lat, primary_lon, secondary_location, secondary_lat and 17 more
macro-alerts-metric-horizon-accuracyMetric horizon accuracymetric, horizon, total_predictions, correct_predictions, accuracy_pct, avg_impact, is_active, last_updated
macro-alerts-navy-press-position-observationsNavy press position observationsid, source_sighting_id, vessel_key, vessel_name, hull_number, reported_hull_number, country_flag, is_nato, vessel_type, observed_at, time_precision, location_name, lat, lon and 10 more
macro-alerts-navy-press-sightingsNavy press sightingsid, vessel_name, hull_number, vessel_type, strike_group, location_name, lat, lon, accuracy_km, event_type, event_date, headline, summary, source and 6 more
macro-alerts-news-geo-correctionsNews geo correctionscache_key, lat, lon, country, corrected_at
macro-alerts-oil-on-water-historyOil on water historyweek_start, total_volume_mt, fixture_count, recorded_at
macro-alerts-oil-spill-detectionsOil spill detectionsid, spill_event_id, detected_at, centroid_lat, centroid_lon, area_km2, polygon_geojson, confidence_score, confidence_level, sar_strength_db, shape_elongation, optical_confirmed, news_event_id, ais_gap_imo and 2 more
macro-alerts-oil-spill-eventsOil spill eventsid, status, first_detected, last_detected, peak_area_km2, current_area_km2, centroid_lat, centroid_lon, drift_bearing_deg, drift_speed_kmh, nearest_facility, nearest_facility_km, detection_count, passes_missed and 3 more
macro-alerts-oil-spill-historyOil spill historyspill_event_id, detected_at, area_km2, centroid_lat, centroid_lon, confidence_score
macro-alerts-oil-spill-landfall-eventsOil spill landfall eventsid, spill_id, generated_at, forecast_horizon_hours, estimated_total_barrels, estimated_beached_barrels, landfall_segments_geojson, first_impact_hour, first_impact_lat, first_impact_lon, affected_shore_km, confidence_level
macro-alerts-outlook-accuracy-historyOutlook accuracy historyid, recorded_date, horizon_days, outlook_direction, bullish_pct_bucket, total_predictions, correct_predictions, accuracy_pct, avg_price_impact, avg_bullish_pct, last_updated
macro-alerts-risk-score-intradayRisk score intradayid, recorded_at, score, risk_level, escalation_only_score, de_risk_score, de_escalation_count, de_escalation_points, de_esc_dampening_factor, price_momentum_factor, price_confirmed_dampening_cap, regime_shift_detected, escalation_velocity_bonus, bullish_pct and 3 more
macro-alerts-risk-velocity-historyRisk velocity historyid, recorded_at, recorded_date, esc_velocity_bonus, esc_peak_6h, esc_velocity_triggered, de_esc_velocity_bonus, de_esc_peak_velocity, de_esc_window_6h, de_esc_window_12h, de_esc_window_24h, regime_shift_detected, regime_shift_reason, regime_shift_multiplier and 13 more
macro-alerts-route-impact-historyRoute impact historyid, recorded_at, recorded_date, route_name, risk_level, risk_score, event_count, price_impact_low, price_impact_high, affected_chokepoints
macro-alerts-satellite-pass-historySatellite pass historynorad_id, name, category, country, region, facility_key, pass_start, pass_end, closest_km, max_elevation, sensor_type, is_daylight, risk_correlation, recorded_date
macro-alerts-satellite-tleSatellite tlenorad_id, name, tle_line1, tle_line2, epoch, category, country, fetched_at, recorded_date
macro-alerts-shipping-signals-historyShipping signals historyid, recorded_at, recorded_date, chokepoint_id, total_signal_score, rate_alert_score, volume_alert_score, port_congestion_score, rate_alert_count, volume_alert_count, port_congestion_alerts, rate_alerts_json, volume_alerts_json, port_congestion_json and 1 more
macro-alerts-source-accuracySource accuracysource, display_name, source_type, total_events, true_positives, false_alarms, pending_evaluation, accuracy_score, credibility_multiplier, last_updated, created_at
macro-alerts-system-confidenceSystem confidencemetric_name, volatility_correlation, direction_accuracy, sample_size, confidence_level, confidence_score, last_updated
oil-flowOil flow snapshotid, recorded_date, recorded_at, last_complete_week, last_complete_fixtures, week_before_fixtures, change_pct, trend, current_week_fixtures, current_week_incomplete
pipeline-disruptionsPipeline disruption historyid, recorded_date, recorded_at, pipeline_id, pipeline_name, capacity_bpd, status, disruption_detected, disruption_event_count, disruption_severity, disruption_latest_event, disruption_headlines, status_explanation, total_pipelines and 1 more
port-disruptionsPort disruption historyid, recorded_date, recorded_at, port_name, country, lat, lon, bpd, disrupted, disruption_severity, disruption_reason, disruption_distance_km, disruption_event_type, disrupted_count and 1 more
portwatchPortwatch historyid, recorded_date, recorded_at, entry_type, entry_id, daily_avg, change_pct, trend, data_date, location, daily_throughput
price-outlookPrice outlook historyid, recorded_at, recorded_date, direction, net_score, bullish_pct, confidence, summary_text, metrics_breakdown, total_bullish, total_bearish, max_possible, eia_signal, cftc_signal and 33 more
refinery-activityFacility no2 historyid, facility_key, recorded_date, no2_value, baseline_30d, activity_level, recorded_at
risk-breakdownRisk breakdown historyid, recorded_at, recorded_date, total_risk_score, base_score, derisking_reduction, momentum_adjustment, final_score, risk_level, total_events, critical_count, high_count, medium_count, low_count and 16 more
route-diversionsRoute diversion historyid, recorded_date, recorded_at, diversion_id, imo, vessel_name, vessel_size, origin, destination, severity, deviation_pct, max_deviation_km, avg_deviation_km, avoided_chokepoints and 6 more
satellite-imagerySatellite imageryid, facility_key, capture_date, capture_time, satellite_name, cloud_cover_pct, file_hash, resolution_m, file_size_kb, bbox_west, bbox_south, bbox_east, bbox_north, fetched_at and 1 more
satellite-imagery-sarSatellite imagery sarid, facility_key, capture_date, capture_time, file_hash, cloud_cover_pct, resolution_m, file_size_kb, bbox, satellite_name, recorded_at
spreadsSpread volatility historyid, recorded_date, recorded_at, vol_7d, vol_30d, vol_level, outlook_direction, outlook_bullish_pct, outlook_confidence, wti_price, brent_price, wti_brent_spread, chokepoint_count
supply-chainSupply chain historyid, recorded_date, recorded_at, from_node, to_node, volume, threat_level, color, total_nodes, total_edges
vesselsVessel daily snapshotid, recorded_date, recorded_at, tanker_count, military_count, total_count, tanker_underway, tanker_anchored, tanker_moored, avg_speed
weatherWeather event historyid, recorded_date, recorded_at, event_id, event_type, name, country, lat, lon, alert_level, severity, severity_text, is_current, oil_impact and 2 more

Fixtures and shipping5 datasets

DatasetWhat it holdsFields
shipping-alerts-alert-daily-summaryAlert daily summaryid, summary_date, generated_at, total_alerts, critical_count, high_count, medium_count, low_count, category_breakdown, region_breakdown, top_routes, avg_volume_change_pct, total_cost_impact_usd, data_coverage_pct
shipping-alerts-alert-timelineAlert timelineid, recorded_at, hour_bucket, severity, category, region, alert_count
shipping-alerts-route-alert-historyRoute alert historyid, recorded_at, route_name, alert_id, severity, volume_change_pct, current_volume, historical_volume, rate_change_pct, current_rate, historical_rate
shipping-alerts-shipping-alertsShipping alertsid, alert_id, generated_at, valid_until, title, description, severity, category, region, status, affected_routes, primary_location, volume_change_pct, cost_impact_usd and 10 more
shipping-fixturesFixturesName, Deadweight, BuiltYear, Hull, Charterer, FixDate, FixMonth, FixYear, FixWeekEnd, Laycan, LayMonth, LayYear, LayWeekEnd, Rate and 26 more

Chokepoint and port transits2 datasets

DatasetWhat it holdsFields
portwatch-chokepoint-transitsChokepoint transitsid, date, chokepoint_name, chokepoint_id, transit_calls, trade_volume_mt, lat, lon, scraped_at
portwatch-port-activityPort activityid, date, port_name, port_id, country, lat, lon, import_calls, export_calls, import_volume_mt, export_volume_mt, scraped_at, port_calls

Freight rates4 datasets

DatasetWhat it holdsFields
rate-spikesRate spike snapshotsid, snapshot_date, recorded_at, route_id, origin, destination, vessel_type, cargo_type, fixture_count, avg_cargo_size, avg_rate, origin_lat, origin_lon, dest_lat and 11 more
rate-spikes-rate-spike-daily-summaryRate spike daily summaryid, summary_date, recorded_at, total_routes, spiking_routes, declining_routes, avg_spike_pct, max_spike_pct, min_spike_pct, top_spikes, top_drops, most_active, market_trend
rate-spikes-rate-spike-route-historyRate spike route historyid, route_id, fix_date, rate
rates-insights-rate-snapshotsRate snapshotsid, snapshot_date, recorded_at, route_name, load_zone, discharge_zone, rate_unit, avg_rate, min_rate, max_rate, fixture_count, change_24h_pct, change_1w_pct, change_1m_pct and 3 more

Other datasets17 datasets

DatasetWhat it holdsFields
gdacs-disasters-gdacs-eventsGdacs eventsid, event_id, episode_id, event_type, event_name, description, country, iso3, lat, lon, alert_level, alert_score, severity, severity_text and 14 more
intelligence-versionsImmutable source and intelligence receipt versions with evidence and exact-payload linksid, event_key, identity_sha256, kind, source_key, payload_sha256, media_type, published_at, captured_at, capture_mode, metadata, evidence_ids, payload_url
marine-forecast-cache-marine-cacheMarine cacheid, payload, fetched_at
nhc-storms-active-stormsActive stormsid, storm_id, name, classification, intensity_kt, pressure_mb, lat, lon, movement_dir, movement_speed_kt, basin, advisory_number, scraped_at
nhc-storms-forecast-pointsForecast pointsid, storm_id, forecast_hour, lat, lon, max_wind_kt, category, scraped_at
nhc-storms-storm-historyStorm historyid, storm_id, timestamp, lat, lon, intensity_kt, pressure_mb
nws-oil-alerts-nws-oil-alertsNws oil alertsalert_id, asset_name, event, headline, description, instruction, severity, urgency, certainty, onset, expires, area_desc, lat, lon and 3 more
processed-vessel-positions-vessel-positionsVessel positionsid, imo, mmsi, name, name_ais, latitude, longitude, speed_over_ground, course_over_ground, true_heading, ship_type_id, flag, length, beam and 9 more
processed-vessel-positions-vessel-tracksVessel tracksid, imo, mmsi, name, latitude, longitude, speed_over_ground, course_over_ground, timestamp_position, scraped_at, source, vessel_category, ship_type_id, draught and 2 more
reference-chokepoint-statusCurrent retained chokepoint status documentdocument, content_sha256, byte_size, filesystem_modified_at, document_url
reference-real-routesCurrent retained real routes documentdocument, content_sha256, byte_size, filesystem_modified_at, document_url
reference-route-impactsCurrent retained route impacts documentdocument, content_sha256, byte_size, filesystem_modified_at, document_url
route-cache-route-geometryRoute geometryload_port, discharge_port, lats, lons, created_at
weather-atmosphericOil asset weatherasset_name, observed_at, lat, lon, country, asset_type, capacity_bpd, weather_code, temperature_c, wind_speed_kph, wind_gust_kph, precipitation_mm, forecast_precipitation_mm, forecast_max_gust_kph and 5 more
weather-marineOil asset marine weatherasset_name, observed_at, lat, lon, country, asset_type, capacity_bpd, wave_height_m, wave_direction_deg, swell_height_m, forecast_max_wave_m, forecast_max_swell_m, risk_level, risk_reason and 1 more
weather-refresh-statusOil weather ingestion statusfeed, status, records_saved, hazardous_records, checked_at, error
wind-currents-wind-current-gridWind current gridid, source, provider, bbox_key, resolution_deg, valid_at, fetched_at, grid_json

What it does not have

Vessel positions are partial and thin in the Gulf and the Strait of Hormuz. The Hormuz transit-count series is withheld while its public source is broken. Our own back-tests found no reliable price or inventory signal in the fixture tape, so we sell the data and its timestamps, not a signal. API licences cover internal use; redistribution needs an enterprise agreement.