Maersk and NYSHEX exchange container freight rate data through a fully automated, bidirectional API-driven integration — powering trusted NYFI benchmarks with scheduled, auditable pipelines.
The NYSHEX Freight Indices (NYFI) are global benchmarks for containerized freight pricing. Maersk, as a founding carrier member, provides the rate data that powers these indices.
As the world's largest container shipping company and co-founder of NYSHEX, Maersk provides weekly container rate data from its global operations. This data — covering trade lanes, port pairs, and equipment types — forms the foundation of trusted freight indices.
Data ProviderNYSHEX generates the NYFI freight indices: transparent, independently governed benchmarks used for index-linked contracts, futures, and market analysis. Built with published methodology and oversight by an independent board.
Index GeneratorAn automated, bidirectional API integration: Maersk pushes rate data to NYSHEX's NYFI PRO endpoint, and NYSHEX returns timeframe index data to Maersk's API — all through secure, auditable, scheduled pipelines.
ArchitectureSee how this integration serves different roles across the shipping ecosystem.
As data provider and co-founder, operational efficiency and market intelligence matter most.
Rate data is extracted from Azure Blob Storage and processed automatically. No manual compilation or formatting errors. Data flows from internal systems to NYSHEX every Friday at 08:30 UTC.
Receive NYFI indices back — including percentile distributions (P10–P90), week-over-week, and month-over-month trends — to benchmark Maersk's pricing against market rates.
Every rate is split into "with DHC" and "without DHC" variants, enabling granular analysis of surcharge impact across trade lanes and container types.
Kafka with Avro serialization, Schema Registry validation, and exponential-backoff retry ensures every data point reaches NYSHEX — with full auditability.
Reliable data inputs and trusted index generation are the foundation of NYFI's market credibility.
Receives rates via the NYFI PRO API in a standardized, schema-validated format — ensuring consistent, machine-readable data ingestion every cycle.
Automated, tamper-proof data pipeline with OAuth2 authentication strengthens the independent board's confidence in data quality and provenance.
Publishes computed indices back to Maersk via POST /timeframes — including MARKET_RATE and MY_RATE types with full percentile distributions across trade lanes.
Eliminates the delay between receiving data and ingestion. Rates arrive in machine-readable format, ready for immediate processing into weekly NYFI benchmarks.
Better data quality upstream means more reliable benchmarks for managing freight spend and volatility.
NYFI indices powered by automated, auditable data pipelines are more trustworthy for index-linked contracts — reducing disputes and improving transparency.
Weekly percentile distributions (P10–P90) and trend indicators (WoW, MoM) enable proactive freight budget planning and hedging strategies.
Indices cover major trades (Trans-Pacific, Asia-Europe), sub-routes (Far East to USWC), and specific port pairs (CNNBO to USLAX) — deep granularity for procurement.
Index-linked contracts anchored to NYFI reduce the information asymmetry between carriers and shippers, fostering a more balanced negotiation landscape.
Trace the journey of container rate data between Maersk and NYSHEX. Click any node to explore its internals.
Quantified business improvements from API-driven automation of freight index data exchange.
Zero manual data extraction or formatting. The scheduled pipeline handles everything end-to-end, every Friday at 08:30 UTC.
EfficiencyFrom blob extraction to NYSHEX ingestion in under 5 minutes — automated, end-to-end, with zero manual steps.
SpeedFull percentile distributions, WoW/MoM trends, and MARKET_RATE vs MY_RATE comparison returned per trade lane, route, and port pair.
Data QualityExponential-backoff retry with Kafka persistence ensures no data loss. Every rate submission is tracked through the event pipeline with metrics.
ReliabilityEach record produces two rate variants (with/without DHC), giving both parties granular surcharge visibility for every lane and container type.
TransparencyConfluent Schema Registry enforces data contracts. Breaking changes are caught at serialization time — not after index calculation errors.
ScalabilityHow different stakeholders benefit from the integrated freight index pipeline.
Every Friday at 08:30 UTC, the Index Price Engine automatically picks up the week's container rate data from Azure Blob Storage — covering all trade lanes, equipment types, and port pairs. It maps each record into NYFI PRO format with DHC-split logic, wraps it in Avro envelopes, and delivers to NYSHEX via Kafka + Generic Sender.
After NYSHEX processes Maersk's rate contribution alongside other carriers, it returns computed timeframe indices via POST /timeframes. The Index Price API validates the payload, maps it to Avro, and publishes to the finance Kafka topic — where internal consumers access MARKET_RATE benchmarks (industry-wide) and MY_RATE indices (Maersk-specific) with full percentile breakdowns.
Shippers negotiating long-term contracts with Maersk can reference NYFI benchmarks as a neutral pricing anchor. The automated pipeline ensures indices reflect the most current carrier data — updated weekly — so contract adjustments track actual market movements rather than stale or disputed figures.
Risk managers use the P10–P90 percentile distribution from NYFI indices to quantify freight rate volatility across trade lanes. Week-over-week (WoW) and month-over-month (MoM) trends enable early detection of rate swings, informing hedging strategies and budget forecasts before volatility impacts the bottom line.
Freight forwarders comparing carrier offers can isolate the DHC (Destination Handling Charge) component using the dual-rate split. Each record comes with both "with DHC" and "without DHC" pricing, making it transparent exactly how much the surcharge adds per container type and trade lane — critical for accurate cost-plus quoting to end customers.