SupplyMaven API Pro

Assess current global supply chain disruption risk. Returns the Global Disruption Index (GDI) — a real-time composite score from 0-100 measuring disruption across transportation, energy, materials, and macroeconomic pillars. Higher scores indicate greater supply chain risk. Built from 200+ live data variables including port congestion at 26 global ports, commodity prices for 31 assets, US border crossing delays, manufacturing output from 8 power grid regions, and Federal Reserve economic indicators. Used by procurement teams, logistics planners, commodity traders, and supply chain managers for real-time supply chain visibility and risk monitoring.

Get detailed breakdown of supply chain disruption risk by category. Returns individual scores for each GDI pillar — Transportation (port congestion, border delays, freight weather), Energy (petroleum, natural gas, electricity, fuel prices), Materials (31 commodity prices with volatility), and Macro (Federal Reserve indicators, Producer Price Index). Each pillar includes its score, trend direction, and the specific data points driving the current reading. Essential for supply chain managers who need to diagnose which risk category is elevated and why.

Detect US manufacturing output changes up to 24 hours before official government reports. The patent-pending Supply Manufacturing Index (SMI) analyzes weather-normalized electricity demand across 8 US power grid regions (MISO/Midwest, ERCOT/Texas, PJM/Mid-Atlantic, CISO/California, ISNE/New England, NYIS/New York, SWPP/Central, NW/Pacific Northwest) to isolate real industrial activity from seasonal heating and cooling noise. Returns regional and national manufacturing activity scores, trend direction, and comparison to official Federal Reserve Industrial Production (INDPRO) data. INVERTED scale: lower = stronger manufacturing. 0-35 STRONG, 36-50 NORMAL, 51-65 BELOW TREND, 66+ WEAK. Used by commodity traders, economic analysts, and hedge funds as a leading manufacturing indicator.

Monitor real-time commodity prices and price volatility for supply chain cost management. Tracks 31 commodities across energy (WTI crude, Brent, natural gas, coal, ethanol), metals (copper, aluminum, nickel, zinc, lithium, cobalt, iron, titanium, uranium), agriculture (corn, wheat, soybeans, rice, cotton, lumber), industrial materials (rubber, polyethylene, PVC, polypropylene, soda ash), and semiconductor materials (germanium, gallium, indium, neodymium). Returns current price and 24-hour change percentage. Free tier covers 5 key commodities; paid tier covers all 31.

Monitor real-time port congestion and vessel traffic at 26 major global ports. Returns vessel counts at berth and at anchor, congestion score versus historical baseline, and port status. Covers US ports (Los Angeles, Long Beach, Savannah, Houston, New York/New Jersey, Charleston, Oakland, Seattle, Tacoma), Asian ports (Shanghai, Singapore, Busan, Ningbo, Shenzhen, Hong Kong), and European ports (Rotterdam, Hamburg, Antwerp, Felixstowe, Piraeus). Used by freight forwarders, logistics teams, and importers to monitor delays, plan routing, and anticipate lead time changes.

Get real-time supply chain disruption alerts from global news intelligence and event detection. Returns categorized alerts for port closures, trade policy changes, tariff actions, natural disasters, labor strikes, sanctions, commodity shortages, and weather disruptions. Each alert includes severity level, affected supply chain stage (sourcing, manufacturing, logistics, distribution), and risk score. Free tier returns critical-severity alerts only; paid tier returns all severities.

Get statistically validated leading indicator signals evaluated against live GDI and SMI data. Each signal is a Granger-causal relationship (p≤0.01) with a specific lag time and directional accuracy. Returns ACTIVE, WATCH, or CLEAR status for each signal. Paid tier only.

Get real-time commercial border crossing wait times at US-Mexico and US-Canada ports of entry. Returns current delay in minutes for commercial vehicles, number of lanes open, and port status. Updated every 30 minutes from US Customs and Border Protection. Covers all major commercial crossings including Laredo, El Paso, Nogales, Otay Mesa, Detroit, Buffalo, and Blaine. Used by logistics companies, freight brokers, and trucking operations to route cross-border shipments through the fastest crossing points.

Monitor real-time vessel traffic and congestion at critical maritime chokepoints — Suez Canal, Panama Canal, Strait of Malacca, Strait of Hormuz, Bab el-Mandeb, and other strategic waterways. Returns total vessel count, average speed, count of slow or stationary vessels, and a congestion score with severity level. When chokepoints congest or close, global shipping routes reroute within days — this data detects that signal in real time.

Get real-time air cargo disruption status at major US and international freight hub airports. Returns FAA ground delays, ground stops, arrival and departure delays with estimated minutes, closure status, disruption score, and traffic collapse detection. Covers major cargo hubs including Memphis (FedEx), Louisville (UPS), Anchorage, Chicago O'Hare, Los Angeles, Miami, New York JFK, and Dallas-Fort Worth. Used by air freight forwarders, express carriers, and logistics planners to reroute time-sensitive shipments around airport disruptions.

Get active trade policy actions currently impacting supply chain risk — tariffs, sanctions, export controls, import restrictions, and regulatory changes. Unlike news alerts that expire after 72 hours, policy adjustments persist as long as the policy is in effect and continue to modify GDI risk scores. Each policy includes the affected GDI pillar, score modifier, effective date, and source event. Used by procurement teams navigating tariff exposure, compliance officers tracking sanctions, and supply chain strategists adapting sourcing to policy shifts.

Get comprehensive US energy market status for supply chain cost analysis. Returns crude oil prices (WTI and Brent), natural gas spot prices (Henry Hub), retail fuel prices (gasoline, diesel), natural gas storage versus capacity, refinery utilization rates, petroleum stock levels with week-over-week changes, and import/export flows. This is the disaggregated view behind the GDI Energy pillar — instead of a single risk number, you get the full picture of energy costs affecting manufacturing, freight, and logistics. Used by supply chain cost analysts, transportation managers, and energy procurement teams.

Get US freight rail performance metrics including average train speed, terminal dwell time, cars on line, trains held per day, railcars not moved within 48 hours, total carloadings, intermodal units, and grain transport rates. Sourced from the Surface Transportation Board railroad service metrics, Association of American Railroads carloading data, and USDA grain transportation reports. When rail slows down, inland supply chains back up within days — this data provides early warning of freight bottlenecks across the US rail network.

Get the US freight transportation health index from the Bureau of Transportation Statistics. Returns the Transportation Services Index (TSI) for freight and passenger, truck tonnage, rail carloadings, rail intermodal volume, waterborne freight, inventory-to-sales ratio, and industrial production index. Declining freight volumes are a leading indicator of economic slowdown. Used by logistics companies, freight brokers, and economic analysts tracking US freight demand trends.

Get key economic indicators affecting supply chain costs and conditions. Returns Federal Reserve data (industrial production, capacity utilization, manufacturing PMI, housing starts, imports), Producer Price Index by category, Global Supply Chain Pressure Index (GSCPI) from the New York Fed, and EIA Short-Term Energy Outlook forecasts. Used by supply chain strategists, procurement leaders, and economic analysts who need the macro backdrop for supply chain planning.

Statistically validated leading indicator signals evaluated against live supply chain data. Each signal is a Granger-causal relationship tested at p<=0.01 with directional accuracy >=55%. Signals predict commodity price movements, manufacturing shifts, and macroeconomic changes 1 week to 6 months ahead. Returns ACTIVE (threshold crossed — act now), WATCH (approaching threshold — prepare), or CLEAR status for each signal. 58 signals across 3 tiers organized by predictor group (GDI pillars, SMI regions, cross-index spreads). Used by commodity traders for forward-looking positioning, procurement teams for buy/defer timing, and hedge funds for alternative data signals.

Detect unusual electricity demand patterns that signal manufacturing disruptions before they appear in official reports. Monitors 8 US power grid regions (PJM, MISO, ERCOT, CAISO, SPP, ISNE, NYISO, NW) for demand anomalies — sudden drops indicate factory shutdowns, surges indicate production ramp-ups. Returns current SMI score with regional breakdown plus anomalies from the past 7 days ranked by severity. The Supply Manufacturing Index (SMI) uses patent-pending weather normalization to isolate industrial demand from weather-driven consumption. Used by commodity traders for early manufacturing signals and procurement teams to anticipate supply changes.

Comprehensive weekly supply chain situation report combining all SupplyMaven data sources into an executive-level brief. Includes GDI score with pillar breakdown and trend, top disruption events with risk scores, manufacturing output status across 8 regions, commodity price movements, port congestion highlights, and active predictive signals. Designed to answer 'what happened this week in supply chains?' in a single call. Used by executives, procurement leaders, and supply chain managers for weekly risk reviews and stakeholder briefings.

Get plain-language explanations of active predictive signals. Each narrative explains the mechanism behind a signal — why the predictor leads the target, what economic logic connects them, and what the current reading implies. Designed for non-quantitative users who want to understand the 'why' behind each signal without reading F-statistics. Returns trigger context, predictor value, direction, and a narrative paragraph suitable for reports and briefings.

Get the US Energy Information Administration's Short-Term Energy Outlook (STEO) — official government forecasts for energy production, consumption, and pricing. Returns both historical actuals and forward-looking projections for crude oil prices, natural gas prices, electricity generation, renewable energy production, and petroleum consumption. The STEO is the most widely referenced energy forecast in the world. Distinguishes actual historical data from projected forecasts using the isActual flag. Used by energy traders, logistics companies budgeting fuel costs, and macro analysts.

Get trend analysis of the Global Disruption Index over time. Returns the current GDI score plus 7-day, 14-day, and 30-day comparisons with direction, velocity of change, and pillar-level momentum. Identifies which pillar is driving changes and whether risk is accelerating or decelerating. Answers: 'Is supply chain risk getting better or worse, how fast, and why?' Used by supply chain executives for weekly status briefings and by traders to time entry/exit decisions around supply chain volatility.

Get alerts for commodities experiencing abnormal price volatility. Flags any commodity where the 24-hour price change exceeds normal ranges or where prices are at extreme levels. Returns the current price, 24-hour change percentage, trend direction, and risk assessment. Answers 'which commodities are behaving unusually right now?' — a question that takes procurement teams hours to answer manually. Used by procurement teams to time purchases, commodity traders to identify opportunities, and supply chain managers to anticipate cost changes.

Get port congestion trend analysis — not just current congestion, but direction and trajectory. Returns how congestion has changed relative to historical baselines, identifies ports where congestion is accelerating, and flags ports approaching critical thresholds. Answers: 'Which ports are getting worse and how fast?' Used by logistics planners to reroute shipments before congestion peaks, and by importers to anticipate lead time extensions.

Get AI-generated intelligence briefs for each supply chain dimension — energy, materials, transportation, macro, and manufacturing. Each brief provides a narrative analysis of current conditions, key drivers, emerging risks, and recommended watch items. These are not raw data — they are synthesized analytical summaries generated every hour from live data. Designed for decision-makers who need a quick read on each supply chain dimension. Returns structured briefs suitable for executive dashboards, email digests, or Slack channels.

Get the weekly 'Signal of the Week' content package — a pre-written, data-verified marketing bundle generated every Monday from live SupplyMaven data. Returns a Substack article (~500 words), LinkedIn post (~200 words), and Twitter/X thread (4-5 tweets), all built from verified supply chain data. Every number in the content traces back to a live data source. Designed for automated content distribution via Claude Desktop + platform MCP servers. The content package includes the signal headline, full data context (GDI, SMI, commodities, ports, signals), and platform-specific formatted content ready for publishing.