# Getting Started ## Feed **Authentication** 1. Generate an SSH key pair by following the instructions below. 2. Upon generating the SSH key pair, send an e-mail to with a specified username to connect to the SSH Feed, along with your **public** key attached. 3. You will be notified once your username has been authorised. **Mac OS X** 1. Open the Terminal application. 2. Enter the following command in the Terminal window and hit enter: ``` ssh-keygen -t rsa ``` 3. You will be prompted to specify the directory to store the key and a passphrase. Follow these prompts accordingly. 4. Navigate to the specified directory to retrieve your **public** key (.pub file) **Windows** 1. Open the Command Prompt application. 2. Enter the following command in the Command Prompt window and hit enter: ``` ssh-keygen -t rsa ``` 3. You will be prompted to specify the directory to store the generated keys and a passphrase. Follow these prompts accordingly. 4. Navigate to the specified directory to retrieve your **public** key (.pub file) ## Testing the Connection 1. Open up either the Terminal or Command Prompt application (depending on whether you're using Mac OS or Windows). 2. Enter the following command and hit enter: **Staging (we support port 22 and 2093)** ``` ssh -i [generated private key file path] [username]@golf-odds-distribution.staging.imgarena.dev -p 22 ``` > Please note as per comms sent on W/C 27th April 2026, the Domain URL change will change from imgarena.dev to srarena.io on 30th September 2026 as per below. If you wish to continue receiving pricing content after that date until end of 2026, please ensure you are hitting this new SSH domain. ``` ssh -i [generated private key file path] [username]@golf-odds-distribution.staging.srarena.io -p 22 ``` **Prod (we support port 22 and 2093)** ``` ssh -i [generated private key file path] [username]@golf-odds-distribution.services.imgarena.com -p 22 ``` > Please note as per comms sent on W/C 27th April 2026, the Domain URL change will change from imgarena.com to srarena.io on 30th September 2026 as per below. If you wish to continue receiving pricing content after that date until end of 2026, please ensure you are hitting this new SSH domain. ``` ssh -i [generated private key file path] [username]@golf-odds-distribution.services.srarena.io-p 22 ``` Note: you will need to replace **\[username]** with the username given from the Feed Authentication section and **\[private key path]** with the path to your **private** **key** file i.e. 1. You will be prompted to enter in your passphrase, enter this in accordingly. This will connect you to the feed. 2. After entering in your password, immediately enter the following command and hit enter: ``` {"request": "init", "msg": {}} ``` If this isn't done within 10 seconds upon connection, we will disconnect with this message ``` {"mode":"push","status":"error","session_id":"250d77ed-4809-413e-9d61-822d298ec15e","reason":"no init sent", "publish_time": "2025-03-20 10:05:18.924114"} ``` The response to the "init" request will contain a unique session\_id. Please provide this session id when raising any queries regarding the messages received for a given session as per below ``` { "mode": "resp", "status": "session initialized", "session_id": "66193235-937c-4591-a301-33d7251ce8b6", "publish_time": "2014-01-01 22:22:22.123456", "reason": null } ``` From this time, we will start sending heartbeats ``` { "mode": "push", "publish_time": "2025-03-20 10:05:18.924114", "type": "heartbeat", "msg": { "timestamp": "2025-03-20 10:05:18.924114" } } ``` Please be aware that the init alone is not going to start the data flow process and at this point you should explicitly subscribe to either all or selected markets. This is covered [here](/imga-dl-trading-odds-distribution/odds-distribution-service/feed-specification.md). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sportradar.com/imga-dl-trading-odds-distribution/getting-setup.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.