Code Samples | Bordeaux Index Fine Wine & Spirits

API Routes & Code Samples

This is the entry point to integrating with the APIs. Once you've sent the POST request sucessfully, you'll recieve an email confirmation which needs to be confirmed before continuing, once accepted please contact us at [email protected] as your account now needs to be internally approved before you can use it. You'll recieve an email when your testing or live account has been approved, at which point you can use the credentials to login.
NOTE: Approval is needed in both Test and Live servers, please contact us for both.

import requests

# API endpoint
url = "https://uat-api.biwine.com/v2/user/register"

# Request payload
payload = {
    "email": "[email protected]",
    "password": "yourpassword123",
    "country": "GB",
    "salesLedger": "SL001",
    "purchaseLedger": "PL001",
    "forename": "John",
    "surname": "Doe",
    "companyName": "Doe Enterprises"
}

# Request headers
headers = {
    "Content-Type": "application/json"
}

# Send POST request
response = requests.post(url, json=payload, headers=headers)

# Check response status
if response.status_code == 200:
    print("Registration successful!")
    print("Response:", response.json())
else:
    print("Registration failed.")
    print("Status code:", response.status_code)
    print("Response:", response.text)

const url = "https://uat-api.biwine.com/v2/user/register";

const data = {
  email: "[email protected]",
  password: "yourpassword123",
  country: "GB",
  salesLedger: "SL001",
  purchaseLedger: "PL001",
  forename: "John",
  surname: "Doe",
  companyName: "Doe Enterprises"
};

fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify(data)
})
.then(response => {
  if (!response.ok) {
    throw new Error(`HTTP error! Status: ${response.status}`);
  }
  return response.json();
})
.then(result => {
  console.log("Success:", result);
})
.catch(error => {
  console.error("Error:", error);
});

import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;

public class RegisterUser {
    public static void main(String[] args) {
        try {
            // Define the endpoint
            URL url = new URL("https://uat-api.biwine.com/v2/user/register");
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();

            // Set up connection properties
            conn.setRequestMethod("POST");
            conn.setRequestProperty("Content-Type", "application/json");
            conn.setDoOutput(true);

            // Define JSON payload
            String jsonInputString = """
            {
              \"email\": \"[email protected]\",
              \"password\": \"yourpassword123\",
              \"country\": \"GB\",
              \"salesLedger\": \"SL001\",
              \"purchaseLedger\": \"PL001\",
              \"forename\": \"John\",
              \"surname\": \"Doe\",
              \"companyName\": \"Doe Enterprises\"
            }
            """;

            // Send the JSON input
            try (OutputStream os = conn.getOutputStream()) {
                byte[] input = jsonInputString.getBytes("utf-8");
                os.write(input, 0, input.length);
            }

            // Read and print the response
            int responseCode = conn.getResponseCode();
            System.out.println("Response Code: " + responseCode);

            try (var reader = new java.util.Scanner(conn.getInputStream()).useDelimiter("\\A")) {
                String response = reader.hasNext() ? reader.next() : "";
                System.out.println("Response Body: " + response);
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Once you're approved to log in simply use the POST /v2/user/login endpoint with the values used in registration process (see bellow for reference)


                                        
import requests

# API endpoint
url = "https://uat-api.biwine.com/v2/user/login"

# Request payload
payload = {
    "email": "[email protected]",
    "password": "yourpassword123",
    "salesLedger": "SL001",
    "purchaseLedger": "PL001"
}

# Request headers
headers = {
    "Content-Type": "application/json"
}

# Send POST request
response = requests.post(url, json=payload, headers=headers)

# Check response status and extract token
try:
    response.raise_for_status()  # Raise an error for HTTP codes >= 400
    data = response.json()
    token = data.get("token")
    if token:
        print("Login successful!")
    else:
        print("Token not found in the response.")
except requests.exceptions.HTTPError as err:
    print("HTTP error:", err)
except ValueError:
    print("Failed to parse JSON response.")
except Exception as e:
    print("Unexpected error:", e)


                                        
const url = "https://uat-api.biwine.com/v2/user/login";

const data = {
  email: "[email protected]",
  password: "yourpassword123",
  salesLedger: "SL001",
  purchaseLedger: "PL001"
};

fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify(data)
})
.then(response => {
  if (!response.ok) {
    throw new Error(`HTTP error! Status: ${response.status}`);
  }
  return response.json();
})
.then(json => {
  const token = json.token;
  if (token) {
    console.log("Login successful. Token:", token);
  } else {
    console.log("Token not found in response.");
  }
})
.catch(error => {
  console.error("Error:", error);
});


                                        
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

import org.json.JSONObject;

public class LoginWithHttpClient {
    public static void main(String[] args) {
        // Define request payload
        String jsonInput = """
        {
          \"email\": \"[email protected]\",
          \"password\": \"yourpassword123\",
          \"salesLedger\": \"SL001\",
          \"purchaseLedger\": \"PL001\"
        }
        """;

        try {
            // Create HTTP client
            HttpClient client = HttpClient.newHttpClient();

            // Create request
            HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create("https://uat-api.biwine.com/v2/user/login"))
                    .header("Content-Type", "application/json")
                    .POST(HttpRequest.BodyPublishers.ofString(jsonInput))
                    .build();

            // Send request and get response
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            // Check status and parse response
            if (response.statusCode() == 200) {
                JSONObject json = new JSONObject(response.body());
                if (json.has("token")) {
                    String token = json.getString("token");
                    System.out.println("Login successful. Token: " + token);
                } else {
                    System.out.println("Token not found in response.");
                }
            } else {
                System.out.println("Login failed. Status: " + response.statusCode());
                System.out.println("Response body: " + response.body());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

The response will contain a token property (read and printed above), which should be sent as an Authorization header to query protected routes. The token has a 24 hours expiry, after which you'll be required to login again and replace it with your old token.

If you need to resend the verification email, you can use the POST /v2/user/resendVerificationEmail endpoint. This endpoint requires the email address used during registration. See the example code below for reference.


                                        
import requests

# URL of the API endpoint
url = "https://uat-api.biwine.com/v2/user/resendVerificationEmail"

# JSON body to be sent in the request
payload = {
    "email": "string",
    "salesLedger": "string",
    "purchaseLedger": "string"
}

# Headers, if required
headers = {
    "Content-Type": "application/json"
}

# Send the POST request
response = requests.post(url, json=payload, headers=headers)

# Print the response status and body
print("Status Code:", response.status_code)
print("Response Body:", response.text)


                                        
const axios = require('axios');

const url = "https://uat-api.biwine.com/v2/user/resendVerificationEmail";

const payload = {
  email: "string",
  salesLedger: "string",
  purchaseLedger: "string"
};

axios.post(url, payload, {
  headers: {
    "Content-Type": "application/json"
  }
})
.then(response => {
  console.log("Status Code:", response.status);
  console.log("Response Body:", response.data);
})
.catch(error => {
  console.error("Error:", error);
});


                                        
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpRequest.BodyPublishers;

public class PostRequestExample {
    public static void main(String[] args) {
        String url = "https://uat-api.biwine.com/v2/user/resendVerificationEmail";
        String jsonBody = """
            {
                \"email\": \"string\",
                \"salesLedger\": \"string\",
                \"purchaseLedger\": \"string\"
            }
            """;

        HttpClient client = HttpClient.newHttpClient();

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Content-Type", "application/json")
                .POST(BodyPublishers.ofString(jsonBody))
                .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            System.out.println("Status Code: " + response.statusCode());
            System.out.println("Response Body: " + response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

If you need to request a password reset, you can use the POST /v2/user/requestPasswordReset endpoint. This endpoint requires the email address associated with the account. See the example code below for reference. On successful response, the verification email will be resent to the provided email address. Make sure to check your inbox and spam folder for the email.


                                        
import requests

# API endpoint URL
url = "https://uat-api.biwine.com/v2/user/requestPasswordReset"

# JSON payload
payload = {
    "email": "string",
    "salesLedger": "string",
    "purchaseLedger": "string"
}

# Headers
headers = {
    "Content-Type": "application/json"
}

# Send the POST request
try:
    response = requests.post(url, json=payload, headers=headers)

    # Output the response
    print("Status Code:", response.status_code)
    print("Response Body:", response.text)
except requests.exceptions.RequestException as e:
    print("Request failed:", e)


                                        
const url = "https://uat-api.biwine.com/v2/user/requestPasswordReset";

const payload = {
  email: "string",
  salesLedger: "string",
  purchaseLedger: "string"
};

fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify(payload)
})
  .then(response => {
    console.log("Status Code:", response.status);
    return response.text();
  })
  .then(data => {
    console.log("Response Body:", data);
  })
  .catch(error => {
    console.error("Request failed:", error);
  });


                                        
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class RequestPasswordReset {

    public static void main(String[] args) {
        String url = "https://uat-api.biwine.com/v2/user/requestPasswordReset";

        String jsonBody = """
        {
            \"email\": \"string\",
            \"salesLedger\": \"string\",
            \"purchaseLedger\": \"string\"
        }
        """;

        HttpClient client = HttpClient.newHttpClient();

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
                .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
            System.out.println("Status Code: " + response.statusCode());
            System.out.println("Response Body: " + response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Endpoint to get storage locations linked to your account.


import requests

# Your Bearer token from login
token = "YOUR_JWT_TOKEN_HERE or ENV VARIABLE"

# Endpoint
url = "https://uat-api.biwine.com/v2/user/account/storage/locations"

# Headers
headers = {
    "Authorization": f"Bearer {token}",
    "Accept": "application/json"
}

# Make GET request
response = requests.get(url, headers=headers)

# Handle response
if response.status_code == 200:
    try:
        data = response.json()
        results = data.get("results", [])
        if not results:
            print("No results found.")
        else:
            for item in results:
                name = item.get("name", "Unknown")
                print("-", name)
    except ValueError:
        print("Invalid JSON in response.")
else:
    print(f"Request failed. Status code: {response.status_code}")
    print(response.text)


const token = "YOUR_JWT_TOKEN_HERE"; // or process.env.TOKEN
const url = "https://uat-api.biwine.com/v2/user/account/storage/locations";

try {
  const response = await fetch(url, {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${token}`,
      "Accept": "application/json"
    }
  });

  if (response.ok) {
    const data = await response.json();
    const results = data.results || [];

    if (results.length === 0) {
      console.log("No results found.");
    } else {
      results.forEach(item => {
        console.log("-", item.name || "Unknown");
      });
    }
  } else {
    console.log(`Request failed. Status code: ${response.status}`);
    console.log(await response.text());
  }

} catch (error) {
  console.error("Request failed:", error.message);
}


import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import org.json.JSONArray;
import org.json.JSONObject;

String token = "YOUR_JWT_TOKEN_HERE"; // Or load from env
String url = "https://uat-api.biwine.com/v2/user/account/storage/locations";

// Create HTTP client
HttpClient client = HttpClient.newHttpClient();

// Build request with headers
HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create(url))
        .header("Authorization", "Bearer " + token)
        .header("Accept", "application/json")
        .GET()
        .build();

try {
    // Send request
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

    if (response.statusCode() == 200) {
        JSONObject json = new JSONObject(response.body());
        JSONArray results = json.optJSONArray("results");

        if (results == null || results.isEmpty()) {
            System.out.println("No results found.");
        } else {
            for (int i = 0; i < results.length(); i++) {
                JSONObject item = results.optJSONObject(i);
                String name = (item != null) ? item.optString("name", "Unknown") : "Unknown";
                System.out.println("- " + name);
            }
        }
    } else {
        System.out.println("Request failed. Status code: " + response.statusCode());
        System.out.println(response.body());
    }

} catch (Exception e) {
    System.out.println("Request failed: " + e.getMessage());
}

Endpoint to get storage locations linked to your account.


import requests

# Your Bearer token from login
token = "YOUR_JWT_TOKEN_HERE or ENV VARIABLE"

# Endpoint
url = "https://uat-api.biwine.com/v2/user/account/addresses/delivery"

# Headers
headers = {
    "Authorization": f"Bearer {token}",
    "Accept": "application/json"
}

# Make GET request
response = requests.get(url, headers=headers)

# Handle response
if response.status_code == 200:
    try:
        data = response.json()
        results = data.get("results", [])
        if not results:
            print("No results found.")
        else:
            for item in results:
                addressLine1 = item.get("addressLine1", "Unknown")
                print("-", addressLine1)
    except ValueError:
        print("Invalid JSON in response.")
else:
    print(f"Request failed. Status code: {response.status_code}")
    print(response.text)


const token = "YOUR_JWT_TOKEN_HERE"; // or process.env.TOKEN
const url = "https://uat-api.biwine.com/v2/user/account/addresses/delivery";

try {
  const response = await fetch(url, {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${token}`,
      "Accept": "application/json"
    }
  });

  if (response.ok) {
    const data = await response.json();
    const results = data.results || [];

    if (results.length === 0) {
      console.log("No results found.");
    } else {
      results.forEach(item => {
        console.log("-", item.addressLine1 || "Unknown");
      });
    }
  } else {
    console.log(`Request failed. Status code: ${response.status}`);
    console.log(await response.text());
  }

} catch (error) {
  console.error("Request failed:", error.message);
}


import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import org.json.JSONArray;
import org.json.JSONObject;

String token = "YOUR_JWT_TOKEN_HERE"; // Or load from env
String url = "https://uat-api.biwine.com/v2/user/account/addresses/delivery";

// Create HTTP client
HttpClient client = HttpClient.newHttpClient();

// Build request with headers
HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create(url))
        .header("Authorization", "Bearer " + token)
        .header("Accept", "application/json")
        .GET()
        .build();

try {
    // Send request
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

    if (response.statusCode() == 200) {
        JSONObject json = new JSONObject(response.body());
        JSONArray results = json.optJSONArray("results");

        if (results == null || results.isEmpty()) {
            System.out.println("No results found.");
        } else {
            for (int i = 0; i < results.length(); i++) {
                JSONObject item = results.optJSONObject(i);
                String addressLine1 = (item != null) ? item.optString("addressLine1", "Unknown") : "Unknown";
                System.out.println("- " + addressLine1);
            }
        }
    } else {
        System.out.println("Request failed. Status code: " + response.statusCode());
        System.out.println(response.body());
    }

} catch (Exception e) {
    System.out.println("Request failed: " + e.getMessage());
}

The producer routes can be accessed through /v2/producer and provide you with endpoints to view our producer catalogue. The in-query parameters page and limit are supported and default to 0 and 50 respectively.

View our full catalogue of producers


import requests

# Your Bearer token from login
token = "YOUR_JWT_TOKEN_HERE or ENV VARIABLE"

# Endpoint
url = "https://uat-api.biwine.com/v2/producer"

# Headers
headers = {
    "Authorization": f"Bearer {token}",
    "Accept": "application/json"
}

# Make GET request
response = requests.get(url, headers=headers)

# Handle response
if response.status_code == 200:
    try:
        data = response.json()
        results = data.get("results", [])
        if not results:
            print("No results found.")
        else:
            for item in results:
                name = item.get("name", "Unknown")
                print("-", name)
    except ValueError:
        print("Invalid JSON in response.")
else:
    print(f"Request failed. Status code: {response.status_code}")
    print(response.text)


const token = "YOUR_JWT_TOKEN_HERE"; // or process.env.TOKEN
const url = "https://uat-api.biwine.com/v2/producer";

try {
  const response = await fetch(url, {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${token}`,
      "Accept": "application/json"
    }
  });

  if (response.ok) {
    const data = await response.json();
    const results = data.results || [];

    if (results.length === 0) {
      console.log("No results found.");
    } else {
      results.forEach(item => {
        console.log("-", item.name || "Unknown");
      });
    }
  } else {
    console.log(`Request failed. Status code: ${response.status}`);
    console.log(await response.text());
  }

} catch (error) {
  console.error("Request failed:", error.message);
}


import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import org.json.JSONArray;
import org.json.JSONObject;

String token = "YOUR_JWT_TOKEN_HERE"; // Or load from env
String url = "https://uat-api.biwine.com/v2/producer";

// Create HTTP client
HttpClient client = HttpClient.newHttpClient();

// Build request with headers
HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create(url))
        .header("Authorization", "Bearer " + token)
        .header("Accept", "application/json")
        .GET()
        .build();

try {
    // Send request
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

    if (response.statusCode() == 200) {
        JSONObject json = new JSONObject(response.body());
        JSONArray results = json.optJSONArray("results");

        if (results == null || results.isEmpty()) {
            System.out.println("No results found.");
        } else {
            for (int i = 0; i < results.length(); i++) {
                JSONObject item = results.optJSONObject(i);
                String name = (item != null) ? item.optString("name", "Unknown") : "Unknown";
                System.out.println("- " + name);
            }
        }
    } else {
        System.out.println("Request failed. Status code: " + response.statusCode());
        System.out.println(response.body());
    }

} catch (Exception e) {
    System.out.println("Request failed: " + e.getMessage());
}

View data about a specific producer


import requests

# Your Bearer token from login
token = "YOUR_JWT_TOKEN_HERE or ENV VARIABLE"
bipid = "YOUR_BIPID_HERE"

# Endpoint
url = f"https://uat-api.biwine.com/v2/producer/{bipid}"

# Headers
headers = {
    "Authorization": f"Bearer {token}",
    "Accept": "application/json"
}

# Make GET request
response = requests.get(url, headers=headers)

# Handle response
if response.status_code == 200:
    try:
        data = response.json()
        results = data.get("results", [])
        if not results:
            print("No results found.")
        else:
            for item in results:
                name = item.get("name", "Unknown")
                print("-", name)
    except ValueError:
        print("Invalid JSON in response.")
else:
    print(f"Request failed. Status code: {response.status_code}")
    print(response.text)


const token = "YOUR_JWT_TOKEN_HERE"; // or process.env.TOKEN
const bipid = "YOUR_BIPID_HERE";
const url = `https://uat-api.biwine.com/v2/producer/${bipid}`;

try {
  const response = await fetch(url, {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${token}`,
      "Accept": "application/json"
    }
  });

  if (response.ok) {
    const data = await response.json();
    const results = data.results || [];

    if (results.length === 0) {
      console.log("No results found.");
    } else {
      results.forEach(item => {
        console.log("-", item.name || "Unknown");
      });
    }
  } else {
    console.log(`Request failed. Status code: ${response.status}`);
    console.log(await response.text());
  }

} catch (error) {
  console.error("Request failed:", error.message);
}


import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import org.json.JSONArray;
import org.json.JSONObject;

String token = "YOUR_JWT_TOKEN_HERE"; // Or load from env
String bip = "YOUR_BIPID_HERE";
String url = "https://uat-api.biwine.com/v2/producer/" + bip;

// Create HTTP client
HttpClient client = HttpClient.newHttpClient();

// Build request with headers
HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create(url))
        .header("Authorization", "Bearer " + token)
        .header("Accept", "application/json")
        .GET()
        .build();

try {
    // Send request
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

    if (response.statusCode() == 200) {
        JSONObject json = new JSONObject(response.body());
        JSONArray results = json.optJSONArray("results");

        if (results == null || results.isEmpty()) {
            System.out.println("No results found.");
        } else {
            for (int i = 0; i < results.length(); i++) {
                JSONObject item = results.optJSONObject(i);
                String name = (item != null) ? item.optString("name", "Unknown") : "Unknown";
                System.out.println("- " + name);
            }
        }
    } else {
        System.out.println("Request failed. Status code: " + response.statusCode());
        System.out.println(response.body());
    }

} catch (Exception e) {
    System.out.println("Request failed: " + e.getMessage());
}

The endpoint is the main entry point for accessing market data. It provides a list of all available wines, their product details and bids & offers available. It supports pagination with in-query parameters page and limit which default to 0 and 50 respectively. See bellow code which demonstrates how to access the endpoint and iterate through the list of wines printing the name to the console.


                                        
import requests

# Your Bearer token from login
token = "YOUR_JWT_TOKEN_HERE or ENV VARIABLE"

# Endpoint
url = "https://uat-api.biwine.com/v2/market"

# Headers
headers = {
    "Authorization": f"Bearer {token}",
    "Accept": "application/json"
}

# Make GET request
response = requests.get(url, headers=headers)

# Handle response
if response.status_code == 200:
    try:
        data = response.json()
        results = data.get("results", [])
        if not results:
            print("No results found.")
        else:
            print("Wine names:")
            for item in results:
                name = item.get("productName", "Unknown")
                print("-", name)
    except ValueError:
        print("Invalid JSON in response.")
else:
    print(f"Request failed. Status code: {response.status_code}")
    print(response.text)


                                        
const token = "YOUR_JWT_TOKEN_HERE or ENV VARIABLE";

const url = "https://uat-api.biwine.com/v2/market";

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Accept": "application/json"
  }
})
.then(response => {
  if (!response.ok) {
    throw new Error(`HTTP error: ${response.status}`);
  }
  return response.json();
})
.then(data => {
  const results = data.results || [];
  if (results.length === 0) {
    console.log("No wine results found.");
  } else {
    console.log("Wine names:");
    results.forEach(item => {
      console.log("-", item.productName || "Unknown");
    });
  }
})
.catch(error => {
  console.error("Request failed:", error);
});


                                        
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

import org.json.JSONArray;
import org.json.JSONObject;

public class GetWineNames {
    public static void main(String[] args) {
        String token = "YOUR_JWT_TOKEN_HERE or ENV VARIABLE"; // Replace with actual token
        String url = "https://uat-api.biwine.com/v2/market";

        try {
            // Create HTTP client
            HttpClient client = HttpClient.newHttpClient();

            // Create GET request with Authorization header
            HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create(url))
                    .header("Authorization", "Bearer " + token)
                    .header("Accept", "application/json")
                    .GET()
                    .build();

            // Send request and get response
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                JSONObject json = new JSONObject(response.body());
                JSONArray results = json.optJSONArray("results");

                if (results == null || results.isEmpty()) {
                    System.out.println("No wine results found.");
                } else {
                    System.out.println("Wine names:");
                    for (int i = 0; i < results.length(); i++) {
                        JSONObject item = results.getJSONObject(i);
                        String productName = item.optString("productName", "Unknown");
                        System.out.println("- " + productName);
                    }
                }
            } else {
                System.out.println("Request failed with status: " + response.statusCode());
                System.out.println("Body: " + response.body());
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

This endpoint allows you to view the details of a specific wine using its lwin18 code, returning the same information and details as the /v2/market endpoint but only for the specific lwin18 market. The bellow code demonstrates how to access the endpoint and prints the lwinProductName property.



                                        
import requests

# Replace with your actual token and lwin18 value
token = "YOUR_JWT_TOKEN_HERE or ENV VARIABLE"
lwin18 = "100006920071200750"

# API endpoint
url = f"https://uat-api.biwine.com/v2/market/lwin18/{lwin18}"

# Headers including the Bearer token
headers = {
    "Authorization": f"Bearer {token}",
    "Accept": "application/json"
}

# Send GET request
response = requests.get(url, headers=headers)

# Handle response
if response.status_code == 200:
    data = response.json()
    product_name = data.get("lwinProductName")
    if product_name:
        print("Product Name:", product_name)
    else:
        print("lwinProductName not found in response.")
else:
    print("Request failed with status:", response.status_code)
    print("Response:", response.text)


                                        
const token = "YOUR_JWT_TOKEN_HERE"; // Replace with your actual token
const lwin18 = "100006920071200750"; // Example lwin18 value

const url = `https://uat-api.biwine.com/v2/market/lwin18/${lwin18}`;

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Accept": "application/json"
  }
})
  .then(response => {
    if (!response.ok) {
      throw new Error(`HTTP error! Status: ${response.status}`);
    }
    return response.json();
  })
  .then(data => {
    const productName = data.lwinProductName;
    if (productName) {
      console.log("Product Name:", productName);
    } else {
      console.log("lwinProductName not found in response.");
    }
  })
  .catch(error => {
    console.error("Error:", error);
  });


                                        
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

import org.json.JSONArray;
import org.json.JSONObject;

public class GetWineNames {
    public static void main(String[] args) {
        String token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."; // Replace with actual token
        String url = "https://uat-api.biwine.com/v2/market";

        try {
            // Create HTTP client
            HttpClient client = HttpClient.newHttpClient();

            // Create GET request with Authorization header
            HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create(url))
                    .header("Authorization", "Bearer " + token)
                    .header("Accept", "application/json")
                    .GET()
                    .build();

            // Send request and get response
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                JSONObject json = new JSONObject(response.body());
                JSONArray results = json.optJSONArray("results");

                if (results == null || results.isEmpty()) {
                    System.out.println("No wine results found.");
                } else {
                    System.out.println("Wine names:");
                    for (int i = 0; i < results.length(); i++) {
                        JSONObject item = results.getJSONObject(i);
                        String productName = item.optString("productName", "Unknown");
                        System.out.println("- " + productName);
                    }
                }
            } else {
                System.out.println("Request failed with status: " + response.statusCode());
                System.out.println("Body: " + response.body());
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

This endpoint allows you to view the delta of the market from a ISO time stamp onwards. The result will be list of wines like the /market route but with an additional 'changesSince' property that cronologically shows the changes to the wine's orders since the time stamp. The bellow code demonstrates how to access the endpoint and prints the time that the last change happened for the first wine in the list. It requires a mandatory in-query parameter 'fromDateTime' which should be an ISO date. additionally the optional in-query parameters page, limit and marketDepth are also supported/


                                        
import requests

# Replace with your actual token
token = "YOUR_JWT_TOKEN_HERE or ENV VARIABLE"

# ISO-formatted datetime query param
from_datetime = "2025-04-30T00:00:00.000Z"  # adjust as needed

# API endpoint with query param
url = "https://uat-api.biwine.com/v2/market/delta"
params = {
    "fromDateTime": from_datetime
}

# Authorization headers
headers = {
    "Authorization": f"Bearer {token}",
    "Accept": "application/json"
}

# Send GET request
response = requests.get(url, headers=headers, params=params)

if response.status_code == 200:
    data = response.json()
    results = data.get("results", [])

    if results:
        first_result = results[0]
        changes = first_result.get("changesSince", {})

        bids = changes.get("bids", [])
        offers = changes.get("offers", [])

        # Check for time in bids or offers
        if bids:
            print("First bid change time:", bids[0].get("time"))
        elif offers:
            print("First offer change time:", offers[0].get("time"))
        else:
            print("No bid or offer changes found in changesSince.")
    else:
        print("No results in response.")
else:
    print("Request failed with status:", response.status_code)
    print("Response:", response.text)


                                        
const token = "YOUR_JWT_TOKEN_HERE"; // Replace with your actual token
const fromDateTime = "2025-04-30T00:00:00.000Z"; // ISO 8601 format

const url = `https://uat-api.biwine.com/v2/market/delta?fromDateTime=${encodeURIComponent(fromDateTime)}`;

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Accept": "application/json"
  }
})
  .then(res => {
    if (!res.ok) {
      throw new Error(`HTTP error! Status: ${res.status}`);
    }
    return res.json();
  })
  .then(data => {
    const results = data.results;
    if (Array.isArray(results) && results.length > 0) {
      const first = results[0];
      const changes = first.changesSince || {};
      const bidChanges = changes.bids || [];
      const offerChanges = changes.offers || [];

      if (bidChanges.length > 0) {
        console.log("First bid change time:", bidChanges[0].time);
      } else if (offerChanges.length > 0) {
        console.log("First offer change time:", offerChanges[0].time);
      } else {
        console.log("No bid or offer changes found.");
      }
    } else {
      console.log("No results returned.");
    }
  })
  .catch(err => {
    console.error("Request failed:", err);
  });


                                        
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

import org.json.JSONArray;
import org.json.JSONObject;

public class MarketDeltaQuery {
    public static void main(String[] args) {
        String token = "YOUR_JWT_TOKEN_HERE";
        String fromDateTime = "2025-04-30T00:00:00.000Z";

        try {
            // Construct URI with query param
            String url = "https://uat-api.biwine.com/v2/market/delta?fromDateTime=" + fromDateTime;

            HttpClient client = HttpClient.newHttpClient();

            HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create(url))
                    .header("Authorization", "Bearer " + token)
                    .header("Accept", "application/json")
                    .GET()
                    .build();

            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                JSONObject json = new JSONObject(response.body());
                JSONArray results = json.getJSONArray("results");

                if (!results.isEmpty()) {
                    JSONObject firstItem = results.getJSONObject(0);
                    JSONObject changes = firstItem.optJSONObject("changesSince");

                    if (changes != null) {
                        JSONArray bids = changes.optJSONArray("bids");
                        JSONArray offers = changes.optJSONArray("offers");

                        if (bids != null && !bids.isEmpty()) {
                            String time = bids.getJSONObject(0).getString("time");
                            System.out.println("First bid change time: " + time);
                        } else if (offers != null && !offers.isEmpty()) {
                            String time = offers.getJSONObject(0).getString("time");
                            System.out.println("First offer change time: " + time);
                        } else {
                            System.out.println("No bid or offer changes found in changesSince.");
                        }
                    } else {
                        System.out.println("changesSince not found.");
                    }
                } else {
                    System.out.println("No results in response.");
                }

            } else {
                System.out.println("Request failed. Status: " + response.statusCode());
                System.out.println("Response: " + response.body());
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

This endpoint provides a list of all supported markets and their details. It allows you to query the markets that are currently available for trading. The code below demonstrates how to access the endpoint and prints the market names.


                                            
import requests

# URL endpoint
url = "https://uat-api.biwine.com/v2/market/supported"

# Replace this with your actual Bearer token
auth_token = "YOUR_ACCESS_TOKEN_HERE"

# Set headers with Authorization
headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

try:
    # Send GET request
    response = requests.get(url, headers=headers)
    response.raise_for_status()

    # Parse JSON response
    data = response.json()
    results = data.get("results", [])

    # Print lwin18 for each item
    for item in results:
        lwin18 = item.get("lwin18")
        if lwin18:
            print("lwin18:", lwin18)

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)
except ValueError:
    print("Failed to parse JSON response")


                                            
const url = "https://uat-api.biwine.com/v2/market/supported";

// Replace this with your actual Bearer token
const token = "YOUR_ACCESS_TOKEN_HERE";

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  }
})
  .then(response => {
    if (!response.ok) {
      throw new Error(`Request failed with status: ${response.status}`);
    }
    return response.json();
  })
  .then(data => {
    const results = data.results || [];
    results.forEach(item => {
      if (item.lwin18) {
        console.log("lwin18:", item.lwin18);
      }
    });
  })
  .catch(error => {
    console.error("Error:", error.message);
  });


                                            
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

import org.json.JSONArray;
import org.json.JSONObject;

public class GetSupportedMarketItems {

    public static void main(String[] args) {
        // Replace with your actual token
        String token = "YOUR_ACCESS_TOKEN_HERE";
        String url = "https://uat-api.biwine.com/v2/market/supported";

        HttpClient client = HttpClient.newHttpClient();

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Authorization", "Bearer " + token)
                .header("Content-Type", "application/json")
                .GET()
                .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                JSONObject json = new JSONObject(response.body());
                JSONArray results = json.getJSONArray("results");

                for (int i = 0; i < results.length(); i++) {
                    JSONObject item = results.getJSONObject(i);
                    System.out.println("lwin18: " + item.getLong("lwin18"));
                }
            } else {
                System.out.println("Request failed with status code: " + response.statusCode());
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Endpoint to get storage locations linked to your account.


import requests

# Your Bearer token from login
token = "YOUR_JWT_TOKEN_HERE or ENV VARIABLE"

# Endpoint
url = "https://uat-api.biwine.com/v2/market/bi-price-list"

# Headers
headers = {
    "Authorization": f"Bearer {token}",
    "Accept": "application/json"
}

# Make GET request
response = requests.get(url, headers=headers)

# Handle response
if response.status_code == 200:
    try:
        data = response.json()
        results = data.get("results", [])
        if not results:
            print("No results found.")
        else:
            for item in results:
                offer_price = item.get("offer_price", "Unknown")
                print("-", offer_price)
    except ValueError:
        print("Invalid JSON in response.")
else:
    print(f"Request failed. Status code: {response.status_code}")
    print(response.text)


const token = "YOUR_JWT_TOKEN_HERE"; // or process.env.TOKEN
const url = "https://uat-api.biwine.com/v2/market/bi-price-list";

try {
  const response = await fetch(url, {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${token}`,
      "Accept": "application/json"
    }
  });

  if (response.ok) {
    const data = await response.json();
    const results = data.results || [];

    if (results.length === 0) {
      console.log("No results found.");
    } else {
      results.forEach(item => {
        console.log("-", item.offer_price || "Unknown");
      });
    }
  } else {
    console.log(`Request failed. Status code: ${response.status}`);
    console.log(await response.text());
  }

} catch (error) {
  console.error("Request failed:", error.message);
}


import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import org.json.JSONArray;
import org.json.JSONObject;

String token = "YOUR_JWT_TOKEN_HERE"; // Or load from env
String url = "https://uat-api.biwine.com/v2/market/bi-price-list";

// Create HTTP client
HttpClient client = HttpClient.newHttpClient();

// Build request with headers
HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create(url))
        .header("Authorization", "Bearer " + token)
        .header("Accept", "application/json")
        .GET()
        .build();

try {
    // Send request
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

    if (response.statusCode() == 200) {
        JSONObject json = new JSONObject(response.body());
        JSONArray results = json.optJSONArray("results");

        if (results == null || results.isEmpty()) {
            System.out.println("No results found.");
        } else {
            for (int i = 0; i < results.length(); i++) {
                JSONObject item = results.optJSONObject(i);
                String offer_price = (item != null) ? item.optString("offer_price", "Unknown") : "Unknown";
                System.out.println("- " + offer_price);
            }
        }
    } else {
        System.out.println("Request failed. Status code: " + response.statusCode());
        System.out.println(response.body());
    }

} catch (Exception e) {
    System.out.println("Request failed: " + e.getMessage());
}

The trading routes allow you to place, alter, delete and view your offers and bids on the market. These routes too are protected routes and require the token to be sent as an Authorization header in the request.

This end point allows you to view all of your bids or offers on the market. The side parameter can be either 'bid' or 'offer' and will return a list of all of your bids or offers respectively. The bellow code demonstrates how to access the endpoint and prints the lwinProductName property for each bid or offer. The in-query parameters page and limit are supported and default to 0 and 50 respectively, and additionally you can filter your super-set by using optional fromDate and toDate parameters which should be in yyyy-MM-dd format, note that fromDate is required if toDate is used.


                            
import requests

side = "bid"  # or "offer"
page = 1
limit = 50
auth_token = "YOUR_JWT_TOKEN_HERE"

url = f"https://uat-api.biwine.com/v2/trading/positions/{side}"

headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

params = {
    "page": page,
    "limit": limit
}

try:
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    
    data = response.json()
    results = data.get("results", [])

    for item in results:
        lwin18 = item.get("lwin18")
        if lwin18:
            print("lwin18:", lwin18)

except requests.exceptions.RequestException as e:
    print("HTTP Request failed:", e)
except ValueError:
    print("Invalid JSON response")


                            
const side = "bid"; // or "offer"
const page = 1;
const limit = 50;
const token = "YOUR_ACCESS_TOKEN_HERE";

const url = `https://uat-api.biwine.com/v2/trading/positions/${side}?page=${page}&limit=${limit}`;

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  }
})
  .then(response => {
    if (!response.ok) {
      throw new Error(`Request failed with status ${response.status}`);
    }
    return response.json();
  })
  .then(data => {
    const results = data.results || [];
    results.forEach(item => {
      console.log("lwin18:", item.lwin18);
    });
  })
  .catch(error => {
    console.error("Error:", error.message);
  });


                            
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

import org.json.JSONArray;
import org.json.JSONObject;

public class TradingPositionsFetcher {

    public static void main(String[] args) {
        // Replace these values as needed
        String side = "bid"; // or "offer"
        int page = 1;
        int limit = 50;
        String token = "YOUR_ACCESS_TOKEN_HERE";

        try {
            String url = String.format(
                "https://uat-api.biwine.com/v2/trading/positions/%s?page=%d&limit=%d",
                URLEncoder.encode(side, StandardCharsets.UTF_8),
                page,
                limit
            );

            HttpClient client = HttpClient.newHttpClient();

            HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create(url))
                    .header("Authorization", "Bearer " + token)
                    .header("Content-Type", "application/json")
                    .GET()
                    .build();

            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                JSONObject json = new JSONObject(response.body());
                JSONArray results = json.getJSONArray("results");

                for (int i = 0; i < results.length(); i++) {
                    JSONObject item = results.getJSONObject(i);
                    long lwin18 = item.getLong("lwin18");
                    System.out.println("lwin18: " + lwin18);
                }
            } else {
                System.out.println("Request failed with status code: " + response.statusCode());
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

This end point allows you to query the state of an order that you've raised, side can be either 'bid' or 'offer' and orderId is the id of the order that you want to query. The bellow code demonstrates how to access the endpoint and prints the status property.


                            
import requests

side = "bid"  # or "offer"
order_id = 94
auth_token = "YOUR_ACCESS_TOKEN_HERE"

url = f"https://uat-api.biwine.com/v2/trading/{side}/{order_id}"

headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()

    data = response.json()
    
    lwin18 = data.get("lwin18")
    if lwin18:
        print("lwin18:", lwin18)
    else:
        print("lwin18 not found in response")

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)
except ValueError:
    print("Invalid JSON response")


                        
const orderId = "YOUR_ORDER_ID_HERE";
const token = "YOUR_ACCESS_TOKEN_HERE";

const url = `https://uat-api.biwine.com/v2/trading/positions/${orderId}`;

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  }
})
  .then(response => {
    if (!response.ok) {
      throw new Error(`Request failed with status ${response.status}`);
    }
    return response.json();
  })
  .then(data => {
    const results = data.results || [];
    results.forEach(item => {
      console.log("lwin18:", item.lwin18);
    });
  })
  .catch(error => {
    console.error("Error:", error.message);
  });


                            
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

import org.json.JSONObject;

public class TradingOrderFetcher {

    public static void main(String[] args) {
        String side = "bid"; // or "offer"
        int orderId = 94;
        String token = "YOUR_ACCESS_TOKEN_HERE";

        String url = String.format("https://uat-api.biwine.com/v2/trading/%s/%d", side, orderId);

        try {
            HttpClient client = HttpClient.newHttpClient();

            HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create(url))
                    .header("Authorization", "Bearer " + token)
                    .header("Content-Type", "application/json")
                    .GET()
                    .build();

            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                JSONObject json = new JSONObject(response.body());
                if (json.has("lwin18")) {
                    System.out.println("lwin18: " + json.getLong("lwin18"));
                } else {
                    System.out.println("lwin18 not found in response");
                }
            } else {
                System.out.println("Request failed with status code: " + response.statusCode());
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

This endpoint allows you to place a bid for a specific wine using its lwin18 code. The body of the request should include the details of the bid, such as price and quantity. The code below demonstrates how to access the endpoint and prints the order id.


                        
import requests

# Replace with your actual LWIN18 identifier
lwin18 = "12345678901234"

# API endpoint
url = f"https://uat-api.biwine.com/v2/trading/lwin18/{lwin18}/bid"

# Request payload
payload = {
    "price": 940,
    "quantity": 1,
    "dutyStatus": "IB",
    "caseCondition": "OC",
    "bottleCondition": "PR",
    "availableImmediately": False,
    "fillOrKill": False,
    "customerRef": "string"
}

# Replace with a valid Bearer token or other auth if required
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_TOKEN"  # Replace with actual token
}

# Send POST request
response = requests.post(url, json=payload, headers=headers)

# Process response
if response.status_code == 200:
    try:
        data = response.json()
        print("orderId:", data.get("orderId"))
    except ValueError:
        print("Failed to decode JSON response")
else:
    print(f"Request failed with status code {response.status_code}: {response.text}")


                        
const lwin18 = "12345678901234";
const url = `https://uat-api.biwine.com/v2/trading/lwin18/${lwin18}/bid`;

const token = "YOUR_API_TOKEN";

const payload = {
  price: 940,
  quantity: 1,
  dutyStatus: "IB",
  caseCondition: "OC",
  bottleCondition: "PR",
  availableImmediately: false,
  fillOrKill: false,
  customerRef: "string"
};

fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${token}`
  },
  body: JSON.stringify(payload)
})
  .then(response => {
    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }
    return response.json();
  })
  .then(data => {
    console.log("orderId:", data.orderId);
  })
  .catch(error => {
    console.error("Error:", error);
  });


                        
import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;

import org.json.JSONObject;

public class PostBidRequest {

    public static void main(String[] args) {
        String lwin18 = "12345678901234"; // Replace with your actual LWIN18
        String apiUrl = "https://uat-api.biwine.com/v2/trading/lwin18/" + lwin18 + "/bid";
        String token = "YOUR_API_TOKEN"; // Replace with your actual Bearer token

        try {
            // Create URL and connection
            URL url = new URL(apiUrl);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();

            // Set request method and headers
            conn.setRequestMethod("POST");
            conn.setRequestProperty("Content-Type", "application/json");
            conn.setRequestProperty("Authorization", "Bearer " + token);
            conn.setDoOutput(true);

            // Create JSON request body
            JSONObject json = new JSONObject();
            json.put("price", 940);
            json.put("quantity", 1);
            json.put("dutyStatus", "IB");
            json.put("caseCondition", "OC");
            json.put("bottleCondition", "PR");
            json.put("availableImmediately", false);
            json.put("fillOrKill", false);
            json.put("customerRef", "string");

            // Send request
            try (OutputStream os = conn.getOutputStream()) {
                byte[] input = json.toString().getBytes("utf-8");
                os.write(input, 0, input.length);
            }

            // Read response
            int status = conn.getResponseCode();
            if (status == 200) {
                try (BufferedReader br = new BufferedReader(
                        new InputStreamReader(conn.getInputStream(), "utf-8"))) {
                    StringBuilder response = new StringBuilder();
                    String line;
                    while ((line = br.readLine()) != null) {
                        response.append(line.trim());
                    }

                    // Parse and print orderId
                    JSONObject responseJson = new JSONObject(response.toString());
                    System.out.println("orderId: " + responseJson.getInt("orderId"));
                }
            } else {
                System.out.println("Request failed with status code " + status);
            }

            conn.disconnect();

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

This endpoint allows you to place an offer for a specific wine using its lwin18 code. The body of the request should include the details of the bid, such as price and quantity. The code below demonstrates how to access the endpoint and prints the quantity matched.


                        
import requests

lwin18 = "100006920071200750"  # Replace with actual LWIN18
auth_token = "YOUR_JWT_TOKEN_HERE"

url = f"https://uat-api.biwine.com/v2/trading/lwin18/{lwin18}/offer"
headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()

    data = response.json()
    
    quantity = data.get("quantity")
    if quantity is not None:
        print("Quantity:", quantity)
    else:
        print("Quantity not found in response.")

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)
except ValueError:
    print("Invalid JSON response")


                        
const lwin18 = "100006920071200750"; // Replace with actual LWIN18
const token = "YOUR_JWT_TOKEN_HERE";

const url = `https://uat-api.biwine.com/v2/trading/lwin18/${lwin18}/offer`;

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  }
})
  .then(response => {
    if (!response.ok) {
      throw new Error(`Request failed with status ${response.status}`);
    }
    return response.json();
  })
  .then(data => {
    if ("quantity" in data) {
      console.log("Quantity:", data.quantity);
    } else {
      console.log("Quantity not found in response");
    }
  })
  .catch(error => {
    console.error("Error:", error.message);
  });


                        
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

import org.json.JSONObject;

public class OfferQuantityFetcher {

    public static void main(String[] args) {
        String lwin18 = "100006920071200750"; // Replace with actual LWIN18
        String token = "YOUR_JWT_TOKEN_HERE";

        String url = String.format("https://uat-api.biwine.com/v2/trading/lwin18/%s/offer", lwin18);

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer " + token)
            .header("Content-Type", "application/json")
            .GET()
            .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                JSONObject json = new JSONObject(response.body());

                if (json.has("quantity")) {
                    int quantity = json.getInt("quantity");
                    System.out.println("Quantity: " + quantity);
                } else {
                    System.out.println("Quantity not found in response.");
                }
            } else {
                System.out.println("Request failed with status code: " + response.statusCode());
            }

        } catch (Exception e) {
            System.out.println("Error during HTTP request:");
            e.printStackTrace();
        }
    }
}

This endpoint allows you to place an bid for a specific wine using its BordeauxCode code. The body of the request should include the details of the bid same as lwin18, such as price and quantity. The code below demonstrates how to access the endpoint and prints the quantity matched.


                                
import requests

# Replace with actual bordeauxCode and token
bordeauxCode = "12345"
auth_token = "YOUR_JWT_TOKEN_HERE"

url = f"https://uat-api.biwine.com/v2/trading/bordeauxCode/{bordeauxCode}/bid"
headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()

    data = response.json()
    
    quantity_matched = data.get("quantityMatched")
    if quantity_matched is not None:
        print("quantityMatched:", quantity_matched)
    else:
        print("quantityMatched not found in response.")

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)
except ValueError:
    print("Invalid JSON response")


                                
const bordeauxCode = "12345"; // Replace with actual bordeauxCode
const token = "YOUR_JWT_TOKEN_HERE";

const url = `https://uat-api.biwine.com/v2/trading/bordeauxCode/${bordeauxCode}/bid`;

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  }
})
.then(response => {
  if (!response.ok) {
    throw new Error(`Request failed with status ${response.status}`);
  }
  return response.json();
})
.then(data => {
  if ("quantityMatched" in data) {
    console.log("quantityMatched:", data.quantityMatched);
  } else {
    console.log("quantityMatched not found in response");
  }
})
.catch(error => {
  console.error("Error:", error.message);
});


                                
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

import org.json.JSONObject;

public class QuantityMatchedFetcher {

    public static void main(String[] args) {
        String bordeauxCode = "12345"; // Replace with actual bordeauxCode
        String token = "YOUR_JWT_TOKEN_HERE";

        String url = String.format("https://uat-api.biwine.com/v2/trading/bordeauxCode/%s/bid", bordeauxCode);

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer " + token)
            .header("Content-Type", "application/json")
            .GET()
            .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                JSONObject json = new JSONObject(response.body());

                if (json.has("quantityMatched")) {
                    int quantityMatched = json.getInt("quantityMatched");
                    System.out.println("quantityMatched: " + quantityMatched);
                } else {
                    System.out.println("quantityMatched not found in response.");
                }
            } else {
                System.out.println("Request failed with status code: " + response.statusCode());
            }

        } catch (Exception e) {
            System.out.println("Error during HTTP request:");
            e.printStackTrace();
        }
    }
}

This endpoint allows you to place offers for a specific Bordeaux Code. The bordeauxCode parameter specifies the wine, and the side parameter can be either 'bid' or 'offer'. The bellow code demonstrates how to access the endpoint and prints the quantity matched.


                                
import requests

# Replace with actual bordeauxCode and token
bordeauxCode = "12345"
auth_token = "YOUR_JWT_TOKEN_HERE"

url = f"https://uat-api.biwine.com/v2/trading/bordeauxCode/{bordeauxCode}/offer"
headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()

    data = response.json()
    
    quantity_matched = data.get("quantityMatched")
    if quantity_matched is not None:
        print("quantityMatched:", quantity_matched)
    else:
        print("quantityMatched not found in response.")

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)
except ValueError:
    print("Invalid JSON response")


                                
const bordeauxCode = "12345"; // Replace with actual bordeauxCode
const token = "YOUR_JWT_TOKEN_HERE";

const url = `https://uat-api.biwine.com/v2/trading/bordeauxCode/${bordeauxCode}/offer`;

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  }
})
  .then(response => {
    if (!response.ok) {
      throw new Error(`Request failed with status ${response.status}`);
    }
    return response.json();
  })
  .then(data => {
    if ("quantityMatched" in data) {
      console.log("quantityMatched:", data.quantityMatched);
    } else {
      console.log("quantityMatched not found in response");
    }
  })
  .catch(error => {
    console.error("Error:", error.message);
  });


                                
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

import org.json.JSONObject;

public class QuantityMatchedFetcher {

    public static void main(String[] args) {
        String bordeauxCode = "12345"; // Replace with actual bordeauxCode
        String token = "YOUR_JWT_TOKEN_HERE";

        String url = String.format("https://uat-api.biwine.com/v2/trading/bordeauxCode/%s/offer", bordeauxCode);

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer " + token)
            .header("Content-Type", "application/json")
            .GET()
            .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                JSONObject json = new JSONObject(response.body());

                if (json.has("quantityMatched")) {
                    int quantityMatched = json.getInt("quantityMatched");
                    System.out.println("quantityMatched: " + quantityMatched);
                } else {
                    System.out.println("quantityMatched not found in response.");
                }
            } else {
                System.out.println("Request failed with status code: " + response.statusCode());
            }

        } catch (Exception e) {
            System.out.println("Error during HTTP request:");
            e.printStackTrace();
        }
    }
}

This endpoint allows you to delete a bid using the orderId. The code bellow deletes a bid and checks if the status is 200 (OK).


                                
import requests

orderId = "12345"  # Replace with actual orderId
auth_token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVC..."

url = f"https://uat-api.biwine.com/v2/trading/bid/{orderId}"
headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

try:
    response = requests.delete(url, headers=headers)
    
    if response.status_code == 200:
        print("Delete request successful.")
    else:
        print(f"Delete request failed with status code: {response.status_code}")

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)


                                
const orderId = "12345"; // Replace with actual orderId
const token = "YOUR_JWT_TOKEN_HERE";

const url = `https://uat-api.biwine.com/v2/trading/bid/${orderId}`;

fetch(url, {
  method: "DELETE",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  }
})
.then(response => {
  if (response.status === 200) {
    console.log("Delete request successful.");
  } else {
    console.log(`Delete request failed with status code: ${response.status}`);
  }
})
.catch(error => {
  console.error("Error:", error.message);
});


                                
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class DeleteOrder {

    public static void main(String[] args) {
        String orderId = "12345"; // Replace with actual orderId
        String token = "YOUR_JWT_TOKEN_HERE";

        String url = String.format("https://uat-api.biwine.com/v2/trading/bid/%s", orderId);

        HttpClient client = HttpClient.newHttpClient();

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer " + token)
            .header("Content-Type", "application/json")
            .DELETE()
            .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                System.out.println("Delete request successful.");
            } else {
                System.out.println("Delete request failed with status code: " + response.statusCode());
            }
        } catch (Exception e) {
            System.out.println("Error during HTTP request:");
            e.printStackTrace();
        }
    }
}

This endpoint allows you to delete a offer using the orderId. The code bellow deletes a bid and checks if the status is 200 (OK).


                                
import requests

orderId = "12345"  # Replace with your actual orderId
auth_token = "YOUR_JWT_TOKEN_HERE"

url = f"https://uat-api.biwine.com/v2/trading/offer/{orderId}"
headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

try:
    response = requests.delete(url, headers=headers)

    if response.status_code == 200:
        print("Delete request successful.")
    else:
        print(f"Delete request failed with status code: {response.status_code}")

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)


                                
const orderId = "12345"; // Replace with actual orderId
const token = "YOUR_JWT_TOKEN_HERE";

const url = `https://uat-api.biwine.com/v2/trading/offer/${orderId}`;

fetch(url, {
  method: "DELETE",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  }
})
.then(response => {
  if (response.status === 200) {
    console.log("Delete request successful.");
  } else {
    console.log(`Delete request failed with status code: ${response.status}`);
  }
})
.catch(error => {
  console.error("Error:", error.message);
});


                                
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class DeleteOffer {

    public static void main(String[] args) {
        String orderId = "12345"; // Replace with actual orderId
        String token = "YOUR_JWT_TOKEN_HERE";

        String url = String.format("https://uat-api.biwine.com/v2/trading/offer/%s", orderId);

        HttpClient client = HttpClient.newHttpClient();

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer " + token)
            .header("Content-Type", "application/json")
            .DELETE()
            .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                System.out.println("Delete request successful.");
            } else {
                System.out.println("Delete request failed with status code: " + response.statusCode());
            }
        } catch (Exception e) {
            System.out.println("Error during HTTP request:");
            e.printStackTrace();
        }
    }
}

This endpoint allows you to modify an existing trading bid using an orderId. The body of the request should include the updated details, such as price or quantity. Below is the code to access the endpoint, change quantity and print the updated order's status.


                                
import requests

orderId = "12345"  # Replace with actual orderId
auth_token = "YOUR_JWT_TOKEN_HERE"

url = f"https://uat-api.biwine.com/v2/trading/bid/{orderId}"
headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

data = {
    "quantity": 3
}

try:
    response = requests.patch(url, headers=headers, json=data)

    if response.status_code == 200:
        print("Patch request successful.")
    else:
        print(f"Patch request failed with status code: {response.status_code}")

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)


                                
const orderId = "12345"; // Replace with actual orderId
const token = "YOUR_JWT_TOKEN_HERE";

const url = `https://uat-api.biwine.com/v2/trading/bid/${orderId}`;

fetch(url, {
  method: "PATCH",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ quantity: 3 })
})
.then(response => {
  if (response.status === 200) {
    console.log("PATCH request successful.");
  } else {
    console.log("PATCH failed with status code:", response.status);
  }
})
.catch(error => {
  console.error("Request error:", error.message);
});


                                
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpRequest.BodyPublishers;

public class PatchBidQuantity {

    public static void main(String[] args) {
        String orderId = "12345"; // Replace with actual orderId
        String token = "YOUR_JWT_TOKEN_HERE";

        String url = String.format("https://uat-api.biwine.com/v2/trading/bid/%s", orderId);
        String jsonBody = "{\"quantity\": 3}";

        HttpClient client = HttpClient.newHttpClient();

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Authorization", "Bearer " + token)
                .header("Content-Type", "application/json")
                .method("PATCH", BodyPublishers.ofString(jsonBody))
                .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                System.out.println("PATCH request successful.");
            } else {
                System.out.println("PATCH failed with status code: " + response.statusCode());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

This endpoint allows you to modify an existing trading offer using an orderId. The body of the request should include the updated details, such as price or quantity. Below is the code to access the endpoint, change price and print the updated order's status.


                                
import requests

order_id = "12345"  # Replace with actual orderId
auth_token = "YOUR_JWT_TOKEN_HERE"

url = f"https://uat-api.biwine.com/v2/trading/offer/{order_id}"
headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

payload = {
    "quantity": 6
}

try:
    response = requests.patch(url, headers=headers, json=payload)

    if response.status_code == 200:
        print("PATCH request successful.")
    else:
        print(f"PATCH failed with status code: {response.status_code}")
        print("Response:", response.text)

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)


                                
const orderId = "12345"; // Replace with actual order ID
const token = "YOUR_JWT_TOKEN_HERE";
const url = `https://uat-api.biwine.com/v2/trading/offer/${orderId}`;

fetch(url, {
  method: "PATCH",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ quantity: 6 })
})
.then(response => {
  if (response.status === 200) {
    console.log("PATCH request successful.");
  } else {
    console.log("PATCH failed with status:", response.status);
  }
})
.catch(error => {
  console.error("Request error:", error);
});


                                
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpRequest.BodyPublishers;

public class PatchOfferQuantity {

    public static void main(String[] args) {
        String orderId = "12345"; // Replace with actual order ID
        String token = "YOUR_JWT_TOKEN_HERE";
        String url = "https://uat-api.biwine.com/v2/trading/offer/" + orderId;

        String jsonBody = "{\"quantity\": 6}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Authorization", "Bearer " + token)
                .header("Content-Type", "application/json")
                .method("PATCH", BodyPublishers.ofString(jsonBody))
                .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                System.out.println("PATCH request successful.");
            } else {
                System.out.println("PATCH failed with status code: " + response.statusCode());
                System.out.println("Response body: " + response.body());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

This endpoint allows submit a new offer to the market using the portfolioRef. The body of the request should include the details of the offer, such as price and quantity, as any offer would. The code below demonstrates how to access the endpoint and prints if the request was sucessful.


                                    
import requests

portfolio_ref = "ST_1234_12"  # Replace with actual portfolioRef
auth_token = "YOUR_JWT_TOKEN_HERE"

url = f"https://uat-api.biwine.com/v2/trading/portfolioRef/{portfolio_ref}/offer"
headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

payload = {
    "price": 600
}

try:
    response = requests.post(url, headers=headers, json=payload)

    if response.status_code == 200:
        print("POST request successful.")
        print("Response:", response.json())
    else:
        print(f"POST failed with status code: {response.status_code}")
        print("Response:", response.text)

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)


                                    
const portfolioRef = "ST_1234_12"; // Replace with actual portfolioRef
const token = "YOUR_JWT_TOKEN_HERE";
const url = `https://uat-api.biwine.com/v2/trading/portfolioRef/${portfolioRef}/offer`;

fetch(url, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ price: 600 })
})
.then(response => {
  if (response.status === 200) {
    console.log("POST request successful.");
    return response.json();
  } else {
    console.log("POST failed with status:", response.status);
    return response.text();
  }
})
.then(data => console.log("Response:", data))
.catch(error => {
  console.error("Request error:", error);
});


                                    
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpRequest.BodyPublishers;

public class PostOfferByPortfolioRef {

    public static void main(String[] args) {
        String portfolioRef = "ST_1234_12"; // Replace with actual portfolioRef
        String token = "YOUR_JWT_TOKEN_HERE";
        String url = "https://uat-api.biwine.com/v2/trading/portfolioRef/" + portfolioRef + "/offer";

        String jsonBody = "{\"price\": 600}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Authorization", "Bearer " + token)
                .header("Content-Type", "application/json")
                .POST(BodyPublishers.ofString(jsonBody))
                .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                System.out.println("POST request successful.");
                System.out.println("Response body: " + response.body());
            } else {
                System.out.println("POST failed with status code: " + response.statusCode());
                System.out.println("Response: " + response.body());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

The post trade routes allow you to view your trades once matched and removed from the marketplace.

This endpoint allows you to retrieve a list of all YOUR post-trade activities, such as completed trades and settlements. The response includes details like trade ID, wine details, and settlement status. Below is the code to access the endpoint and print the trade IDs. The in-query parameters page and limit are supported and default to 0 and 50 respectively, and additionally you can filter your super-set by using optional fromDate and toDate parameters which should be in yyyy-MM-dd format, note that fromDate is required if toDate is used.


                                
import requests

auth_token = "YOUR_JWT_TOKEN_HERE"
page = 1  # Replace with desired page number

url = "https://uat-api.biwine.com/v2/postTrade"
headers = {
    "Authorization": f"Bearer {auth_token}"
}
params = {
    "page": page
}

try:
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()

    data = response.json()
    results = data.get("results", [])

    if results:
        for item in results:
            quantity = item.get("quantity")
            print("Quantity:", quantity)
    else:
        print("No results found.")

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)
except ValueError:
    print("Invalid JSON response")


                                
const token = "YOUR_JWT_TOKEN_HERE";
const page = 1; // Replace with desired page number
const url = `https://uat-api.biwine.com/v2/postTrade?page=${page}`;

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`
  }
})
.then(response => {
  if (response.status === 200) {
    return response.json();
  } else {
    console.log("GET failed with status:", response.status);
    return null;
  }
})
.then(data => {
  if (data && Array.isArray(data.results)) {
    data.results.forEach(item => {
      console.log("Quantity:", item.quantity);
    });
  } else {
    console.log("No results found.");
  }
})
.catch(error => {
  console.error("Request failed:", error);
});


                                
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;

public class GetPostTrade {

    public static void main(String[] args) {
        String token = "YOUR_JWT_TOKEN_HERE";
        int page = 1; // replace with desired page number
        String url = "https://uat-api.biwine.com/v2/postTrade?page=" + page;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Authorization", "Bearer " + token)
                .GET()
                .build();

        try {
            HttpResponse<String> response = client.send(request, BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                ObjectMapper mapper = new ObjectMapper();
                JsonNode rootNode = mapper.readTree(response.body());

                JsonNode results = rootNode.path("results");
                if (results.isArray()) {
                    for (JsonNode item : results) {
                        int quantity = item.path("quantity").asInt();
                        System.out.println("Quantity: " + quantity);
                    }
                } else {
                    System.out.println("No results found.");
                }
            } else {
                System.out.println("GET failed with status code: " + response.statusCode());
                System.out.println("Response body: " + response.body());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

This endpoint allows you to retrieve the current foreign exchange rates for supported currencies. The response includes details like currency pairs and their exchange rates. Below is the code to access the endpoint and print the exchange rates. The manadatory in-query parameters from and to are necessary and possible values are USD, GBP, EUR, HKD, CHF, SGD, AUD, CAD, JPY, DKK and NZD.


                                    
import requests

auth_token = "YOUR_JWT_TOKEN_HERE"
url = "https://uat-api.biwine.com/v2/fxRate"
params = {
    "from": "GBP",
    "to": "EUR"
}
headers = {
    "Authorization": f"Bearer {auth_token}"
}

try:
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()

    data = response.json()
    rate = data.get("rate")

    if rate is not None:
        print(f"Exchange rate from GBP to EUR: {rate}")
    else:
        print("Rate not found in response.")

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)
except ValueError:
    print("Invalid JSON response")


                                    
const token = "YOUR_JWT_TOKEN_HERE";
const url = "https://uat-api.biwine.com/v2/fxRate?from=GBP&to=EUR";

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`
  }
})
.then(response => {
  if (response.ok) {
    return response.json();
  } else {
    console.error("Request failed with status:", response.status);
    return null;
  }
})
.then(data => {
  if (data && data.rate !== undefined) {
    console.log(`Exchange rate from GBP to EUR: ${data.rate}`);
  } else {
    console.log("Rate not found in response.");
  }
})
.catch(error => {
  console.error("Request error:", error);
});


                                    
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;

public class FxRateRequest {
    public static void main(String[] args) {
        String token = "YOUR_JWT_TOKEN_HERE";
        String url = "https://uat-api.biwine.com/v2/fxRate?from=GBP&to=EUR";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Authorization", "Bearer " + token)
                .GET()
                .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                ObjectMapper mapper = new ObjectMapper();
                JsonNode root = mapper.readTree(response.body());

                if (root.has("rate")) {
                    double rate = root.get("rate").asDouble();
                    System.out.println("Exchange rate from GBP to EUR: " + rate);
                } else {
                    System.out.println("Rate not found in response.");
                }
            } else {
                System.out.println("Request failed with status code: " + response.statusCode());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

This endpoint allows you to retrieve your Bordeaux Index portfolio. The in-query parameters page and limit are supported and default to 0 and 50 respectively.


                                    
import requests

# Replace with your actual Bearer token
auth_token = "YOUR_JWT_TOKEN_HERE"

url = "https://uat-api.biwine.com/v2/portfolio"
headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()
    
    data = response.json()
    results = data.get("results", [])
    
    if results:
        for wine in results:
            print("Product Name:", wine.get("productName", "N/A"))
    else:
        print("No results found.")

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)
except ValueError:
    print("Invalid JSON response")


                                    
const fetch = require('node-fetch'); // If using Node.js; not needed in browsers

const token = 'YOUR_JWT_TOKEN_HERE';
const url = 'https://uat-api.biwine.com/v2/portfolio';

fetch(url, {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  }
})
  .then(response => {
    if (!response.ok) {
      throw new Error(`HTTP error! Status: ${response.status}`);
    }
    return response.json();
  })
  .then(data => {
    if (Array.isArray(data.results)) {
      data.results.forEach(item => {
        console.log('Product Name:', item.productName || 'N/A');
      });
    } else {
      console.log('No results found.');
    }
  })
  .catch(error => {
    console.error('Request failed:', error.message);
  });


                                    
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import org.json.JSONArray;
import org.json.JSONObject;

public class PortfolioProductNames {
    public static void main(String[] args) {
        String token = "YOUR_JWT_TOKEN_HERE";
        String urlString = "https://uat-api.biwine.com/v2/portfolio";

        try {
            URL url = new URL(urlString);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();

            conn.setRequestMethod("GET");
            conn.setRequestProperty("Authorization", "Bearer " + token);
            conn.setRequestProperty("Content-Type", "application/json");

            int responseCode = conn.getResponseCode();

            if (responseCode == HttpURLConnection.HTTP_OK) {
                BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
                StringBuilder responseBuffer = new StringBuilder();
                String line;
                while ((line = reader.readLine()) != null) {
                    responseBuffer.append(line);
                }
                reader.close();

                JSONObject jsonResponse = new JSONObject(responseBuffer.toString());
                JSONArray results = jsonResponse.getJSONArray("results");

                for (int i = 0; i < results.length(); i++) {
                    JSONObject wine = results.getJSONObject(i);
                    String productName = wine.optString("productName", "N/A");
                    System.out.println("Product Name: " + productName);
                }
            } else {
                System.out.println("GET request failed. HTTP code: " + responseCode);
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

This endpoint allows you to view a single item in your portfolio. The optional in-query parameter marketDepth to specify the depth of the market data to be returned, which defaults to all if not sent.


                                    
import requests

portfolio_ref = "ST_1234_3"  # Replace with actual portfolioRef
auth_token = "YOUR_JWT_TOKEN_HERE"

url = f"https://uat-api.biwine.com/v2/portfolio/{portfolio_ref}"
headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

try:
    response = requests.get(url, headers=headers)
    response.raise_for_status()

    data = response.json()

    product_name = data.get("productName")
    if product_name:
        print("Product Name:", product_name)
    else:
        print("productName not found in response.")

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)
except ValueError:
    print("Invalid JSON response")


                                    
const fetch = require('node-fetch'); // Only required in Node.js

const portfolioRef = 'ST_1234_3'; // Replace with actual portfolioRef
const authToken = 'YOUR_JWT_TOKEN_HERE';

const url = `https://uat-api.biwine.com/v2/portfolio/${portfolioRef}`;

fetch(url, {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${authToken}`,
    'Content-Type': 'application/json'
  }
})
.then(response => {
  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }
  return response.json();
})
.then(data => {
  if (data.productName) {
    console.log('Product Name:', data.productName);
  } else {
    console.log('productName not found in response.');
  }
})
.catch(error => {
  console.error('Request failed:', error.message);
});


                                    
import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

import org.json.JSONObject;

public class PortfolioFetcher {
    public static void main(String[] args) {
        String portfolioRef = "ST_1234_3"; // Replace with actual portfolioRef
        String authToken = "YOUR_JWT_TOKEN_HERE";

        String url = "https://uat-api.biwine.com/v2/portfolio/" + portfolioRef;

        HttpClient client = HttpClient.newHttpClient();

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer " + authToken)
            .header("Content-Type", "application/json")
            .GET()
            .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() == 200) {
                JSONObject json = new JSONObject(response.body());
                if (json.has("productName")) {
                    String productName = json.getString("productName");
                    System.out.println("Product Name: " + productName);
                } else {
                    System.out.println("productName not found in response.");
                }
            } else {
                System.out.println("HTTP request failed with status code: " + response.statusCode());
            }

        } catch (IOException | InterruptedException e) {
            e.printStackTrace();
        }
    }
}

Webhooks are automated messages sent from our server when a specific event occurs. They allow your application to receive real-time updates by providing a URL endpoint that our API can call with event data. Unlike traditional polling, webhooks are event-driven and trigger immediately when the specified event happens, such as when a trade occurs when one of your bids or offers matches. To use webhooks, simply register your endpoint URL and configure which events you want to subscribe to.

import requests

auth_token = "YOUR_JWT_TOKEN_HERE"

url = f"https://uat-api.biwine.com/v2/webhooks"

headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

params = {}

try:
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    
    data = response.json()
    results = data.get("results", [])

    for item in results:
        url = item.get("url")
        if url:
            print("url:", url)

except requests.exceptions.RequestException as e:
    print("HTTP Request failed:", e)
except ValueError:
    print("Invalid JSON response")

// If using Node.js, ensure you're on v18+ or install 'node-fetch':
// const fetch = require('node-fetch');

const authToken = "YOUR_JWT_TOKEN_HERE";
const url = "https://uat-api.biwine.com/v2/webhooks";

fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${authToken}`,
    "Content-Type": "application/json"
  }
})
  .then(async (response) => {
    if (!response.ok) {
      const errorText = await response.text();
      console.error(`Request failed with status code ${response.status}: ${errorText}`);
      return;
    }

    const data = await response.json();
    const results = data.results || [];

    results.forEach(item => {
      const url = item.url;
      if (url) {
        console.log("url:", url);
      }
    });
  })
  .catch(error => {
    console.error("HTTP Request failed:", error.message);
  });

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

import org.json.JSONArray;
import org.json.JSONObject;

public class WebhookFetcher {
    public static void main(String[] args) {
        String authToken = "YOUR_JWT_TOKEN_HERE";
        String url = "https://uat-api.biwine.com/v2/webhooks";

        try {
            // Build GET request
            HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create(url))
                    .header("Authorization", "Bearer " + authToken)
                    .header("Content-Type", "application/json")
                    .GET()
                    .build();

            // Send request
            HttpClient client = HttpClient.newHttpClient();
            HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());

            // Check status
            if (response.statusCode() == 200) {
                JSONObject data = new JSONObject(response.body());
                JSONArray results = data.optJSONArray("results");

                if (results != null) {
                    for (int i = 0; i < results.length(); i++) {
                        JSONObject item = results.getJSONObject(i);
                        String url = item.optString("url", null);
                        if (url != null) {
                            System.out.println("url: " + url);
                        }
                    }
                }
            } else {
                System.out.println("Request failed with status code " + response.statusCode() + ": " + response.body());
            }

        } catch (Exception e) {
            System.out.println("HTTP Request failed: " + e.getMessage());
        }
    }
}


import requests

# API endpoint
url = "https://uat-api.biwine.com/v2/webhooks"

# Request payload
payload = {
    "url": "https://example.com/callback",
    "webhookEventType": "TRADE",
    "keyName": "ApiKey",  # Optional key to authenticate the webhook on your server
    "keyValue": "ABC123"
}

# Replace with a valid Bearer token or other auth if required
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_TOKEN"  # Replace with actual token
}

# Send POST request
response = requests.post(url, json=payload, headers=headers)

# Process response
if response.status_code == 200:
    try:
        data = response.json()
        print("webhookId:", data.get("webhookId"))
    except ValueError:
        print("Failed to decode JSON response")
else:
    print(f"Request failed with status code {response.status_code}: {response.text}")


// If using Node.js, install node-fetch first:
// npm install node-fetch
// Then uncomment the following line:
// const fetch = require('node-fetch');

// API endpoint
const url = 'https://uat-api.biwine.com/v2/webhooks';

// Request payload
const payload = {
  url: 'https://example.com/callback',
  webhookEventType: 'TRADE',
  keyName: 'ApiKey', // Optional key to authenticate the webhook on your server
  keyValue: 'ABC123'
};

// Replace with your actual Bearer token
const token = 'YOUR_API_TOKEN';

// Send POST request
fetch(url, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`
  },
  body: JSON.stringify(payload)
})
  .then(async (response) => {
    if (response.ok) {
      const data = await response.json();
      console.log('webhookId:', data.webhookId);
    } else {
      const errorText = await response.text();
      console.error(`Request failed with status code ${response.status}: ${errorText}`);
    }
  })
  .catch((error) => {
    console.error('Error:', error);
  });


import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

import org.json.JSONObject;

public class WebhookSender {
    public static void main(String[] args) {
        try {
            String apiUrl = "https://uat-api.biwine.com/v2/webhooks";
            String bearerToken = "YOUR_API_TOKEN"; // Replace with actual token

            // Build the JSON payload
            JSONObject payload = new JSONObject();
            payload.put("url", "https://example.com/callback");
            payload.put("webhookEventType", "TRADE");
            payload.put("keyName", "ApiKey");  // Optional key to authenticate the webhook on your server
            payload.put("keyValue", "ABC123");

            // Create HTTP request
            HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create(apiUrl))
                    .header("Content-Type", "application/json")
                    .header("Authorization", "Bearer " + bearerToken)
                    .POST(HttpRequest.BodyPublishers.ofString(payload.toString()))
                    .build();

            // Send request
            HttpClient client = HttpClient.newHttpClient();
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

            // Process response
            if (response.statusCode() == 200) {
                try {
                    JSONObject responseBody = new JSONObject(response.body());
                    System.out.println("webhookId: " + responseBody.optString("webhookId"));
                } catch (Exception e) {
                    System.out.println("Failed to parse JSON response");
                }
            } else {
                System.out.println("Request failed with status code " + response.statusCode() + ": " + response.body());
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

import requests

webhookId = "12345"  # Replace with actual webhookId
auth_token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVC..."

url = f"https://uat-api.biwine.com/v2/webhooks/{webhookId}"
headers = {
    "Authorization": f"Bearer {auth_token}",
    "Content-Type": "application/json"
}

try:
    response = requests.delete(url, headers=headers)
    
    if response.status_code == 200:
        print("Delete request successful.")
    else:
        print(f"Delete request failed with status code: {response.status_code}")

except requests.exceptions.RequestException as e:
    print("HTTP request failed:", e)

// If using Node.js and running on v18+, no need to import fetch
// For earlier Node versions, uncomment and install node-fetch:
// const fetch = require('node-fetch');

const webhookId = "12345"; // Replace with actual webhookId
const authToken = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVC..."; // Replace with actual JWT token

const url = `https://uat-api.biwine.com/v2/webhooks/${webhookId}`;

fetch(url, {
  method: "DELETE",
  headers: {
    "Authorization": `Bearer ${authToken}`,
    "Content-Type": "application/json"
  }
})
  .then(async (response) => {
    if (response.ok) {
      console.log("Delete request successful.");
    } else {
      const errorText = await response.text();
      console.error(`Delete request failed with status code: ${response.status}`);
      console.error("Response body:", errorText);
    }
  })
  .catch(error => {
    console.error("HTTP request failed:", error.message);
  });

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class WebhookDeleter {
    public static void main(String[] args) {
        String webhookId = "12345"; // Replace with actual webhookId
        String authToken = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVC..."; // Replace with actual JWT token

        String url = "https://uat-api.biwine.com/v2/webhooks/" + webhookId;

        try {
            // Build the DELETE request
            HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create(url))
                    .header("Authorization", "Bearer " + authToken)
                    .header("Content-Type", "application/json")
                    .DELETE()
                    .build();

            // Send request
            HttpClient client = HttpClient.newHttpClient();
            HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());

            // Check response
            if (response.statusCode() == 200) {
                System.out.println("Delete request successful.");
            } else {
                System.out.println("Delete request failed with status code: " + response.statusCode());
                System.out.println("Response body: " + response.body());
            }

        } catch (Exception e) {
            System.out.println("HTTP request failed: " + e.getMessage());
        }
    }
}

Last updated 13 August 2025

Developer Hub

Versioning

Proccess

API Routes & Code Samples

My Basket

Search

BI Bin-Ends

Whistlepig Encyclopedia of Rye Volume Two - Discover the Latest Release

The Best Trading Platform: Why Choose LiveTrade

Why Storing With Bordeaux Index Adds Value to Your Collection

Developer Hub

Versioning

Proccess

API Routes & Code Samples

My Basket

Our Cookies