# Global buyer market history by HS6

Buyer-market import history by HS6 product with supplier counts, concentration, growth, and projected measures.

## What one row represents
one importing country 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.
- Growth percentages compare reported values across the relevant periods; calculated and projected fields are identified in the schema.

## Fields
- `importer_iso3` — `String`
- `hs_code` — `String`
- `buyer_imports_latest_usd` — `Float64`
- `buyer_imports_avg_usd` — `Float64`
- `buyer_imports_peak_usd` — `Float64`
- `buyer_imports_first_usd` — `Float64`
- `buyer_cagr_full_pct` — `Nullable(Float64)`
- `buyer_yoy_avg_pct` — `Nullable(Float64)`
- `buyer_yoy_latest_pct` — `Nullable(Float64)`
- `buyer_trend_consistency_pct` — `Nullable(Float64)`
- `buyer_imports_proj_3y_usd` — `Nullable(Float64)`
- `buyer_imports_proj_5y_usd` — `Nullable(Float64)`
- `num_suppliers_latest` — `UInt16`
- `peer_best_share_pct` — `Float64`
- `peer_top_exporter` — `String`
- `buyer_herfindahl_index` — `Float64`
- `buyer_data_from_year` — `UInt16`
- `buyer_data_to_year` — `UInt16`

## Coverage and size
- Coverage: 1995-2024 where reported
- Records: 1,059,724
- Parquet file size: 108 MB
- SHA-256: `9bef4c974ade197e56d6123a6ad09192aa882978b41717b2b47909838882c7f1`

## 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/