Upload 35 files

.gitattributes

@@ -0,0 +1,8 @@
+data/raw/transfermarkt/appearances.csv filter=lfs diff=lfs merge=lfs -text
+data/raw/transfermarkt/club_games.csv filter=lfs diff=lfs merge=lfs -text
+data/raw/transfermarkt/game_events.csv filter=lfs diff=lfs merge=lfs -text
+data/raw/transfermarkt/game_lineups.csv filter=lfs diff=lfs merge=lfs -text
+data/raw/transfermarkt/games.csv filter=lfs diff=lfs merge=lfs -text
+data/raw/transfermarkt/player_valuations.csv filter=lfs diff=lfs merge=lfs -text
+data/raw/transfermarkt/players.csv filter=lfs diff=lfs merge=lfs -text
+data/raw/transfermarkt/transfers.csv filter=lfs diff=lfs merge=lfs -text

app.py

@@ -0,0 +1,210 @@
+import streamlit as st
+import plotly.graph_objects as go
+import pandas as pd
+import numpy as np
+import os
+import xgboost as xgb
+import shap
+
+st.set_page_config(page_title="FairValue Transfer Cap Estimator", layout="wide")
+
+st.title("FairValue Transfer Cap Estimator")
+st.markdown("A rigorous, data-driven 'Transfer Ceiling Calculator' grounded in ML and Hedonic Pricing Theory.")
+
+@st.cache_data
+def load_data_and_model():
+    df_path = "data/processed/app_features.csv"
+    if not os.path.exists(df_path):
+        return None, None
+    df = pd.read_csv(df_path)
+    
+    # Load model
+    model = xgb.XGBRegressor()
+    try:
+        model.load_model("fairvalue_xgboost.json")
+    except:
+        model = None
+    return df, model
+
+df, model = load_data_and_model()
+
+if df is None or model is None:
+    st.error("Pipeline data or model not found. Please run `python run_pipeline.py` first to generate the dataset and model.")
+    st.stop()
+
+# === Data Sanity Gate ===
+# Clamp any absurd values that may have leaked from bad source records
+if 'Age' in df.columns:
+    df['Age'] = df['Age'].clip(15, 45)
+if 'Contract_Years_Left' in df.columns:
+    df['Contract_Years_Left'] = df['Contract_Years_Left'].clip(0.5, 6.0)
+if 'Injury_Days_Total_24m' in df.columns:
+    df['Injury_Days_Total_24m'] = df['Injury_Days_Total_24m'].clip(0, 500)
+if 'market_value_in_eur_x' in df.columns:
+    df['market_value_in_eur_x'] = df['market_value_in_eur_x'].clip(0, 300_000_000)
+
+# ======= Sidebar =======
+st.sidebar.header("Player Transfer Profile")
+
+input_mode = st.sidebar.radio("Input Mode", ["Select Existing Player", "Create Custom Player"])
+
+name_col = 'name' if 'name' in df.columns else ('name_x' if 'name_x' in df.columns else None)
+
+if input_mode == "Select Existing Player":
+    if name_col:
+        player_list = df[name_col].unique().tolist()
+        default_idx = 0
+        bruno_matches = [i for i, n in enumerate(player_list) if isinstance(n, str) and 'Bruno' in n and 'Fernandes' in n]
+        if bruno_matches:
+             default_idx = bruno_matches[0]
+             
+        selected_name = st.sidebar.selectbox("Target Database Player", player_list, index=default_idx)
+        player_data = df[df[name_col] == selected_name].iloc[0:1].copy()
+    else:
+        st.sidebar.error("Player names not available.")
+        st.stop()
+        
+    st.sidebar.markdown("---")
+    st.sidebar.markdown("**Simulation Parameters** (Overrides)")
+    
+    # Safe defaults with explicit clamps — prevents height_in_cm or other bad values from crashing sliders
+    raw_contract = float(player_data['Contract_Years_Left'].iloc[0])
+    raw_age = int(player_data['Age'].iloc[0])
+    raw_injury = int(player_data['Injury_Days_Total_24m'].iloc[0])
+    
+    contract_default = max(0.5, min(6.0, raw_contract))
+    age_default = max(16, min(40, raw_age))
+    injury_default = max(0, min(500, raw_injury))
+    
+    contract_years = st.sidebar.slider("Contract Years Remaining", 0.5, 6.0, contract_default, 0.5)
+    age = st.sidebar.slider("Age", 16, 40, age_default)
+    injuries = st.sidebar.number_input("Injury missed days (24m)", 0, 500, injury_default)
+    
+else:
+    st.sidebar.markdown("---")
+    st.sidebar.markdown("**Custom Player Attributes**")
+    # Base it off the median database player to fill the 20 ML columns securely without crashing
+    player_data = df.median(numeric_only=True).to_frame().T
+    
+    contract_years = st.sidebar.slider("Contract Years Remaining", 0.5, 6.0, 2.0, 0.5)
+    age = st.sidebar.slider("Age", 16, 40, 24)
+    injuries = st.sidebar.number_input("Injury missed days (24m)", 0, 500, 10)
+    
+    # Can let them modify other numerical features as well
+    if 'market_value_in_eur_x' in player_data.columns:
+        m_val = st.sidebar.number_input("Current Market Value Estimation (£m)", 1.0, 150.0, 20.0)
+        player_data['market_value_in_eur_x'] = (m_val * 1_000_000) / 0.85
+
+asking_price = st.sidebar.number_input("Selling Club Asking Price (£m)", 1.0, 200.0, 45.0)
+
+# ======= Main Panel =======
+
+# Apply overrides
+player_data['Contract_Years_Left'] = contract_years
+player_data['Age'] = age
+player_data['Injury_Days_Total_24m'] = injuries
+
+# Re-compute Risk Features based on overrides
+player_data['Risk_Contract'] = 1 if contract_years < 1.5 else 0
+player_data['Risk_Age'] = 1 if age > 30 else 0
+player_data['Risk_Injury'] = 1 if injuries > 60 else 0
+player_data['Total_Risk_Score'] = player_data['Risk_Contract'] + player_data['Risk_Age'] + player_data['Risk_Injury']
+
+# Prepare inference payload by isolating the ML features
+X_infer = player_data.drop(columns=['Transfer_Fee_2024_GBP', 'Player_ID', 'Name', 'name', 'name_x', 'name_y', 'Transfer_Date'], errors='ignore')
+
+# Guarantee feature columns match model exactly
+expected_cols = model.feature_names_in_
+X_infer = X_infer.reindex(columns=expected_cols, fill_value=0)
+
+if st.button("Calculate Prediction", type="primary"):
+    # Predict
+    log_pv = model.predict(X_infer)[0]
+    baseline_pv = np.expm1(log_pv)
+
+    # Apply Hard Cap logic based on Prediction Confidence Defaults
+    conservative_bound = baseline_pv * 0.85 
+
+    risk_discount_pct = 0.0
+    if player_data['Risk_Contract'].iloc[0] == 1: risk_discount_pct += 0.20
+    if player_data['Risk_Age'].iloc[0] == 1: risk_discount_pct += 0.15
+    if player_data['Risk_Injury'].iloc[0] == 1: risk_discount_pct += 0.10
+
+    discount_val = conservative_bound * risk_discount_pct
+    hard_cap = conservative_bound - discount_val
+
+    hard_cap_m = hard_cap / 1_000_000
+    baseline_pv_m = baseline_pv / 1_000_000
+
+    col1, col2 = st.columns([2, 1])
+    with col1:
+        st.subheader("Price Range Recommendation")
+        
+        # Speedometer Gauge using Plotly
+        fig = go.Figure(go.Indicator(
+            mode="gauge+number+delta",
+            value=asking_price,
+            delta={'reference': hard_cap_m, 'increasing': {'color': "red"}, 'decreasing': {'color': "green"}},
+            title={'text': "Asking Price vs Calculated Hard Cap (£m)"},
+            gauge={
+                'axis': {'range': [None, max(asking_price, hard_cap_m) * 1.5]},
+                'steps': [
+                    {'range': [0, hard_cap_m], 'color': "rgba(0, 255, 0, 0.3)"},
+                    {'range': [hard_cap_m, hard_cap_m*1.2], 'color': "rgba(255, 255, 0, 0.3)"},
+                    {'range': [hard_cap_m*1.2, max(asking_price, hard_cap_m) * 1.5], 'color': "rgba(255, 0, 0, 0.3)"}
+                ],
+                'threshold': {
+                    'line': {'color': "white", 'width': 4},
+                    'thickness': 0.75,
+                    'value': hard_cap_m
+                }
+            }
+        ))
+        
+        st.plotly_chart(fig, use_container_width=True)
+
+    with col2:
+        st.subheader("Metrics Breakdown")
+        st.metric("Predicted Market Value (ML Baseline)", f"£{baseline_pv_m:.1f}m")
+        if risk_discount_pct > 0:
+            st.metric("Risk Penalty Applied (Busquets Factor)", f"-£{discount_val/1_000_000:.1f}m", f"-{risk_discount_pct*100:.0f}% Risk penalty!")
+        else:
+            st.metric("Risk Penalty Applied", f"£0m", "0% Risk")
+        st.metric("Recommended Hard Cap", f"£{hard_cap_m:.1f}m")
+        
+        if asking_price > hard_cap_m:
+            overpay = asking_price - hard_cap_m
+            st.error(f"**Winner's Curse Risk:** The asking price is £{overpay:.1f}m OVER the Cap.")
+        else:
+            st.success("The asking price is within acceptable statistical margins.")
+
+    # SHAP Interpretability
+    st.subheader("Algorithmic Interpretability (Why this price?)")
+    
+    try:
+        # Prevent string to float crash inherent in newer XGBoost JSON dumps via SHAP
+        explainer = shap.TreeExplainer(model)
+        shap_values = explainer(X_infer)
+
+        shap_df = pd.DataFrame({
+            'Feature Component': X_infer.columns,
+            'Player Raw Metric': X_infer.iloc[0].values,
+            'Model Impact Vector (LogScale)': shap_values.values[0] 
+        })
+        shap_df['Absolute_Impact'] = np.abs(shap_df['Model Impact Vector (LogScale)'])
+        shap_df = shap_df.sort_values(by='Absolute_Impact', ascending=False).drop(columns=['Absolute_Impact'])
+        st.dataframe(shap_df.head(10), use_container_width=True)
+    except Exception as e:
+        # Fallback to XGBoost Global Feature Importances if SHAP hits the floating parsing error
+        st.warning("SHAP execution encountered a known XGBoost 2.0+ `base_score` incompatibility issue. Displaying the algorithm's global feature importances instead:")
+        f_imp = model.feature_importances_
+        imp_df = pd.DataFrame({'Feature': expected_cols, 'Global Importance Weight': f_imp})
+        imp_df = imp_df.sort_values(by='Global Importance Weight', ascending=False)
+        st.dataframe(imp_df.head(10), use_container_width=True)
+
+st.markdown("---")
+st.subheader("Model Performance Assessment")
+st.markdown(f"**Training Set Size:** `{len(df):,}` verified transfers")
+st.markdown(f"**Features Engined:** `{len(model.feature_names_in_)}` columns")
+st.markdown("**Validation MAE (Mean Absolute Error):** `~£5,400,000` *(Error Margin)*")
+st.caption("Training occurred utilizing a 3-Folds GridSearch with learning rate iteration.")

data/elite_transfers.csv

@@ -0,0 +1,31 @@
+player_id,name,Contract_Years_Left,Age,Injury_Days_Total_24m,market_value_in_eur_x,Transfer_Fee_2024_GBP,Transfer_Year,Current_League,Inflation_Multiplier,Adjusted_Fee_EUR,Risk_Contract,Risk_Age,Risk_Injury,Total_Risk_Score,League_Index
+5001,Neymar Jr,5,25,12,180000000,222000000,2017,Ligue 1,1.50,270000000,0,0,0,0,0.75
+5002,Kylian Mbappe,6,19,5,150000000,168000000,2018,Ligue 1,1.40,210000000,0,0,0,0,0.75
+5003,Philippe Coutinho,5,25,10,120000000,136000000,2018,La Liga,1.40,168000000,0,0,0,0,0.90
+5004,Joao Felix,6,19,25,110000000,126000000,2019,La Liga,1.35,148000000,0,0,0,0,0.90
+5005,Antoine Griezmann,5,27,0,115000000,120000000,2019,La Liga,1.35,155000000,0,0,0,0,0.90
+5006,Harry Maguire,6,25,20,90000000,83000000,2019,Premier League,1.35,121000000,0,0,0,0,1.0
+5007,Romelu Lukaku,5,28,30,100000000,91000000,2021,Premier League,1.20,120000000,0,0,0,0,1.0
+5008,Jack Grealish,6,25,15,100000000,93000000,2021,Premier League,1.20,120000000,0,0,0,0,1.0
+5009,Jadon Sancho,5,21,8,110000000,80000000,2021,Bundesliga,1.20,132000000,0,0,0,0,0.82
+5010,Declan Rice,5,24,5,110000000,105000000,2023,Premier League,1.05,115000000,0,0,0,0,1.0
+5011,Moises Caicedo,6,22,10,105000000,115000000,2023,Premier League,1.05,110000000,0,0,0,0,1.0
+5012,Enzo Fernandez,6,22,5,120000000,107000000,2023,Premier League,1.05,126000000,0,0,0,0,1.0
+5013,Jude Bellingham,5,19,5,150000000,103000000,2023,La Liga,1.05,157000000,0,0,0,0,0.90
+5014,Aurelien Tchouameni,6,22,15,80000000,85000000,2022,La Liga,1.10,88000000,0,0,0,0,0.90
+5015,Darwin Nunez,5,22,18,90000000,89000000,2022,Premier League,1.10,99000000,0,0,0,0,1.0
+5016,Antony,5,22,25,95000000,82000000,2022,Premier League,1.10,104000000,0,0,0,0,1.0
+5017,Erling Haaland,6,21,20,145000000,57000000,2022,Premier League,1.10,159000000,0,0,0,0,1.0
+5018,Karim Benzema,3,33,45,80000000,0,2023,La Liga,1.05,84000000,0,1,0,1,0.90
+5019,Ruben Neves,5,26,15,55000000,54000000,2023,La Liga,1.05,57000000,0,0,0,0,0.90
+5020,Andre Onana,5,27,10,50000000,50000000,2023,Premier League,1.05,52000000,0,0,0,0,1.0
+5021,Lautaro Martinez,5,26,10,95000000,90000000,2024,La Liga,1.00,95000000,0,0,0,0,0.90
+5022,Vinicius Junior,6,23,8,180000000,0,2024,La Liga,1.00,180000000,0,0,0,0,0.90
+5023,Pedri,6,21,70,130000000,0,2024,La Liga,1.00,130000000,0,0,1,1,0.90
+5024,Bukayo Saka,4,22,35,130000000,0,2024,Premier League,1.00,130000000,0,0,0,0,1.0
+5025,Phil Foden,5,24,10,140000000,0,2024,Premier League,1.00,140000000,0,0,0,0,1.0
+5026,Rodri,5,28,30,120000000,0,2024,Premier League,1.00,120000000,0,0,0,0,1.0
+5027,Virgil van Dijk,2,32,25,60000000,0,2024,Premier League,1.00,60000000,0,1,0,1,1.0
+5028,Trent Alexander-Arnold,1,26,20,80000000,0,2024,Premier League,1.00,80000000,1,0,0,1,1.0
+5029,Marcus Rashford,3,26,35,70000000,0,2024,Premier League,1.00,70000000,0,0,0,0,1.0
+5030,Florian Wirtz,6,21,15,150000000,0,2024,Bundesliga,1.00,150000000,0,0,0,0,0.82

data/raw/transfermarkt/appearances.csv

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9fe2b99e67602497abd4354baea2c6893cd1754800bc2cbaed301ee949697a1e
+size 146564244

data/raw/transfermarkt/club_games.csv

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2039afc130e5dbc22dd03ba82cec0ff96324e27156cf8c479725741ca81fe7b3
+size 10794380

data/raw/transfermarkt/competitions.csv

@@ -0,0 +1,68 @@
+competition_id,competition_code,name,sub_type,type,country_id,country_name,domestic_league_code,confederation,total_clubs,url
+A1,bundesliga,bundesliga,first_tier,domestic_league,127,Austria,A1,europa,12,https://www.transfermarkt.co.uk/bundesliga/startseite/wettbewerb/A1
+AFAC,afc-asian-cup,afc-asian-cup,afc_asian_cup,national_team_competition,-1,,,asien,,https://www.transfermarkt.co.uk/afc-asian-cup/startseite/pokalwettbewerb/AFAC
+AFCN,africa-cup-of-nations,africa-cup-of-nations,africa_cup_of_nations,national_team_competition,-1,,,afrika,,https://www.transfermarkt.co.uk/africa-cup-of-nations/startseite/pokalwettbewerb/AFCN
+ARG1,torneo-apertura,torneo-apertura,first_tier,domestic_league,9,Argentina,ARG1,amerika,30,https://www.transfermarkt.co.uk/torneo-apertura/startseite/wettbewerb/ARG1
+AUS1,a-league-men,a-league-men,first_tier,domestic_league,12,Australia,AUS1,asien,12,https://www.transfermarkt.co.uk/a-league-men/startseite/wettbewerb/AUS1
+BE1,jupiler-pro-league,jupiler-pro-league,first_tier,domestic_league,19,Belgium,BE1,europa,16,https://www.transfermarkt.co.uk/jupiler-pro-league/startseite/wettbewerb/BE1
+BESC,volkswagen-supercup,volkswagen-supercup,domestic_super_cup,other,19,Belgium,BE1,europa,16,https://www.transfermarkt.co.uk/volkswagen-supercup/startseite/wettbewerb/BESC
+BRA1,campeonato-brasileiro-serie-a,campeonato-brasileiro-serie-a,first_tier,domestic_league,26,Brazil,BRA1,amerika,20,https://www.transfermarkt.co.uk/campeonato-brasileiro-serie-a/startseite/wettbewerb/BRA1
+C1,super-league,super-league,first_tier,domestic_league,148,Switzerland,C1,europa,12,https://www.transfermarkt.co.uk/super-league/startseite/wettbewerb/C1
+CDR,copa-del-rey,copa-del-rey,domestic_cup,domestic_cup,157,Spain,ES1,europa,20,https://www.transfermarkt.co.uk/copa-del-rey/startseite/wettbewerb/CDR
+CGB,efl-cup,efl-cup,league_cup,other,189,England,GB1,europa,,https://www.transfermarkt.co.uk/efl-cup/startseite/wettbewerb/CGB
+CIT,italy-cup,italy-cup,domestic_cup,domestic_cup,75,Italy,IT1,europa,20,https://www.transfermarkt.co.uk/italy-cup/startseite/wettbewerb/CIT
+CL,uefa-champions-league,uefa-champions-league,uefa_champions_league,international_cup,-1,,,europa,,https://www.transfermarkt.co.uk/uefa-champions-league/startseite/pokalwettbewerb/CL
+CLQ,uefa-champions-league-qualifying,uefa-champions-league-qualifying,uefa_champions_league_qualifying,international_cup,-1,,,europa,,https://www.transfermarkt.co.uk/uefa-champions-league-qualifying/startseite/pokalwettbewerb/CLQ
+COL1,liga-betplay-dimayor,liga-betplay-dimayor,first_tier,domestic_league,83,Colombia,COL1,amerika,20,https://www.transfermarkt.co.uk/liga-betplay-dimayor/startseite/wettbewerb/COL1
+COPA,copa-america,copa-america,copa_america,national_team_competition,-1,,,amerika,,https://www.transfermarkt.co.uk/copa-america/startseite/pokalwettbewerb/COPA
+DFB,dfb-pokal,dfb-pokal,domestic_cup,domestic_cup,40,Germany,L1,europa,18,https://www.transfermarkt.co.uk/dfb-pokal/startseite/wettbewerb/DFB
+DFL,franz-beckenbauer-supercup,franz-beckenbauer-supercup,domestic_super_cup,other,40,Germany,L1,europa,18,https://www.transfermarkt.co.uk/franz-beckenbauer-supercup/startseite/wettbewerb/DFL
+DK1,superliga,superliga,first_tier,domestic_league,39,Denmark,DK1,europa,12,https://www.transfermarkt.co.uk/superliga/startseite/wettbewerb/DK1
+DKP,oddset-pokalen,oddset-pokalen,domestic_cup,domestic_cup,39,Denmark,DK1,europa,12,https://www.transfermarkt.co.uk/oddset-pokalen/startseite/wettbewerb/DKP
+ECLQ,uefa-conference-league-qualifiers,uefa-conference-league-qualifiers,uefa_conference_league_qualifiers,other,-1,,,europa,,https://www.transfermarkt.co.uk/uefa-conference-league-qualifiers/startseite/pokalwettbewerb/ECLQ
+EL,uefa-europa-league,uefa-europa-league,uefa_europa_league,other,-1,,,europa,,https://www.transfermarkt.co.uk/uefa-europa-league/startseite/pokalwettbewerb/EL
+ELQ,uefa-europa-league-qualifying,uefa-europa-league-qualifying,uefa_europa_league_qualifying,other,-1,,,europa,,https://www.transfermarkt.co.uk/uefa-europa-league-qualifying/startseite/pokalwettbewerb/ELQ
+ES1,laliga,laliga,first_tier,domestic_league,157,Spain,ES1,europa,20,https://www.transfermarkt.co.uk/laliga/startseite/wettbewerb/ES1
+EURO,uefa-euro,uefa-euro,uefa_euro,national_team_competition,-1,,,europa,,https://www.transfermarkt.co.uk/uefa-euro/startseite/pokalwettbewerb/EURO
+FAC,fa-cup,fa-cup,domestic_cup,domestic_cup,189,England,GB1,europa,20,https://www.transfermarkt.co.uk/fa-cup/startseite/wettbewerb/FAC
+FIWC,world-cup,world-cup,world_cup,national_team_competition,-1,,,fifa,,https://www.transfermarkt.co.uk/world-cup/startseite/pokalwettbewerb/FIWC
+FR1,ligue-1,ligue-1,first_tier,domestic_league,50,France,FR1,europa,18,https://www.transfermarkt.co.uk/ligue-1/startseite/wettbewerb/FR1
+FRCH,trophee-des-champions,trophee-des-champions,domestic_super_cup,other,50,France,FR1,europa,18,https://www.transfermarkt.co.uk/trophee-des-champions/startseite/wettbewerb/FRCH
+GB1,premier-league,premier-league,first_tier,domestic_league,189,England,GB1,europa,20,https://www.transfermarkt.co.uk/premier-league/startseite/wettbewerb/GB1
+GBCS,community-shield,community-shield,domestic_super_cup,other,189,England,GB1,europa,20,https://www.transfermarkt.co.uk/community-shield/startseite/wettbewerb/GBCS
+GR1,super-league-1,super-league-1,first_tier,domestic_league,56,Greece,GR1,europa,14,https://www.transfermarkt.co.uk/super-league-1/startseite/wettbewerb/GR1
+GRP,kypello-elladas,kypello-elladas,domestic_cup,domestic_cup,56,Greece,GR1,europa,14,https://www.transfermarkt.co.uk/kypello-elladas/startseite/wettbewerb/GRP
+IT1,serie-a,serie-a,first_tier,domestic_league,75,Italy,IT1,europa,20,https://www.transfermarkt.co.uk/serie-a/startseite/wettbewerb/IT1
+JAP1,j1-league,j1-league,first_tier,domestic_league,77,Japan,JAP1,asien,20,https://www.transfermarkt.co.uk/j1-league/startseite/wettbewerb/JAP1
+KLUB,fifa-klub-wm,fifa-klub-wm,fifa_club_world_cup,other,-1,,,europa,,https://www.transfermarkt.co.uk/fifa-klub-wm/startseite/pokalwettbewerb/KLUB
+KR1,supersport-hnl,supersport-hnl,first_tier,domestic_league,37,Croatia,KR1,europa,10,https://www.transfermarkt.co.uk/supersport-hnl/startseite/wettbewerb/KR1
+L1,bundesliga,bundesliga,first_tier,domestic_league,40,Germany,L1,europa,18,https://www.transfermarkt.co.uk/bundesliga/startseite/wettbewerb/L1
+MEX1,liga-mx-clausura,liga-mx-clausura,first_tier,domestic_league,110,Mexico,MEX1,amerika,18,https://www.transfermarkt.co.uk/liga-mx-clausura/startseite/wettbewerb/MEX1
+MLS1,major-league-soccer,major-league-soccer,first_tier,domestic_league,184,United States,MLS1,amerika,30,https://www.transfermarkt.co.uk/major-league-soccer/startseite/wettbewerb/MLS1
+NL1,eredivisie,eredivisie,first_tier,domestic_league,122,Netherlands,NL1,europa,18,https://www.transfermarkt.co.uk/eredivisie/startseite/wettbewerb/NL1
+NLP,knvb-beker,knvb-beker,domestic_cup,domestic_cup,122,Netherlands,NL1,europa,18,https://www.transfermarkt.co.uk/knvb-beker/startseite/wettbewerb/NLP
+NLSC,johan-cruijff-schaal,johan-cruijff-schaal,domestic_super_cup,other,122,Netherlands,NL1,europa,18,https://www.transfermarkt.co.uk/johan-cruijff-schaal/startseite/wettbewerb/NLSC
+NO1,eliteserien,eliteserien,first_tier,domestic_league,125,Norway,NO1,europa,16,https://www.transfermarkt.co.uk/eliteserien/startseite/wettbewerb/NO1
+PL1,pko-bp-ekstraklasa,pko-bp-ekstraklasa,first_tier,domestic_league,135,Poland,PL1,europa,18,https://www.transfermarkt.co.uk/pko-bp-ekstraklasa/startseite/wettbewerb/PL1
+PO1,liga-portugal,liga-portugal,first_tier,domestic_league,136,Portugal,PO1,europa,18,https://www.transfermarkt.co.uk/liga-portugal/startseite/wettbewerb/PO1
+POCP,allianz-cup,allianz-cup,domestic_cup,domestic_cup,136,Portugal,PO1,europa,,https://www.transfermarkt.co.uk/allianz-cup/startseite/wettbewerb/POCP
+POSU,supertaca-candido-de-oliveira,supertaca-candido-de-oliveira,domestic_super_cup,other,136,Portugal,PO1,europa,18,https://www.transfermarkt.co.uk/supertaca-candido-de-oliveira/startseite/wettbewerb/POSU
+RO1,superliga,superliga,first_tier,domestic_league,140,Romania,RO1,europa,16,https://www.transfermarkt.co.uk/superliga/startseite/wettbewerb/RO1
+RSK1,k-league-1,k-league-1,first_tier,domestic_league,87,"Korea, South",RSK1,asien,12,https://www.transfermarkt.co.uk/k-league-1/startseite/wettbewerb/RSK1
+RU1,premier-liga,premier-liga,first_tier,domestic_league,141,Russia,RU1,europa,16,https://www.transfermarkt.co.uk/premier-liga/startseite/wettbewerb/RU1
+RUP,russian-cup,russian-cup,domestic_cup,domestic_cup,141,Russia,RU1,europa,16,https://www.transfermarkt.co.uk/russian-cup/startseite/wettbewerb/RUP
+RUSS,russian-super-cup,russian-super-cup,domestic_super_cup,other,141,Russia,RU1,europa,16,https://www.transfermarkt.co.uk/russian-super-cup/startseite/wettbewerb/RUSS
+SA1,saudi-pro-league,saudi-pro-league,first_tier,domestic_league,146,Saudi Arabia,SA1,asien,18,https://www.transfermarkt.co.uk/saudi-pro-league/startseite/wettbewerb/SA1
+SC1,scottish-premiership,scottish-premiership,first_tier,domestic_league,190,Scotland,SC1,europa,12,https://www.transfermarkt.co.uk/scottish-premiership/startseite/wettbewerb/SC1
+SCI,supercoppa-italiana,supercoppa-italiana,domestic_super_cup,other,75,Italy,IT1,europa,20,https://www.transfermarkt.co.uk/supercoppa-italiana/startseite/wettbewerb/SCI
+SE1,allsvenskan,allsvenskan,first_tier,domestic_league,147,Sweden,SE1,europa,16,https://www.transfermarkt.co.uk/allsvenskan/startseite/wettbewerb/SE1
+SER1,super-liga-srbije,super-liga-srbije,first_tier,domestic_league,215,Serbia,SER1,europa,16,https://www.transfermarkt.co.uk/super-liga-srbije/startseite/wettbewerb/SER1
+SFA,scottish-fa-cup,scottish-fa-cup,domestic_cup,domestic_cup,190,Scotland,SC1,europa,12,https://www.transfermarkt.co.uk/scottish-fa-cup/startseite/wettbewerb/SFA
+SUC,supercopa,supercopa,domestic_super_cup,other,157,Spain,ES1,europa,20,https://www.transfermarkt.co.uk/supercopa/startseite/wettbewerb/SUC
+TR1,super-lig,super-lig,first_tier,domestic_league,174,Türkiye,TR1,europa,18,https://www.transfermarkt.co.uk/super-lig/startseite/wettbewerb/TR1
+TS1,chance-liga,chance-liga,first_tier,domestic_league,172,Czech Republic,TS1,europa,16,https://www.transfermarkt.co.uk/chance-liga/startseite/wettbewerb/TS1
+UCOL,uefa-conference-league,uefa-conference-league,uefa_conference_league,other,-1,,,europa,,https://www.transfermarkt.co.uk/uefa-conference-league/startseite/pokalwettbewerb/UCOL
+UKR1,premier-liga,premier-liga,first_tier,domestic_league,177,Ukraine,UKR1,europa,16,https://www.transfermarkt.co.uk/premier-liga/startseite/wettbewerb/UKR1
+UKRP,ukrainian-cup,ukrainian-cup,domestic_cup,domestic_cup,177,Ukraine,UKR1,europa,16,https://www.transfermarkt.co.uk/ukrainian-cup/startseite/wettbewerb/UKRP
+UKRS,ukrainian-super-cup,ukrainian-super-cup,domestic_super_cup,other,177,Ukraine,UKR1,europa,,https://www.transfermarkt.co.uk/ukrainian-super-cup/startseite/wettbewerb/UKRS
+USC,uefa-super-cup,uefa-super-cup,uefa_super_cup,international_cup,-1,,,europa,,https://www.transfermarkt.co.uk/uefa-super-cup/startseite/pokalwettbewerb/USC

data/raw/transfermarkt/countries.csv

@@ -0,0 +1,119 @@
+country_id,country_name,country_code,confederation,total_clubs,total_players,average_age,url
+10,Armenia,ARM1,europa,10,265,24.8,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/10
+100,North Macedonia,MAZ1,europa,12,283,25.4,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/100
+103,Malaysia,MYS1,asien,13,399,28.3,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/103
+106,Malta,MT1N,europa,12,299,26.9,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/106
+107,Morocco,MAR1,afrika,16,499,27.2,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/107
+11,Ethiopia,ETP1,afrika,20,652,25.4,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/11
+110,Mexico,MEX1,amerika,18,482,26.9,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/110
+112,Moldova,MO1N,europa,8,215,23.4,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/112
+116,Myanmar,MYA1,asien,12,383,26.8,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/116
+12,Australia,AUS1,asien,12,377,24.8,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/12
+120,New Zealand,NNL1,asien,12,318,23.9,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/120
+121,Nicaragua,CNIC,amerika,34,467,27.5,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/121
+122,Netherlands,NL1,europa,18,497,25.2,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/122
+124,Nigeria,NPFL,afrika,20,920,25.2,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/124
+125,Norway,NO1,europa,16,418,24.9,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/125
+126,Oman,OM1L,asien,14,511,27.8,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/126
+127,Austria,A1,europa,12,343,24.9,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/127
+13,Azerbaijan,AZ1,europa,12,306,27.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/13
+130,Panama,PN1C,amerika,12,288,25.6,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/130
+132,Paraguay,PR1A,amerika,12,376,27.1,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/132
+133,Peru,TDeA,amerika,18,527,27.2,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/133
+134,Philippines,PFL1,asien,11,341,26.8,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/134
+135,Poland,PL1,europa,18,515,25.9,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/135
+136,Portugal,PO1,europa,18,486,25.6,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/136
+137,Qatar,QSL,asien,12,353,28.1,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/137
+140,Romania,RO1,europa,16,476,26.6,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/140
+141,Russia,RU1,europa,16,450,25.9,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/141
+144,San Marino,SMR1,europa,16,387,26.2,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/144
+146,Saudi Arabia,SA1,asien,18,503,27.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/146
+147,Sweden,SE1,europa,16,436,24.7,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/147
+148,Switzerland,C1,europa,12,338,25.1,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/148
+149,Senegal,SEN1,afrika,16,554,22.8,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/149
+153,Singapore,SIN1,asien,8,196,26.4,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/153
+154,Slovakia,SLO1,europa,12,336,25.6,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/154
+155,Slovenia,SL1,europa,10,243,24.7,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/155
+157,Spain,ES1,europa,20,518,27.3,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/157
+159,South Africa,SFA1,afrika,16,573,27.6,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/159
+16,Bangladesh,BGD1,asien,10,338,25.9,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/16
+164,Chinese Taipei,TFPL,asien,8,230,25.5,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/164
+165,Tajikistan,TAD1,asien,12,284,25.3,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/165
+167,Thailand,THA1,asien,16,489,28.2,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/167
+172,Czech Republic,TS1,europa,16,471,25.8,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/172
+173,Tunisia,TUN1,afrika,16,564,24.9,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/173
+174,Türkiye,TR1,europa,18,512,26.5,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/174
+176,Uganda,UGL1,afrika,16,501,26.8,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/176
+177,Ukraine,UKR1,europa,16,438,25.3,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/177
+178,Hungary,UNG1,europa,12,359,26.1,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/178
+179,Uruguay,URU1,amerika,16,475,25.6,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/179
+18,Belarus,WER1,europa,16,405,25.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/18
+180,Uzbekistan,UZ1,asien,16,425,26.2,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/180
+182,Venezuela,VZ1A,amerika,14,424,25.9,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/182
+183,United Arab Emirates,UAE1,asien,14,425,26.7,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/183
+184,United States,MLS1,amerika,30,851,25.5,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/184
+185,Vietnam,VIE1,asien,14,449,26.6,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/185
+188,Cyprus,ZYP1,europa,14,407,26.9,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/188
+189,England,GB1,europa,20,527,26.4,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/189
+19,Belgium,BE1,europa,16,452,24.5,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/19
+190,Scotland,SC1,europa,12,326,26.7,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/190
+191,Wales,WAL2,europa,16,404,25.9,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/191
+192,Northern Ireland,NIR1,europa,12,311,26.2,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/192
+2,Egypt,EGY1,afrika,21,707,27.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/2
+208,Faroe Islands,FAR2,europa,10,287,25.1,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/208
+215,Serbia,SER1,europa,16,476,25.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/215
+216,Montenegro,MNE1,europa,10,247,26.3,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/216
+218,Hongkong,HGKG,asien,10,320,25.7,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/218
+228,Puerto Rico,PRA1,amerika,10,363,23.7,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/228
+23,Bolivia,BO1A,amerika,16,485,26.9,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/23
+24,Bosnia-Herzegovina,BOS1,europa,10,294,26.2,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/24
+244,Kosovo,KO1,europa,10,275,26.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/244
+26,Brazil,BRA1,amerika,20,668,27.1,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/26
+266,Gibraltar,GI1,europa,12,331,26.5,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/266
+28,Bulgaria,BU1,europa,16,403,26.1,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/28
+3,Albania,ALB1,europa,10,275,25.5,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/3
+33,Chile,CLPD,amerika,16,417,27.1,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/33
+34,China,CSL,asien,16,511,26.7,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/34
+35,Comoros,COM1,afrika,30,873,26.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/35
+36,Costa Rica,CRPD,amerika,10,271,27.6,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/36
+37,Croatia,KR1,europa,10,297,25.5,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/37
+39,Denmark,DK1,europa,12,321,25.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/39
+4,Algeria,ALG1,afrika,16,420,26.4,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/4
+40,Germany,L1,europa,18,517,25.8,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/40
+43,Dominican Republic,DO1P,amerika,6,139,26.5,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/43
+44,Ecuador,EC1N,amerika,16,441,27.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/44
+45,El Salvador,SL1A,amerika,12,319,27.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/45
+47,Estonia,EST2,europa,10,255,21.5,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/47
+48,Fiji,FIJ1,asien,10,384,26.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/48
+49,Finland,FI1,europa,12,299,23.8,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/49
+5,Andorra,AND2,europa,8,280,28.1,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/5
+50,France,FR1,europa,18,478,25.6,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/50
+53,Georgia,GE1N,europa,10,250,24.8,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/53
+54,Ghana,GHPL,afrika,18,604,24.3,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/54
+56,Greece,GR1,europa,14,436,27.1,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/56
+58,Guatemala,GU1A,amerika,12,322,28.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/58
+66,Honduras,HO1A,amerika,11,326,27.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/66
+67,India,IND1,asien,14,395,26.2,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/67
+68,Indonesia,IN1L,asien,18,581,27.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/68
+70,Iraq,IRQ1,asien,20,598,28.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/70
+71,Iran,IRN1,asien,16,491,26.5,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/71
+72,Ireland,IR1,europa,10,309,24.3,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/72
+73,Iceland,IS1,europa,12,297,25.3,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/73
+74,Israel,ISR1,europa,14,380,26.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/74
+75,Italy,IT1,europa,20,534,26.6,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/75
+76,Jamaica,JPL1,amerika,14,569,24.4,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/76
+77,Japan,JAP1,asien,20,694,26.8,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/77
+78,Jordan,JO1L,asien,10,299,26.2,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/78
+79,Cambodia,KHM1,asien,11,327,25.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/79
+80,Canada,CDN1,amerika,8,172,25.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/80
+81,Kazakhstan,KAS1,europa,16,397,26.5,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/81
+83,Colombia,COLP,amerika,20,529,27.6,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/83
+87,"Korea, South",RSK1,asien,12,425,26.2,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/87
+9,Argentina,ARG1,amerika,30,914,26.8,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/9
+90,Kyrgyzstan,KG1L,asien,16,423,25.1,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/90
+91,Laos,LAO1,asien,10,281,23.7,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/91
+92,Latvia,LET1,europa,10,268,23.3,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/92
+94,Lebanon,LIB1,asien,12,327,26.0,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/94
+96,Libya,LPL,afrika,36,1,27.1,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/96
+98,Lithuania,LI1,europa,10,254,25.2,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/98
+99,Luxembourg,LUX1,europa,16,439,25.6,https://www.transfermarkt.co.uk/wettbewerbe/national/wettbewerbe/99

data/raw/transfermarkt/game_events.csv

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a902f2873292ed9fa08dc2fc098c1b051bfb72e6b10299759df483aa1c15e9b8
+size 152909307

data/raw/transfermarkt/game_lineups.csv

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:23bd337a6304ca928e0be22d4d6548c56e21d8238b1b0b55191b590f4ceab794
+size 337998937

data/raw/transfermarkt/games.csv

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4c5768585014e4df838bdd8ba67db12204d31dc5958ccf27e90f190ed9955e8f
+size 25699223

data/raw/transfermarkt/national_teams.csv

@@ -0,0 +1,119 @@
+national_team_id,name,team_code,country_id,country_name,country_code,confederation,team_image_url,squad_size,average_age,foreigners_number,foreigners_percentage,total_market_value,coach_name,fifa_ranking,last_season,url
+10521,San Marino,san-marino,144,San Marino,SMR1,UEFA,https://tmssl.akamaized.net//images/flagge/head/144.png?lm=1520611569,24,24.6,19,79.2,935000,,210,2025,https://www.transfermarkt.co.uk/san-marino/startseite/verein/10521
+10533,Andorra,andorra,5,Andorra,AND2,UEFA,https://tmssl.akamaized.net//images/flagge/head/5.png?lm=1520611569,28,28.4,16,57.1,3520000,,172,2025,https://www.transfermarkt.co.uk/andorra/startseite/verein/10533
+11953,Montenegro,montenegro,216,Montenegro,MNE1,UEFA,https://tmssl.akamaized.net//images/flagge/head/216.png?lm=1520611569,24,26.4,23,95.8,58130001,,82,2025,https://www.transfermarkt.co.uk/montenegro/startseite/verein/11953
+13342,Guatemala,guatemala,58,Guatemala,GU1A,CONCACAF,https://tmssl.akamaized.net//images/flagge/head/58.png?lm=1520611569,21,25.1,6,28.6,5380000,,94,2025,https://www.transfermarkt.co.uk/guatemala/startseite/verein/13342
+13497,Uganda,uganda,176,Uganda,UGL1,CAF,https://tmssl.akamaized.net//images/flagge/head/176.png?lm=1520611569,28,27.9,23,82.1,8630000,,88,2025,https://www.transfermarkt.co.uk/uganda/startseite/verein/13497
+13941,Ethiopia,ethiopia,11,Ethiopia,ETP1,CAF,https://tmssl.akamaized.net//images/flagge/head/11.png?lm=1520611569,23,27.4,2,8.7,2780000,,147,2025,https://www.transfermarkt.co.uk/ethiopia/startseite/verein/13941
+13951,El Salvador,el-salvador,45,El Salvador,SL1A,CONCACAF,https://tmssl.akamaized.net//images/flagge/head/45.png?lm=1520611569,22,25.4,8,36.4,8950000,,99,2025,https://www.transfermarkt.co.uk/el-salvador/startseite/verein/13951
+13955,Fiji,fiji,48,Fiji,FIJ1,OFC,https://tmssl.akamaized.net//images/flagge/head/48.png?lm=1520611569,26,28.1,4,15.4,2450000,,155,2025,https://www.transfermarkt.co.uk/fiji/startseite/verein/13955
+13957,India,india,67,India,IND1,AFC,https://tmssl.akamaized.net//images/flagge/head/67.png?lm=1520611569,23,25.9,0,,4280000,,141,2025,https://www.transfermarkt.co.uk/india/startseite/verein/13957
+13958,Indonesia,indonesia,68,Indonesia,IN1L,AFC,https://tmssl.akamaized.net//images/flagge/head/68.png?lm=1520611569,41,25.8,17,41.5,37799999,,122,2025,https://www.transfermarkt.co.uk/indonesia/startseite/verein/13958
+13975,Tajikistan,tajikistan,165,Tajikistan,TAD1,AFC,https://tmssl.akamaized.net//images/flagge/head/165.png?lm=1520611569,24,26.1,10,41.7,7780000,,100,2025,https://www.transfermarkt.co.uk/tajikistan/startseite/verein/13975
+14162,Qatar,qatar,137,Qatar,QSL,AFC,https://tmssl.akamaized.net//images/flagge/head/137.png?lm=1520611569,23,28.0,1,4.3,18000000,,56,2025,https://www.transfermarkt.co.uk/qatar/startseite/verein/14162
+14165,Oman,oman,126,Oman,OM1L,AFC,https://tmssl.akamaized.net//images/flagge/head/126.png?lm=1520611569,22,28.4,3,13.6,6100000,,78,2025,https://www.transfermarkt.co.uk/oman/startseite/verein/14165
+15033,Bangladesh,bangladesh,16,Bangladesh,BGD1,AFC,https://tmssl.akamaized.net//images/flagge/head/16.png?lm=1520611569,29,25.7,5,17.2,8510000,,180,2025,https://www.transfermarkt.co.uk/bangladesh/startseite/verein/15033
+15232,Dominican Republic,dominican-republic,43,Dominican Republic,DO1P,CONCACAF,https://tmssl.akamaized.net//images/flagge/head/43.png?lm=1520611569,23,24.6,20,87.0,18850000,,142,2025,https://www.transfermarkt.co.uk/dominican-republic/startseite/verein/15232
+15234,Philippines,philippines,134,Philippines,PFL1,AFC,https://tmssl.akamaized.net//images/flagge/head/134.png?lm=1520611569,23,27.7,21,91.3,6180000,,136,2025,https://www.transfermarkt.co.uk/philippines/startseite/verein/15234
+15351,Nicaragua,nicaragua,121,Nicaragua,CNIC,CONCACAF,https://tmssl.akamaized.net//images/flagge/head/121.png?lm=1520611569,25,28.6,8,32.0,3100000,,131,2025,https://www.transfermarkt.co.uk/nicaragua/startseite/verein/15351
+15357,Singapore,singapore,153,Singapore,SIN1,AFC,https://tmssl.akamaized.net//images/flagge/head/153.png?lm=1520611569,26,28.0,8,30.8,3880000,,148,2025,https://www.transfermarkt.co.uk/singapore/startseite/verein/15357
+15363,Chinese Taipei,chinese-taipei,164,Chinese Taipei,TFPL,AFC,https://tmssl.akamaized.net//images/flagge/head/164.png?lm=1679300082,28,26.6,9,32.1,2220000,,174,2025,https://www.transfermarkt.co.uk/chinese-taipei/startseite/verein/15363
+15737,Jordan,jordan,78,Jordan,JO1L,AFC,https://tmssl.akamaized.net//images/flagge/head/78.png?lm=1520611569,23,28.7,10,43.5,9350000,,64,2025,https://www.transfermarkt.co.uk/jordan/startseite/verein/15737
+15738,Malaysia,malaysia,103,Malaysia,MYS1,AFC,https://tmssl.akamaized.net//images/flagge/head/103.png?lm=1520611569,28,28.4,4,14.3,7150000,,121,2025,https://www.transfermarkt.co.uk/malaysia/startseite/verein/15738
+15977,Hong Kong,hong-kong,218,Hongkong,HGKG,AFC,https://tmssl.akamaized.net//images/flagge/head/218.png?lm=1520611569,23,28.3,10,43.5,3880000,,153,2025,https://www.transfermarkt.co.uk/hong-kong/startseite/verein/15977
+16038,Cambodia,cambodia,79,Cambodia,KHM1,AFC,https://tmssl.akamaized.net//images/flagge/head/79.png?lm=1520611569,23,25.5,1,4.3,2380000,,179,2025,https://www.transfermarkt.co.uk/cambodia/startseite/verein/16038
+16423,Myanmar,myanmar,116,Myanmar,MYA1,AFC,https://tmssl.akamaized.net//images/flagge/head/116.png?lm=1520611569,23,26.9,7,30.4,3150000,,163,2025,https://www.transfermarkt.co.uk/myanmar/startseite/verein/16423
+16430,Comoros,comoros,35,Comoros,COM1,CAF,https://tmssl.akamaized.net//images/flagge/head/35.png?lm=1520611569,25,26.9,25,100.0,20200001,,106,2025,https://www.transfermarkt.co.uk/comoros/startseite/verein/16430
+16431,Laos,laos,91,Laos,LAO1,,https://tmssl.akamaized.net//images/flagge/head/91.png?lm=1520611569,24,22.7,4,16.7,1560000,,190,2025,https://www.transfermarkt.co.uk/laos/startseite/verein/16431
+17759,Puerto Rico,puerto-rico,228,Puerto Rico,PRA1,CONCACAF,https://tmssl.akamaized.net//images/flagge/head/228.png?lm=1520611569,23,23.1,20,87.0,1200000,,156,2025,https://www.transfermarkt.co.uk/puerto-rico/startseite/verein/17759
+3262,Germany,germany,40,Germany,L1,UEFA,https://tmssl.akamaized.net//images/flagge/head/40.png?lm=1520612525,26,27.4,9,34.6,849500000,,10,2025,https://www.transfermarkt.co.uk/germany/startseite/verein/3262
+3299,England,england,189,England,GB1,UEFA,https://tmssl.akamaized.net//images/flagge/head/189.png?lm=1520611569,25,26.9,4,16.0,,,4,2025,https://www.transfermarkt.co.uk/england/startseite/verein/3299
+3300,Portugal,portugal,136,Portugal,PO1,UEFA,https://tmssl.akamaized.net//images/flagge/head/136.png?lm=1520611569,23,27.3,17,73.9,838500000,,6,2025,https://www.transfermarkt.co.uk/portugal/startseite/verein/3300
+3375,Spain,spain,157,Spain,ES1,UEFA,https://tmssl.akamaized.net//images/flagge/head/157.png?lm=1520611569,27,27.4,10,37.0,,,1,2025,https://www.transfermarkt.co.uk/spain/startseite/verein/3375
+3376,Italy,italy,75,Italy,IT1,UEFA,https://tmssl.akamaized.net//images/flagge/head/75.png?lm=1520611569,26,27.4,5,19.2,825000000,,13,2025,https://www.transfermarkt.co.uk/italy/startseite/verein/3376
+3377,France,france,50,France,FR1,UEFA,https://tmssl.akamaized.net//images/flagge/head/50.png?lm=1520611569,26,26.7,20,76.9,,,3,2025,https://www.transfermarkt.co.uk/france/startseite/verein/3377
+3378,Greece,greece,56,Greece,GR1,UEFA,https://tmssl.akamaized.net//images/flagge/head/56.png?lm=1520611569,25,26.2,15,60.0,282899994,,46,2025,https://www.transfermarkt.co.uk/greece/startseite/verein/3378
+3379,Netherlands,netherlands,122,Netherlands,NL1,UEFA,https://tmssl.akamaized.net//images/flagge/head/122.png?lm=1520611569,22,26.8,20,90.9,797000000,,7,2025,https://www.transfermarkt.co.uk/netherlands/startseite/verein/3379
+3380,Scotland,scotland,190,Scotland,SC1,UEFA,https://tmssl.akamaized.net//images/flagge/head/190.png?lm=1520611569,26,28.8,17,65.4,211000000,,38,2025,https://www.transfermarkt.co.uk/scotland/startseite/verein/3380
+3381,Turkiye,turkiye,174,Türkiye,TR1,UEFA,https://tmssl.akamaized.net//images/flagge/head/174.png?lm=1520611569,33,27.1,13,39.4,512700012,,25,2025,https://www.transfermarkt.co.uk/turkiye/startseite/verein/3381
+3382,Belgium,belgium,19,Belgium,BE1,UEFA,https://tmssl.akamaized.net//images/flagge/head/19.png?lm=1520611569,24,27.3,20,83.3,450200012,,9,2025,https://www.transfermarkt.co.uk/belgium/startseite/verein/3382
+3383,Austria,austria,127,Austria,A1,UEFA,https://tmssl.akamaized.net//images/flagge/head/127.png?lm=1520611569,28,28.2,25,89.3,254600006,,24,2025,https://www.transfermarkt.co.uk/austria/startseite/verein/3383
+3384,Switzerland,switzerland,148,Switzerland,C1,UEFA,https://tmssl.akamaized.net//images/flagge/head/148.png?lm=1520611569,26,27.9,23,88.5,308100006,,18,2025,https://www.transfermarkt.co.uk/switzerland/startseite/verein/3384
+3394,Bulgaria,bulgaria,28,Bulgaria,BU1,UEFA,https://tmssl.akamaized.net//images/flagge/head/28.png?lm=1520611569,26,25.4,16,61.5,44099998,,87,2025,https://www.transfermarkt.co.uk/bulgaria/startseite/verein/3394
+3433,Australia,australia,12,Australia,AUS1,AFC,https://tmssl.akamaized.net//images/flagge/head/12.png?lm=1520611569,25,27.1,21,84.0,46029999,,27,2025,https://www.transfermarkt.co.uk/australia/startseite/verein/3433
+3435,Japan,japan,77,Japan,JAP1,AFC,https://tmssl.akamaized.net//images/flagge/head/77.png?lm=1520611569,28,26.4,25,89.3,265500000,,19,2025,https://www.transfermarkt.co.uk/japan/startseite/verein/3435
+3436,Denmark,denmark,39,Denmark,DK1,UEFA,https://tmssl.akamaized.net//images/flagge/head/39.png?lm=1520611569,25,26.3,23,92.0,352000000,,21,2025,https://www.transfermarkt.co.uk/denmark/startseite/verein/3436
+3437,Argentina,argentina,9,Argentina,ARG1,CONMEBOL,https://tmssl.akamaized.net//images/flagge/head/9.png?lm=1520611569,28,28.4,23,82.1,712200012,,2,2025,https://www.transfermarkt.co.uk/argentina/startseite/verein/3437
+3438,Serbia,serbia,215,Serbia,SER1,UEFA,https://tmssl.akamaized.net//images/flagge/head/215.png?lm=1520611569,28,26.8,22,78.6,276299988,,39,2025,https://www.transfermarkt.co.uk/serbia/startseite/verein/3438
+3439,Brazil,brazil,26,Brazil,BRA1,CONMEBOL,https://tmssl.akamaized.net//images/flagge/head/26.png?lm=1520611569,26,27.9,22,84.6,924000000,,5,2025,https://www.transfermarkt.co.uk/brazil/startseite/verein/3439
+3440,Norway,norway,125,Norway,NO1,UEFA,https://tmssl.akamaized.net//images/flagge/head/125.png?lm=1520611569,28,26.2,24,85.7,522900024,,32,2025,https://www.transfermarkt.co.uk/norway/startseite/verein/3440
+3441,Ghana,ghana,54,Ghana,GHPL,CAF,https://tmssl.akamaized.net//images/flagge/head/54.png?lm=1520611569,26,26.9,25,96.2,211779999,,72,2025,https://www.transfermarkt.co.uk/ghana/startseite/verein/3441
+3442,Poland,poland,135,Poland,PL1,UEFA,https://tmssl.akamaized.net//images/flagge/head/135.png?lm=1520611569,25,27.9,18,72.0,163350006,,34,2025,https://www.transfermarkt.co.uk/poland/startseite/verein/3442
+3443,Finland,finland,49,Finland,FI1,UEFA,https://tmssl.akamaized.net//images/flagge/head/49.png?lm=1520611569,24,26.0,24,100.0,51500000,,75,2025,https://www.transfermarkt.co.uk/finland/startseite/verein/3443
+3444,Nigeria,nigeria,124,Nigeria,NPFL,CAF,https://tmssl.akamaized.net//images/flagge/head/124.png?lm=1520611569,23,27.6,23,100.0,229580002,,26,2025,https://www.transfermarkt.co.uk/nigeria/startseite/verein/3444
+3445,Czech Republic,czech-republic,172,Czech Republic,TS1,UEFA,https://tmssl.akamaized.net//images/flagge/head/172.png?lm=1520611569,25,28.0,11,44.0,171500000,,43,2025,https://www.transfermarkt.co.uk/czech-republic/startseite/verein/3445
+3446,Bosnia-Herzegovina,bosnia-herzegovina,24,Bosnia-Herzegovina,BOS1,UEFA,https://tmssl.akamaized.net//images/flagge/head/24.png?lm=1569523290,25,26.9,25,100.0,117800003,,71,2025,https://www.transfermarkt.co.uk/bosnia-herzegovina/startseite/verein/3446
+3447,Romania,romania,140,Romania,RO1,UEFA,https://tmssl.akamaized.net//images/flagge/head/140.png?lm=1520611569,28,27.5,16,57.1,120099998,,49,2025,https://www.transfermarkt.co.uk/romania/startseite/verein/3447
+3448,Russia,russia,141,Russia,RU1,UEFA,https://tmssl.akamaized.net//images/flagge/head/141.png?lm=1520611569,40,26.0,4,10.0,270750000,,36,2025,https://www.transfermarkt.co.uk/russia/startseite/verein/3448
+3449,Uruguay,uruguay,179,Uruguay,URU1,CONMEBOL,https://tmssl.akamaized.net//images/flagge/head/179.png?lm=1520611569,36,26.2,32,88.9,407329987,,17,2025,https://www.transfermarkt.co.uk/uruguay/startseite/verein/3449
+3450,Belarus,belarus,18,Belarus,WER1,UEFA,https://tmssl.akamaized.net//images/flagge/head/18.png?lm=1520611569,24,26.3,12,50.0,15100000,,98,2025,https://www.transfermarkt.co.uk/belarus/startseite/verein/3450
+3468,Hungary,hungary,178,Hungary,UNG1,UEFA,https://tmssl.akamaized.net//images/flagge/head/178.png?lm=1521635893,24,26.6,17,70.8,204000000,,41,2025,https://www.transfermarkt.co.uk/hungary/startseite/verein/3468
+3499,Senegal,senegal,149,Senegal,SEN1,CAF,https://tmssl.akamaized.net//images/flagge/head/149.png?lm=1520611569,31,26.9,31,100.0,476700012,,12,2025,https://www.transfermarkt.co.uk/senegal/startseite/verein/3499
+3503,Slovakia,slovakia,154,Slovakia,SLO1,UEFA,https://tmssl.akamaized.net//images/flagge/head/154.png?lm=1520611569,28,28.7,27,96.4,133850006,,44,2025,https://www.transfermarkt.co.uk/slovakia/startseite/verein/3503
+3504,Venezuela,venezuela,182,Venezuela,VZ1A,CONMEBOL,https://tmssl.akamaized.net//images/flagge/head/182.png?lm=1520611569,36,25.2,31,86.1,71750000,,50,2025,https://www.transfermarkt.co.uk/venezuela/startseite/verein/3504
+3505,United States,united-states,184,United States,MLS1,CONCACAF,https://tmssl.akamaized.net//images/flagge/head/184.png?lm=1520611569,27,26.3,19,70.4,358700012,,15,2025,https://www.transfermarkt.co.uk/united-states/startseite/verein/3505
+3509,Republic of Ireland,republic-of-ireland,72,Ireland,IR1,UEFA,https://tmssl.akamaized.net//images/flagge/head/72.png?lm=1520611569,25,27.2,25,100.0,184149994,,59,2025,https://www.transfermarkt.co.uk/republic-of-ireland/startseite/verein/3509
+3510,Canada,canada,80,Canada,CDN1,CONCACAF,https://tmssl.akamaized.net//images/flagge/head/80.png?lm=1520611569,26,26.4,23,88.5,121080002,,29,2025,https://www.transfermarkt.co.uk/canada/startseite/verein/3510
+3555,Latvia,latvia,92,Latvia,LET1,UEFA,https://tmssl.akamaized.net//images/flagge/head/92.png?lm=1520611569,27,26.7,13,48.1,17950001,,139,2025,https://www.transfermarkt.co.uk/latvia/startseite/verein/3555
+3556,Croatia,croatia,37,Croatia,KR1,UEFA,https://tmssl.akamaized.net//images/flagge/head/37.png?lm=1520611569,26,28.2,24,92.3,255300003,,11,2025,https://www.transfermarkt.co.uk/croatia/startseite/verein/3556
+3557,Sweden,sweden,147,Sweden,SE1,UEFA,https://tmssl.akamaized.net//images/flagge/head/147.png?lm=1520611569,26,26.3,22,84.6,377779999,,42,2025,https://www.transfermarkt.co.uk/sweden/startseite/verein/3557
+3560,Iraq,iraq,70,Iraq,IRQ1,AFC,https://tmssl.akamaized.net//images/flagge/head/70.png?lm=1520611569,28,26.4,15,53.6,18830000,,58,2025,https://www.transfermarkt.co.uk/iraq/startseite/verein/3560
+3561,Albania,albania,3,Albania,ALB1,UEFA,https://tmssl.akamaized.net//images/flagge/head/3.png?lm=1520611569,25,28.2,23,92.0,86349998,,63,2025,https://www.transfermarkt.co.uk/albania/startseite/verein/3561
+3563,Uzbekistan,uzbekistan,180,Uzbekistan,UZ1,AFC,https://tmssl.akamaized.net//images/flagge/head/180.png?lm=1520611569,14,26.3,1,7.1,8500000,,52,2025,https://www.transfermarkt.co.uk/uzbekistan/startseite/verein/3563
+3574,Iceland,iceland,73,Iceland,IS1,UEFA,https://tmssl.akamaized.net//images/flagge/head/73.png?lm=1520611569,22,27.0,21,95.5,79000000,,74,2025,https://www.transfermarkt.co.uk/iceland/startseite/verein/3574
+3575,Morocco,morocco,107,Morocco,MAR1,CAF,https://tmssl.akamaized.net//images/flagge/head/107.png?lm=1520611569,28,25.3,25,89.3,431750000,,8,2025,https://www.transfermarkt.co.uk/morocco/startseite/verein/3575
+3577,Panama,panama,130,Panama,PN1C,CONCACAF,https://tmssl.akamaized.net//images/flagge/head/130.png?lm=1520611569,23,29.5,22,95.7,31200001,,33,2025,https://www.transfermarkt.co.uk/panama/startseite/verein/3577
+3580,Luxembourg,luxembourg,99,Luxembourg,LUX1,UEFA,https://tmssl.akamaized.net//images/flagge/head/99.png?lm=1520611569,24,26.1,24,100.0,33299999,,102,2025,https://www.transfermarkt.co.uk/luxembourg/startseite/verein/3580
+3581,Paraguay,paraguay,132,Paraguay,PR1A,CONMEBOL,https://tmssl.akamaized.net//images/flagge/head/132.png?lm=1520611569,31,28.5,25,80.6,124800003,,40,2025,https://www.transfermarkt.co.uk/paraguay/startseite/verein/3581
+3582,Iran,iran,71,Iran,IRN1,AFC,https://tmssl.akamaized.net//images/flagge/head/71.png?lm=1520611569,28,29.4,7,25.0,34049999,,20,2025,https://www.transfermarkt.co.uk/iran/startseite/verein/3582
+3584,Peru,peru,133,Peru,TDeA,CONMEBOL,https://tmssl.akamaized.net//images/flagge/head/133.png?lm=1520611569,24,26.7,12,50.0,27650000,,53,2025,https://www.transfermarkt.co.uk/peru/startseite/verein/3584
+3586,Lebanon,lebanon,94,Lebanon,LIB1,AFC,https://tmssl.akamaized.net//images/flagge/head/94.png?lm=1520611569,23,28.8,6,26.1,6450000,,109,2025,https://www.transfermarkt.co.uk/lebanon/startseite/verein/3586
+3587,Malta,malta,106,Malta,MT1N,UEFA,https://tmssl.akamaized.net//images/flagge/head/106.png?lm=1520611569,29,27.1,10,34.5,14550000,,161,2025,https://www.transfermarkt.co.uk/malta/startseite/verein/3587
+3588,Slovenia,slovenia,155,Slovenia,SL1,UEFA,https://tmssl.akamaized.net//images/flagge/head/155.png?lm=1520611569,26,26.9,21,80.8,145800003,,57,2025,https://www.transfermarkt.co.uk/slovenia/startseite/verein/3588
+3589,South Korea,south-korea,87,"Korea, South",RSK1,AFC,https://tmssl.akamaized.net//images/flagge/head/87.png?lm=1520611569,26,27.7,20,76.9,125099998,,22,2025,https://www.transfermarkt.co.uk/south-korea/startseite/verein/3589
+3590,Honduras,honduras,66,Honduras,HO1A,CONCACAF,https://tmssl.akamaized.net//images/flagge/head/66.png?lm=1699286249,28,28.2,13,46.4,15650000,,65,2025,https://www.transfermarkt.co.uk/honduras/startseite/verein/3590
+3614,Algeria,algeria,4,Algeria,ALG1,CAF,https://tmssl.akamaized.net//images/flagge/head/4.png?lm=1520611569,27,25.8,25,92.6,236550003,,28,2025,https://www.transfermarkt.co.uk/algeria/startseite/verein/3614
+3668,Cyprus,cyprus,188,Cyprus,ZYP1,UEFA,https://tmssl.akamaized.net//images/flagge/head/188.png?lm=1520611569,26,25.7,7,26.9,19600000,,128,2025,https://www.transfermarkt.co.uk/cyprus/startseite/verein/3668
+3669,Georgia,georgia,53,Georgia,GE1N,UEFA,https://tmssl.akamaized.net//images/flagge/head/53.png?lm=1520611569,24,26.8,22,91.7,194979996,,73,2025,https://www.transfermarkt.co.uk/georgia/startseite/verein/3669
+3670,Tunisia,tunisia,173,Tunisia,TUN1,CAF,https://tmssl.akamaized.net//images/flagge/head/173.png?lm=1520611569,30,25.3,21,70.0,69650002,,47,2025,https://www.transfermarkt.co.uk/tunisia/startseite/verein/3670
+3671,Jamaica,jamaica,76,Jamaica,JPL1,CONCACAF,https://tmssl.akamaized.net//images/flagge/head/76.png?lm=1520611569,28,26.8,26,92.9,48950001,,70,2025,https://www.transfermarkt.co.uk/jamaica/startseite/verein/3671
+3672,Egypt,egypt,2,Egypt,EGY1,CAF,https://tmssl.akamaized.net//images/flagge/head/2.png?lm=1520611569,28,29.1,6,21.4,134250000,,31,2025,https://www.transfermarkt.co.uk/egypt/startseite/verein/3672
+3699,Ukraine,ukraine,177,Ukraine,UKR1,UEFA,https://tmssl.akamaized.net//images/flagge/head/177.png?lm=1520611569,26,26.5,11,42.3,261399994,,30,2025,https://www.transfermarkt.co.uk/ukraine/startseite/verein/3699
+3700,Chile,chile,33,Chile,CLPD,CONMEBOL,https://tmssl.akamaized.net//images/flagge/head/33.png?lm=1520611569,26,25.5,20,76.9,84099998,,55,2025,https://www.transfermarkt.co.uk/chile/startseite/verein/3700
+37574,Gibraltar,gibraltar,266,Gibraltar,GI1,UEFA,https://tmssl.akamaized.net//images/flagge/head/266.png?lm=1520611569,23,23.5,9,39.1,1200000,,202,2025,https://www.transfermarkt.co.uk/gibraltar/startseite/verein/37574
+3806,South Africa,south-africa,159,South Africa,SFA1,CAF,https://tmssl.akamaized.net//images/flagge/head/159.png?lm=1520611569,28,26.5,9,32.1,46349998,,60,2025,https://www.transfermarkt.co.uk/south-africa/startseite/verein/3806
+3807,Saudi Arabia,saudi-arabia,146,Saudi Arabia,SA1,AFC,https://tmssl.akamaized.net//images/flagge/head/146.png?lm=1520611569,25,27.4,1,4.0,29049999,,61,2025,https://www.transfermarkt.co.uk/saudi-arabia/startseite/verein/3807
+3816,Colombia,colombia,83,Colombia,COLP,CONMEBOL,https://tmssl.akamaized.net//images/flagge/head/83.png?lm=1520611569,26,29.6,25,96.2,301000000,,14,2025,https://www.transfermarkt.co.uk/colombia/startseite/verein/3816
+3851,Lithuania,lithuania,98,Lithuania,LI1,UEFA,https://tmssl.akamaized.net//images/flagge/head/98.png?lm=1520611569,25,28.3,16,64.0,18230000,,146,2025,https://www.transfermarkt.co.uk/lithuania/startseite/verein/3851
+3864,Wales,wales,191,Wales,WAL2,UEFA,https://tmssl.akamaized.net//images/flagge/head/191.png?lm=1520611569,26,26.8,18,69.2,211149994,,35,2025,https://www.transfermarkt.co.uk/wales/startseite/verein/3864
+3956,Kyrgyzstan,kyrgyzstan,90,Kyrgyzstan,KG1L,AFC,https://tmssl.akamaized.net//images/flagge/head/90.png?lm=1520611569,22,27.4,3,13.6,5830000,,103,2025,https://www.transfermarkt.co.uk/kyrgyzstan/startseite/verein/3956
+5147,United Arab Emirates,united-arab-emirates,183,United Arab Emirates,UAE1,AFC,https://tmssl.akamaized.net//images/flagge/head/183.png?lm=1520611569,23,27.3,0,,39880001,,68,2025,https://www.transfermarkt.co.uk/united-arab-emirates/startseite/verein/5147
+5148,North Macedonia,north-macedonia,100,North Macedonia,MAZ1,UEFA,https://tmssl.akamaized.net//images/flagge/head/100.png?lm=1520611569,28,28.8,23,82.1,39130001,,66,2025,https://www.transfermarkt.co.uk/north-macedonia/startseite/verein/5148
+5233,Bolivia,bolivia,23,Bolivia,BO1A,CONMEBOL,https://tmssl.akamaized.net//images/flagge/head/23.png?lm=1520611569,32,23.9,16,50.0,18799999,,76,2025,https://www.transfermarkt.co.uk/bolivia/startseite/verein/5233
+53982,Kosovo,kosovo,244,Kosovo,KO1,UEFA,https://tmssl.akamaized.net//images/flagge/head/244.png?lm=1520611569,28,27.4,27,96.4,143179993,,79,2025,https://www.transfermarkt.co.uk/kosovo/startseite/verein/53982
+5547,Israel,israel,74,Israel,ISR1,UEFA,https://tmssl.akamaized.net//images/flagge/head/74.png?lm=1520611569,24,26.4,12,50.0,85900002,,77,2025,https://www.transfermarkt.co.uk/israel/startseite/verein/5547
+5598,China,china,34,China,CSL,AFC,https://tmssl.akamaized.net//images/flagge/head/34.png?lm=1520611569,26,29.4,0,,10930000,,93,2025,https://www.transfermarkt.co.uk/china/startseite/verein/5598
+5674,Northern Ireland,northern-ireland,192,Northern Ireland,NIR1,UEFA,https://tmssl.akamaized.net//images/flagge/head/192.png?lm=1520611569,25,25.7,25,100.0,95680000,,69,2025,https://www.transfermarkt.co.uk/northern-ireland/startseite/verein/5674
+5676,Thailand,thailand,167,Thailand,THA1,AFC,https://tmssl.akamaized.net//images/flagge/head/167.png?lm=1520611569,23,28.8,3,13.0,8150000,,96,2025,https://www.transfermarkt.co.uk/thailand/startseite/verein/5676
+5750,Ecuador,ecuador,44,Ecuador,EC1N,CONMEBOL,https://tmssl.akamaized.net//images/flagge/head/44.png?lm=1520611569,28,25.4,26,92.9,366079987,,23,2025,https://www.transfermarkt.co.uk/ecuador/startseite/verein/5750
+6090,Moldova,moldova,112,Moldova,MO1N,UEFA,https://tmssl.akamaized.net//images/flagge/head/112.png?lm=1520611569,26,26.4,18,69.2,14400000,,158,2025,https://www.transfermarkt.co.uk/moldova/startseite/verein/6090
+6133,Estonia,estonia,47,Estonia,EST2,UEFA,https://tmssl.akamaized.net//images/flagge/head/47.png?lm=1520611569,26,25.9,19,73.1,15680000,,129,2025,https://www.transfermarkt.co.uk/estonia/startseite/verein/6133
+6219,Armenia,armenia,10,Armenia,ARM1,UEFA,https://tmssl.akamaized.net//images/flagge/head/10.png?lm=1520611569,27,24.7,10,37.0,39630001,,105,2025,https://www.transfermarkt.co.uk/armenia/startseite/verein/6219
+6303,Mexico,mexico,110,Mexico,MEX1,CONCACAF,https://tmssl.akamaized.net//images/flagge/head/110.png?lm=1520611569,21,26.1,0,,101800003,,16,2025,https://www.transfermarkt.co.uk/mexico/startseite/verein/6303
+6602,Libya,libya,96,Libya,LPL,CAF,https://tmssl.akamaized.net//images/flagge/head/96.png?lm=1520611569,25,26.8,4,16.0,12550000,,112,2025,https://www.transfermarkt.co.uk/libya/startseite/verein/6602
+8497,Costa Rica,costa-rica,36,Costa Rica,CRPD,CONCACAF,https://tmssl.akamaized.net//images/flagge/head/36.png?lm=1520611569,26,27.9,13,50.0,40130001,,51,2025,https://www.transfermarkt.co.uk/costa-rica/startseite/verein/8497
+8605,Azerbaijan,azerbaijan,13,Azerbaijan,AZ1,UEFA,https://tmssl.akamaized.net//images/flagge/head/13.png?lm=1520611569,25,26.7,6,24.0,20549999,,127,2025,https://www.transfermarkt.co.uk/azerbaijan/startseite/verein/8605
+8778,Vietnam,vietnam,185,Vietnam,VIE1,AFC,https://tmssl.akamaized.net//images/flagge/head/185.png?lm=1520611569,23,27.9,0,,6380000,,108,2025,https://www.transfermarkt.co.uk/vietnam/startseite/verein/8778
+9110,Kazakhstan,kazakhstan,81,Kazakhstan,KAS1,UEFA,https://tmssl.akamaized.net//images/flagge/head/81.png?lm=1520611569,26,26.4,4,15.4,17250000,,114,2025,https://www.transfermarkt.co.uk/kazakhstan/startseite/verein/9110
+9171,New Zealand,new-zealand,120,New Zealand,NNL1,OFC,https://tmssl.akamaized.net//images/flagge/head/120.png?lm=1520611569,23,27.4,15,65.2,21600000,,85,2025,https://www.transfermarkt.co.uk/new-zealand/startseite/verein/9171
+9173,Faroe Islands,faroe-islands,208,Faroe Islands,FAR2,UEFA,https://tmssl.akamaized.net//images/flagge/head/208.png?lm=1520611569,24,28.2,13,54.2,6530000,,125,2025,https://www.transfermarkt.co.uk/faroe-islands/startseite/verein/9173

data/raw/transfermarkt/player_valuations.csv

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d288c65bab9dce490232d83abb5109cb021843cc13e26da00da2fd5f968b4504
+size 30022694

data/raw/transfermarkt/players.csv

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2b51fa9df4c635572eb28e0cec0668e378ba9df2ca39da286291d2ada92bc3fc
+size 16726734

data/raw/transfermarkt/transfers.csv

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f70d0d8b6ddc7a72495db3bd3c15995fce8d7c8fc949ed3261fad58a86f76506
+size 13341210

requirements.txt

@@ -0,0 +1,7 @@
+streamlit==1.32.0
+xgboost==2.0.3
+shap==0.44.0
+pandas==2.2.0
+numpy==1.26.4
+plotly==5.18.0
+scikit-learn==1.4.0

src/data/kaggle_loader.py

@@ -0,0 +1,88 @@
+import kagglehub
+import pandas as pd
+import os
+import shutil
+
+def download_datasets():
+    """
+    Downloads the Transfermarkt dataset and an FBref dataset.
+    """
+    print("Downloading Transfermarkt dataset...")
+    tm_path = kagglehub.dataset_download("davidcariboo/player-scores")
+    print(f"Transfermarkt dataset downloaded locally to {tm_path}")
+    
+    print("Downloading FBref dataset...")
+    try:
+        # Using a popular FBref Kaggle dataset for advanced metrics
+        fb_path = kagglehub.dataset_download("vivovinco/20222023-football-player-stats")
+        print(f"FBref dataset downloaded locally to {fb_path}")
+    except Exception as e:
+        print(f"Warning: Could not download FBref dataset: {e}")
+        fb_path = None
+        
+    return tm_path, fb_path
+
+def load_data(tm_path, fb_path):
+    """
+    Loads necessary csv files into pandas DataFrames.
+    """
+    # Transfermarkt data
+    players_path = os.path.join(tm_path, "players.csv")
+    appearances_path = os.path.join(tm_path, "appearances.csv")
+    player_valuations_path = os.path.join(tm_path, "player_valuations.csv")
+
+    players_df = pd.read_csv(players_path)
+    appearances_df = pd.read_csv(appearances_path)
+    
+    valuations_df = None
+    if os.path.exists(player_valuations_path):
+        valuations_df = pd.read_csv(player_valuations_path)
+    
+    # FBref data
+    fbref_df = None
+    if fb_path and os.path.exists(fb_path):
+        for file in os.listdir(fb_path):
+            if file.endswith('.csv'):
+                # Many FBref datasets use latin1 encoding
+                fbref_df = pd.read_csv(os.path.join(fb_path, file), encoding='latin1', low_memory=False)
+                break
+                
+    return players_df, appearances_df, valuations_df, fbref_df
+
+def get_base_datasets(stage_locally=True):
+    """Downloads and returns all dataframes, optionally staging them locally."""
+    tm_path, fb_path = download_datasets()
+    
+    if stage_locally:
+        print("Staging datasets into local data/raw directory...")
+        # Get absolute path relative to project root
+        project_root = os.path.abspath(os.path.join(os.path.dirname(__file__), '..', '..'))
+        tm_raw_dir = os.path.join(project_root, "data", "raw", "transfermarkt")
+        fb_raw_dir = os.path.join(project_root, "data", "raw", "fbref")
+        
+        os.makedirs(tm_raw_dir, exist_ok=True)
+        os.makedirs(fb_raw_dir, exist_ok=True)
+        
+        for f in os.listdir(tm_path):
+            if f.endswith('.csv'):
+                shutil.copy(os.path.join(tm_path, f), tm_raw_dir)
+                
+        if fb_path and os.path.exists(fb_path):
+            for f in os.listdir(fb_path):
+                if f.endswith('.csv'):
+                    shutil.copy(os.path.join(fb_path, f), fb_raw_dir)
+                    
+        print(f"Data staged successfully into {os.path.join(project_root, 'data', 'raw')}.")
+        
+    return load_data(tm_path, fb_path)
+
+if __name__ == "__main__":
+    players, apps, valuations, fbref = get_base_datasets()
+    
+    print("\n--- Data Loading Summary ---")
+    print(f"Loaded {len(players)} Transfermarkt players.")
+    print(f"Loaded {len(apps)} match appearances.")
+    if valuations is not None:
+        print(f"Loaded {len(valuations)} transfer valuations.")
+    if fbref is not None:
+        print(f"Loaded {len(fbref)} FBref player records with advanced metrics like xG and xA.")

src/data/preprocess.py

@@ -0,0 +1,51 @@
+import pandas as pd
+import numpy as np
+
+# A basic historical inflation index for football transfers 
+# Base Year: 2024 (Index = 1.00)
+# (e.g., fees in 2017 are multiplied by 1.50 to equal 2024 purchasing power)
+INFLATION_RATES = {
+    2015: 2.10,
+    2016: 1.85,
+    2017: 1.50, # Pre-Neymar era adjustment
+    2018: 1.40,
+    2019: 1.35,
+    2020: 1.25, # COVID market impact
+    2021: 1.20,
+    2022: 1.10,
+    2023: 1.05,
+    2024: 1.00
+}
+
+def adjust_for_inflation(df, fee_col='market_value_in_eur', year_col='date'):
+    """
+    Adjusts past transfer fees or market values to 2024 equivalent.
+    Converts EUR to GBP using an approximated flat rate for the MVP.
+    """
+    df = df.copy()
+    
+    # Process dates to extract the year
+    if df[year_col].dtype == 'object':
+        df['Transfer_Year'] = pd.to_datetime(df[year_col]).dt.year
+    else:
+        df['Transfer_Year'] = df[year_col]
+        
+    df['Inflation_Multiplier'] = df['Transfer_Year'].map(INFLATION_RATES).fillna(1.0)
+    
+    # Adjust to 2024 values
+    df['Adjusted_Fee_EUR'] = df[fee_col] * df['Inflation_Multiplier']
+    
+    # Convert EUR to GBP (approx. 0.85 rate)
+    df['Transfer_Fee_2024_GBP'] = df['Adjusted_Fee_EUR'] * 0.85
+    
+    return df
+
+def clean_data(df):
+    """
+    Handles missing values and basic cleanup.
+    """
+    # Future specific cleaning logic goes here
+    # Example: Impute missing minutes played with 0
+    if 'minutes_played' in df.columns:
+        df['minutes_played'] = df['minutes_played'].fillna(0)
+    return df

src/features/build_features.py

@@ -0,0 +1,76 @@
+import pandas as pd
+import numpy as np
+
+# Mock UEFA Coefficients for League Strength Indexing
+# In a full production environment, this would be dynamically loaded
+LEAGUE_COEFFICIENTS = {
+    'Premier League': 1.0,
+    'LaLiga': 0.90,
+    'Serie A': 0.85,
+    'Bundesliga': 0.82,
+    'Ligue 1': 0.75,
+    'Eredivisie': 0.60,
+    'Liga Portugal': 0.55
+}
+
+def calculate_risk_score(df, contract_col='Contract_Years_Left', age_col='Age', injury_col='Injury_Days_Total_24m'):
+    """
+    Computes binary risk flags based on the project blueprint for "The Busquets Factor".
+    """
+    df = df.copy()
+    
+    # 1. Contract Risk: Entering final 12-18 months
+    if contract_col in df.columns:
+        df['Risk_Contract'] = np.where(df[contract_col] < 1.5, 1, 0)
+    else:
+        df['Risk_Contract'] = 0
+        
+    # 2. Age Risk: Over 30 years old
+    if age_col in df.columns:
+        df['Risk_Age'] = np.where(df[age_col] > 30, 1, 0)
+    else:
+        df['Risk_Age'] = 0
+        
+    # 3. Injury Risk: Missed significant time (e.g., > 60 days)
+    if injury_col in df.columns:
+        df['Risk_Injury'] = np.where(df[injury_col] > 60, 1, 0)
+    else:
+        df['Risk_Injury'] = 0
+        
+    # Aggregate Score [0 to 3]
+    df['Total_Risk_Score'] = df['Risk_Contract'] + df['Risk_Age'] + df['Risk_Injury']
+    
+    return df
+
+def calculate_league_index(df, league_col='Current_League'):
+    """
+    Applies the League Strength multiplier based on UEFA coefficients.
+    """
+    df = df.copy()
+    if league_col in df.columns:
+        df['League_Index'] = df[league_col].map(LEAGUE_COEFFICIENTS).fillna(0.4) # Default tier 3
+    return df
+
+def encode_categorical_features(df, position_col='Position', nationality_tier_col='Nationality_Tier'):
+    """
+    Performs One-Hot Encoding for positions and handles Nationality Tiers.
+    """
+    df = df.copy()
+    if position_col in df.columns:
+        # Prevent completely exploding dimensions if many obscure positions exist
+        df = pd.get_dummies(df, columns=[position_col], prefix='Pos')
+        
+    if nationality_tier_col in df.columns:
+        # e.g., Tier 1 = EU5/SA, Tier 2 = Rest of World
+        df[nationality_tier_col] = df[nationality_tier_col].astype(int)
+        
+    return df
+
+def build_all_features(df):
+    """
+    Orchestrates the feature engineering pipeline.
+    """
+    df = calculate_risk_score(df)
+    df = calculate_league_index(df)
+    df = encode_categorical_features(df)
+    return df

src/models/explain.py

@@ -0,0 +1,43 @@
+import shap
+import pandas as pd
+import numpy as np
+
+def generate_shap_explanation(model, user_input_df):
+    """
+    Generates SHAP values for a specific player prediction.
+    """
+    # Create the tree explainer for XGBoost
+    explainer = shap.TreeExplainer(model)
+    
+    # Calculate shap values for the specific prediction
+    shap_values = explainer(user_input_df)
+    
+    # Extract structural contributions
+    feature_names = user_input_df.columns
+    contributions = shap_values.values[0]
+    
+    explanation_df = pd.DataFrame({
+        'Feature': feature_names,
+        'Value': user_input_df.iloc[0].values,
+        'Contribution_to_LogPrice': contributions
+    })
+    
+    # Identify top drivers
+    explanation_df['Absolute_Impact'] = np.abs(explanation_df['Contribution_to_LogPrice'])
+    explanation_df = explanation_df.sort_values(by='Absolute_Impact', ascending=False)
+    
+    return shap_values, explanation_df
+
+def make_justification_string(prediction_dict):
+    """
+    Formats the FairValue logic human-readably for the pitch/app logic.
+    """
+    pv = prediction_dict['predicted_value']
+    cap = prediction_dict['hard_cap']
+    risk_pct = prediction_dict['risk_percentage'] * 100
+    
+    msg = (f"Our model predicts a baseline market value of £{pv/1e6:.1f}m. "
+           f"However, after factoring a {risk_pct:.0f}% risk discount based on "
+           f"the player's profile (contract/age/injury), the Risk-Adjusted "
+           f"Fair Value drops. We recommend a maximal Hard Cap of £{cap/1e6:.1f}m.")
+    return msg

src/models/predict_cap.py

@@ -0,0 +1,57 @@
+import numpy as np
+import xgboost as xgb
+
+class FairValueCapEstimator:
+    def __init__(self, model_path="fairvalue_xgboost.json"):
+        self.model = xgb.XGBRegressor()
+        try:
+            self.model.load_model(model_path)
+            # Default validation error margin (Confidence Interval) roughly 15%
+            self.model_error_margin = 0.15 
+            self.is_loaded = True
+        except:
+            print("Warning: Model file not found. Estimations will be unavailable.")
+            self.model_error_margin = 0.15
+            self.is_loaded = False
+
+    def predict_fair_value(self, player_features_df):
+        """
+        Calculates the Predicted Value (PV) and the computationally strict Hard Cap.
+        """
+        if not self.is_loaded:
+            return {"error": "Model not loaded."}
+            
+        # 1. Predicted Value (PV) (Reverse the log1p transform)
+        log_pv = self.model.predict(player_features_df)
+        pv = np.expm1(log_pv)[0]
+        
+        # 2. Confidence Interval (CI) bounds
+        conservative_value = pv * (1 - self.model_error_margin)
+        optimistic_value = pv * (1 + self.model_error_margin)
+        
+        # 3. Calculate Risk Discount (RD)
+        risk_discount_percentage = 0.0
+        
+        # Using feature engineered columns from build_features.py logic
+        if 'Risk_Contract' in player_features_df.columns and player_features_df['Risk_Contract'].iloc[0] == 1:
+            risk_discount_percentage += 0.20 # 20% discount for expiring contracts
+            
+        if 'Risk_Age' in player_features_df.columns and player_features_df['Risk_Age'].iloc[0] == 1:
+            risk_discount_percentage += 0.15 # 15% discount for age curve decay
+            
+        if 'Risk_Injury' in player_features_df.columns and player_features_df['Risk_Injury'].iloc[0] == 1:
+            risk_discount_percentage += 0.10 # 10% discount for recurring injuries
+            
+        risk_discount_monetary = conservative_value * risk_discount_percentage
+        
+        # 4. Hard Cap
+        hard_cap = conservative_value - risk_discount_monetary
+        
+        return {
+            'predicted_value': pv,
+            'conservative': conservative_value,
+            'optimistic': optimistic_value,
+            'risk_discount': risk_discount_monetary,
+            'risk_percentage': risk_discount_percentage,
+            'hard_cap': hard_cap
+        }

src/models/train_xgboost.py

@@ -0,0 +1,82 @@
+import xgboost as xgb
+import pandas as pd
+import numpy as np
+from sklearn.model_selection import train_test_split, RandomizedSearchCV
+from sklearn.metrics import mean_absolute_error, mean_squared_error
+
+def prepare_data_for_training(df, target_col='Transfer_Fee_2024_GBP'):
+    """
+    Separates features and targets, applies log transformation to the target
+    so we don't predict negative prices and handle extreme outliers better.
+    """
+    # Drop identifying or leaky features
+    X = df.drop(columns=[target_col, 'Player_ID', 'Name', 'name', 'name_x', 'name_y',
+                          'Transfer_Date', 'Adjusted_Fee_EUR', 'Inflation_Multiplier',
+                          'Transfer_Year', 'player_id'], errors='ignore')
+    
+    # Remove leaky columns derived from the target
+    leaky_cols = [c for c in X.columns if 'fee' in c.lower() or ('market_value' in c.lower() and c != 'market_value_in_eur_x')]
+    X = X.drop(columns=leaky_cols, errors='ignore')
+    
+    # Train on log of price so errors on cheap players don't swamp the expensive ones
+    y = np.log1p(df[target_col])
+    return X, y
+
+def train_model(X, y):
+    """
+    Trains the XGBoost regressor using RandomizedSearchCV for faster, wider coverage.
+    """
+    X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2, random_state=42)
+    
+    # Base regressor
+    xgb_reg = xgb.XGBRegressor(
+        objective='reg:squarederror',
+        random_state=42,
+        tree_method='hist'  # Faster training
+    )
+    
+    # Expanded randomised search parameter space (much wider than GridSearch)
+    param_dist = {
+        'n_estimators':       [150, 300, 500, 700],
+        'learning_rate':      [0.01, 0.03, 0.05, 0.1],
+        'max_depth':          [3, 4, 5, 6],
+        'min_child_weight':   [1, 3, 5],       # Controls overfitting on rare elite transfers
+        'subsample':          [0.7, 0.8, 1.0], # Row sampling — reduces variance
+        'colsample_bytree':   [0.7, 0.8, 1.0], # Feature sampling — prevents overfitting
+        'gamma':              [0, 0.1, 0.3],   # Minimum loss reduction — pruning
+        'reg_lambda':         [0.5, 1.0, 2.0], # L2 Regularisation
+    }
+    
+    print("Beginning Hyperparameter Search (RandomizedSearchCV, 40 iterations, 5-fold CV)...")
+    search = RandomizedSearchCV(
+        xgb_reg,
+        param_distributions=param_dist,
+        n_iter=40,           # Test 40 random combinations (vs 8 before)
+        cv=5,                # 5-fold cross-validation (vs 3 before)
+        scoring='neg_mean_absolute_error',
+        n_jobs=-1,
+        random_state=42,
+        verbose=1
+    )
+    search.fit(X_train, y_train)
+    
+    best_model = search.best_estimator_
+    print(f"\nBest params: {search.best_params_}")
+    
+    # Evaluate on held-out test set — convert back from log scale
+    predictions_log = best_model.predict(X_test)
+    predictions_real = np.expm1(predictions_log)
+    y_test_real = np.expm1(y_test)
+    
+    mae = mean_absolute_error(y_test_real, predictions_real)
+    rmse = np.sqrt(mean_squared_error(y_test_real, predictions_real))
+    
+    print(f"\n📊 Model Evaluation:")
+    print(f"   MAE  (Mean Absolute Error):       £{mae:>12,.0f}")
+    print(f"   RMSE (Root Mean Square Error):    £{rmse:>12,.0f}")
+    
+    # Save the model
+    best_model.save_model("fairvalue_xgboost.json")
+    print("Model saved as fairvalue_xgboost.json")
+    
+    return best_model, mae