# Migration Guide

This guide helps you migrate from the legacy Odds Service to TRADE, LSports' modern odds feed platform.

***

## Why Migrate?

| Benefit              | Description                                                     |
| -------------------- | --------------------------------------------------------------- |
| **Modern Platform**  | Intuitive UI for configuration and monitoring                   |
| **Better Analytics** | BOOST integration for provider benchmarking                     |
| **Risk Management**  | DEFEND integration for bet monitoring                           |
| **Improved Support** | Streamlined support with feature request tracking               |
| **New Features**     | Access to latest capabilities like Safe Message, Provider Odds+ |

***

## Migration Overview

```
┌─────────────────┐         ┌─────────────────┐
│   Odds Service  │  ────▶  │      TRADE      │
│   (Legacy)      │         │   (ARENA360)    │
└─────────────────┘         └─────────────────┘
         │                           │
         │                           ▼
         │                  ┌─────────────────┐
         │                  │     + BOOST     │
         │                  │    + DEFEND     │
         │                  │    + ENGAGE     │
         │                  └─────────────────┘
```

***

## Step-by-Step Migration

### Step 1: Contact Your CSM

Your Customer Success Manager will:

* Assess your current Odds Service configuration
* Plan your migration timeline
* Provide new TRADE credentials

### Step 2: Map Your Data

Compare your current implementation with TRADE's structure:

| Odds Service      | TRADE                   |
| ----------------- | ----------------------- |
| EnablePackage API | Distribution/Start API  |
| InPlay RMQ Host   | inplay-rmq.lsports.eu   |
| PreMatch RMQ Host | prematch-rmq.lsports.eu |
| Package GUID      | Package ID              |

### Step 3: Update Connection Settings

**Old (Odds Service):**

```
Host: prematch-rmq.lsports.eu
EnablePackage: https://prematch.lsports.eu/OddService/EnablePackage
```

**New (TRADE):**

```
Host: prematch-rmq.lsports.eu (same)
EnablePackage: https://stm-api.lsports.eu/Distribution/Start
```

### Step 4: Review Message Structure

TRADE uses the same core message structure with enhancements:

* Same Fixture, Market, Livescore, Settlement message types
* Additional fields for probability, margin calculations
* New message types for Safe Message feature

See [Message Structure](https://docs.lsports.eu/u/trade/integration/message-structure) for details.

### Step 5: Configure in TRADE Platform

1. Log in to <https://platform.lsports.eu>
2. Configure your providers in TRADE
3. Set up templates and odds ladders
4. Test with sandbox data

### Step 6: Parallel Testing

Run both systems in parallel:

1. Enable TRADE distribution
2. Compare data with Odds Service
3. Verify message parity
4. Validate your processing

### Step 7: Cutover

Once validated:

1. Switch production traffic to TRADE
2. Disable Odds Service distribution
3. Monitor for any issues
4. Decommission legacy integration

***

## Key Differences

### API Endpoints

| Function | Odds Service                 | TRADE                   |
| -------- | ---------------------------- | ----------------------- |
| Enable   | `/OddService/EnablePackage`  | `/Distribution/Start`   |
| Disable  | `/OddService/DisablePackage` | `/Distribution/Stop`    |
| Snapshot | `/OddService/GetEvents`      | `/Snapshot/GetSnapshot` |

### Authentication

Both use username/password, but:

* Odds Service uses GUID for PreMatch
* TRADE uses numeric Package ID for both

### New Features in TRADE

* **Trading Floor UI** — Visual fixture monitoring
* **Configuration UI** — Provider and margin settings
* **Safe Message** — Guaranteed message delivery
* **Provider Odds+** — Raw provider odds access
* **BOOST Integration** — Performance analytics

***

## Rollback Plan

If issues occur during migration:

1. Disable TRADE distribution
2. Re-enable Odds Service package
3. Verify data flow restored
4. Contact support for assistance

***

## Support

Need help with migration?

* **CSM:** Your primary migration contact
* **Technical Support:** [support.lsports.eu](https://support.lsports.eu/)
* **Documentation:** [TRADE Integration Guide](https://docs.lsports.eu/u/trade/integration)
