# USA, Puerto Rico and US Virgin Islands buyer opportunity lanes

Trade opportunity lane records for buyers in USA, Puerto Rico and US Virgin Islands, combining demand, suppliers, competition, access, and product history.

## What one row represents
one exporter, importer, and HS6 product lane

## Included data
- Buyer demand and exporter position
- Supplier competition and market share
- Access, volatility, and lane history

## 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
- `exporter_iso3` — `String`
- `importer_iso3` — `String`
- `hs_code` — `String`
- `hs_description` — `String`
- `hs_chapter` — `String`
- `hs_heading` — `String`
- `price_range_label` — `Nullable(String)`
- `trade_type_label` — `Nullable(String)`
- `substitution_elasticity` — `Nullable(Float64)`
- `buyer_imports_latest_usd` — `Float64`
- `buyer_imports_avg_usd` — `Float64`
- `buyer_imports_peak_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)`
- `buyer_gdp_mn_latest` — `Nullable(Float64)`
- `buyer_gdp_pc_latest` — `Nullable(Float64)`
- `buyer_population_latest` — `Nullable(Float64)`
- `buyer_investment_rate` — `Nullable(Float64)`
- `buyer_savings_rate` — `Nullable(Float64)`
- `buyer_edu_secondary` — `Nullable(Float64)`
- `buyer_gdp_mn_2030_proj` — `Nullable(Float64)`
- `buyer_gdp_pc_2030_proj` — `Nullable(Float64)`
- `buyer_gdp_pc_growth_pct` — `Nullable(Float64)`
- `buyer_gdp_mn_growth_pct` — `Nullable(Float64)`
- `buyer_pop_growth_pct` — `Nullable(Float64)`
- `exports_latest_usd` — `Float64`
- `exports_avg_usd` — `Float64`
- `exports_peak_usd` — `Float64`
- `share_latest_pct` — `Float64`
- `share_avg_pct` — `Float64`
- `share_peak_pct` — `Float64`
- `share_change_1y_pp` — `Nullable(Float64)`
- `share_trend_pp_per_yr` — `Nullable(Float64)`
- `cagr_full_pct` — `Nullable(Float64)`
- `yoy_avg_pct` — `Nullable(Float64)`
- `yoy_latest_pct` — `Nullable(Float64)`
- `trend_consistency_pct` — `Nullable(Float64)`
- `exports_proj_3y_usd` — `Nullable(Float64)`
- `exports_proj_5y_usd` — `Nullable(Float64)`
- `your_share_gap_pp` — `Nullable(Float64)`
- `addressable_proj_3y_usd` — `Nullable(Float64)`
- `addressable_proj_5y_usd` — `Nullable(Float64)`
- `peer_best_share_pct` — `Float64`
- `peer_top_exporter` — `String`
- `num_suppliers_latest` — `UInt16`
- `buyer_herfindahl_index` — `Float64`
- `distance_km` — `Nullable(Float64)`
- `shares_official_language` — `Nullable(UInt8)`
- `common_spoken_language_score` — `Nullable(Float64)`
- `has_wto_reported_fta` — `Nullable(UInt8)`
- `buyer_is_eu_member` — `Nullable(UInt8)`
- `buyer_biz_entry_days` — `Nullable(Float64)`
- `shared_legal_system` — `Nullable(UInt8)`
- `shared_religion` — `Nullable(UInt8)`
- `shares_land_border` — `Nullable(UInt8)`
- `buyer_is_wto_member` — `Nullable(UInt8)`
- `lane_volatility_cv` — `Nullable(Float64)`
- `lane_max_drawdown_pct` — `Float64`
- `signal_flag` — `String`
- `lane_data_years` — `UInt16`
- `lane_last_year` — `UInt16`

## Coverage and size
- Coverage: 1995-2024 where reported
- Records: 485,666
- Parquet file size: 113 MB
- SHA-256: `ffcf51c569dbddeaabddd01830bca07ccaba278fc9e73ee4a9595a93a777f83f`

## 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)
- Yugalinks calculated opportunity measures
- OECD Terms & Conditions: https://www.oecd.org/termsandconditions/