# Global product exporter market intelligence

Exporter-level HS6 product market positions with destination counts, growth, concentration, and leading markets.

## What one row represents
one exporter and one HS6 product code

## Included data
- Observed import-export measures
- Country and product identifiers
- Coverage and calculated measures where provided

## Metric notes
- USD fields are monetary values denominated in US dollars.
- Country fields use three-letter ISO 3166-1 country codes.
- HS6 identifies a product at the six-digit Harmonized System level.
- Growth percentages compare reported values across the relevant periods; calculated and projected fields are identified in the schema.

## Fields
- `hs_code` — `String`
- `exporter_iso3` — `String`
- `first_data_year` — `UInt16`
- `latest_data_year` — `UInt16`
- `observed_lane_count` — `UInt32`
- `current_lane_count` — `UInt32`
- `active_market_count` — `UInt16`
- `exports_latest_observed_lanes_usd` — `Float64`
- `exports_current_2024_usd` — `Float64`
- `exports_avg_3y_usd` — `Nullable(Float64)`
- `exports_avg_5y_usd` — `Nullable(Float64)`
- `exports_avg_10y_usd` — `Nullable(Float64)`
- `exports_cagr_3y_pct` — `Nullable(Float64)`
- `exports_cagr_5y_pct` — `Nullable(Float64)`
- `exports_cagr_10y_pct` — `Nullable(Float64)`
- `exports_all_year_lane_avg_usd` — `Float64`
- `exports_historical_lane_peak_usd` — `Float64`
- `historical_peak_year` — `UInt16`
- `positive_growth_year_share_pct` — `Nullable(Float64)`
- `trend_acceleration_pct` — `Nullable(Float64)`
- `trend_label` — `LowCardinality(String)`
- `top_market_iso3` — `String`
- `top_market_exports_usd` — `Float64`
- `top_market_share_pct` — `Nullable(Float64)`
- `destination_hhi` — `Float64`
- `weighted_share_latest_pct` — `Nullable(Float64)`
- `weighted_share_change_1y_pp` — `Nullable(Float64)`
- `weighted_volatility_cv` — `Nullable(Float64)`
- `weighted_max_drawdown_pct` — `Nullable(Float64)`
- `limited_history_lane_share_pct` — `Float64`
- `data_freshness_years` — `UInt8`
- `coverage_score` — `Float64`
- `confidence_label` — `LowCardinality(String)`
- `refreshed_at` — `DateTime`

## Coverage and size
- Coverage: 1995-2024 where reported
- Records: 965,105
- Parquet file size: 188 MB
- SHA-256: `e11c749d0ecfa67fd929f0b05f9cba98a494c9e0bd5b8a8337937909e84d1d3d`

## Files
- `data.parquet` - complete dataset
- `manifest.json` - release metadata and checksums
- `schema.json` - field names, types, and metric notes
- `sample.json` - example records
- `README.md` - dataset documentation

## Read with Python
```python
import pandas as pd
data = pd.read_parquet("data.parquet")
print(data.head())
```

## Sources
- OECD Balanced International Merchandise Trade Statistics (BIMTS)
- OECD Terms & Conditions: https://www.oecd.org/termsandconditions/