Name: Global Lotto Draw Results API - Real-time for 65+ Countries
Brand: coolapps.mobi
SKU: api-coolapps.mobi-lotto
Availability: InStock
Author: API Market

Yong Jason

# Global Lotto Draw Results

## Overview
The Global Lotto Draw Results API provides real-time access to lottery draw results from up to 65 countries worldwide. Designed for developers and AI engineers, this robust API delivers accurate and timely data, allowing for seamless integration into applications requiring up-to-date international lottery information. Whether you're building a financial news platform, a gaming application, or a data analytics tool, this API offers a reliable source for comprehensive lottery data.

## Features
*   **Real-time Results:** Access the latest lottery draw results as soon as they are available.
*   **Extensive Coverage:** Get data from lotteries across up to 65 countries globally.
*   **Detailed Draw Information:** Retrieve winning numbers, extra numbers, multipliers, and draw IDs.
*   **Programmatic Access:** Easily discover supported regions and available games via dedicated endpoints.
*   **Reliable and Accurate Data:** Built for high availability and data integrity.

## Use Cases
*   **Financial News & Media Platforms:** Integrate real-time lotto results to enrich content, provide value to readers interested in daily draws, and drive engagement on news portals or financial data sites. Enhance user experience with immediate access to international lottery outcomes.
*   **Gaming & Betting Applications:** Power online lottery platforms or betting sites with verified, up-to-date draw results. Ensure fairness and provide immediate, accurate outcome reporting to users, facilitating payouts and game finalization.
*   **Data Analytics & Research:** Collect historical and real-time lottery data for statistical analysis, probability studies, or academic research. Identify trends, test hypotheses, and build predictive models based on comprehensive lottery datasets.
*   **Personal Finance & Tracking Tools:** Allow users of personal finance apps to track their chosen lottery numbers against official draw results automatically. Offer features like automatic win checking, personalized notifications, and historical performance tracking.

## API Documentation

### Base URL
All API requests should be made to: `https://prod.api.market/api/v1/coolapps.mobi/lotto`

### Authentication
Authentication is handled via API key. Include your API key in the request header:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Endpoints

#### GET /api/v1/coolapps.mobi/lotto/get_regions
**Summary:** List supported regions
This endpoint returns a mapping of region codes to their respective region names, indicating which countries or territories are supported by the API.

**Parameters:**
| Name | Type | In | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| `x-api-market-key` | `string` | header | Yes | API.market API Key |

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/lotto/get_regions" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
{
  "us": "United States",
  "my": "Malaysia"
}
```

#### GET /api/v1/coolapps.mobi/lotto/get_games
**Summary:** List available games by region
This endpoint provides a list of lottery games available for each supported region. Use the region codes obtained from the `/get_regions` endpoint.

**Parameters:**
| Name | Type | In | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| `x-api-market-key` | `string` | header | Yes | API.market API Key |

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/lotto/get_games" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
{
  "us": [
    "powerball",
    "megamillions"
  ],
  "my": [
    "toto",
    "magnum"
  ]
}
```

#### GET /api/v1/coolapps.mobi/lotto/get_result/{region}/{game}/{date}
**Summary:** Get a lottery draw result
This endpoint retrieves the specific draw result for a given region, game, and date.

**Parameters:**
| Name | Type | In | Required | Description | Example |
| :--- | :--- | :--- | :--- | :--- | :--- |
| `region` | `string` | path | Yes | Region code returned by GET /get_regions. | `us` |
| `game` | `string` | path | Yes | Game slug available for the region from GET /get_games. | `powerball` |
| `date` | `string` (date) | path | Yes | Draw date in ISO 8601 date format. | `2026-06-17` |
| `x-api-market-key` | `string` | header | Yes | API.market API Key | |

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/lotto/get_result/us/powerball/2026-06-17" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
{
  "date": "2026-06-17",
  "extra": [
    "12"
  ],
  "game": "powerball",
  "id": "1961",
  "multiplier": 2,
  "numbers": [
    "3",
    "26",
    "49",
    "53",
    "61"
  ],
  "region": "us"
}
```

**Example Response (404 Not Found):**
If no draw result exists for the requested region, game, and date.
```json
{
  "error": "Draw result not found"
}
```

## Status Codes
| Status Code | Description | Handling |
| :---------- | :---------- | :------- |
| `200 OK` | Request successful. The API has successfully processed the request and returned the expected data. | Parse the response body to extract the requested data. |
| `400 Bad Request` | Invalid input parameters or malformed request. This indicates an issue with the client's request, such as incorrect data format or missing required parameters. | Review your request parameters, body, and headers to ensure they comply with the API specification. |
| `401 Unauthorized` | Missing or invalid API key. Your `x-api-market-key` header is either missing or does not match a valid API key. | Ensure your API key is correctly included in the `x-api-market-key` header of your request. |
| `403 Forbidden` | Valid API key but insufficient permissions. While an API key might be present, it might lack the necessary permissions to access the requested resource. | Verify your API key's associated permissions or contact support if you believe this is an error. |
| `404 Not Found` | Resource not found. For the `/get_result` endpoint, this specifically means no draw result exists for the requested region, game, and date. For other endpoints, it might indicate an incorrect path. | Check the `region`, `game`, and `date` parameters for the `/get_result` endpoint. Ensure the URL path is correct for other endpoints. |
| `429 Too Many Requests` | Rate limit exceeded. You have sent too many requests in a given amount of time. | Implement exponential backoff or wait for the specified `Retry-After` header (if provided) before making further requests. |
| `500 Internal Server Error` | Server-side error. An unexpected error occurred on the API server. | This is typically a transient error. You may retry the request after a short delay. If the error persists, contact support. |
| `503 Service Unavailable` | Service temporarily unavailable. The server is currently unable to handle the request due to temporary overload or maintenance. | This is typically a transient error. Implement a retry mechanism with increasing delays. |

## Rate Limits
To ensure fair usage and optimal performance for all users, the Global Lotto Draw Results API implements rate limiting. If you exceed the allocated request quota within a specific timeframe, you will receive a `429 Too Many Requests` HTTP status code. To handle rate limits gracefully, it is recommended to:
*   Monitor your API usage to stay within your plan's limits.
*   Implement exponential backoff in your client code to automatically retry requests after a delay if a `429` error is encountered.
*   Look for `Retry-After` headers in the response, which may indicate how long to wait before retrying.

## Error Handling
Effective error handling is crucial for building robust applications. The Global Lotto Draw Results API provides clear error responses to help you diagnose and resolve issues.

**How to Interpret Error Responses:**
When an error occurs, the API will typically return a non-`2xx` HTTP status code along with a JSON response body containing an `error` object.

**Common Errors and How to Resolve Them:**
*   **`401 Unauthorized`**: Check that your `x-api-market-key` header is present and contains a valid API key.
*   **`403 Forbidden`**: Ensure your API key has the necessary permissions for the requested endpoint.
*   **`404 Not Found`**:
    *   For `/get_result`: Verify the `region`, `game`, and `date` path parameters. Use `/get_regions` and `/get_games` to ensure you are requesting valid identifiers.
    *   For other endpoints: Double-check the endpoint URL for typos.
*   **`400 Bad Request`**: Review the request parameters and payload against the endpoint's specification. Ensure all required parameters are provided in the correct format.

**Recommended Retry Strategies for Transient Errors:**
For transient errors such as `500 Internal Server Error` or `503 Service Unavailable`, implementing a retry mechanism with exponential backoff is recommended.
1.  **Delay:** Wait for a short period (e.g., 1 second) before the first retry.
2.  **Exponential Backoff:** For subsequent retries, increase the delay exponentially (e.g., 2s, 4s, 8s).
3.  **Jitter:** Add a small random component to the delay to prevent all clients from retrying simultaneously, which can exacerbate server load.
4.  **Max Retries:** Set a maximum number of retries or a total timeout to prevent indefinite waiting.

**Error Response Example:**
```json
{
  "error": "Draw result not found"
}
```

## Implementation Guide

### Example Code
These examples demonstrate how to authenticate and make a synchronous API request to retrieve a lottery draw result.

#### JavaScript
```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/coolapps.mobi/lotto";

/**
 * Retrieves a lottery draw result for a specific region, game, and date.
 * @param {string} region - The region code (e.g., "us").
 * @param {string} game - The game slug (e.g., "powerball").
 * @param {string} date - The draw date in ISO 8601 format (e.g., "2026-06-17").
 * @returns {Promise<object>} The lottery draw result object.
 * @throws {Error} If the API request fails or returns an error.
 */
async function getLottoDrawResult(region, game, date) {
  try {
    const url = `${baseUrl}/get_result/${region}/${game}/${date}`;
    const response = await fetch(url, {
      method: "GET",
      headers: {
        "x-api-market-key": apiKey
      }
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API error: ${response.status} ${response.statusText} - ${errorData.error}`);
    }

    const result = await response.json();
    console.log("Lotto Draw Result:", result);
    return result;
  } catch (error) {
    console.error("Error fetching lotto draw result:", error);
    throw error;
  }
}

// Example usage:
// (async () => {
//   try {
//     const result = await getLottoDrawResult("us", "powerball", "2026-06-17");
//     // Process the result
//   } catch (e) {
//     // Handle error
//   }
// })();
```

#### Python
```python
import requests
import json

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/coolapps.mobi/lotto"

def get_lotto_draw_result(region: str, game: str, date: str) -> dict:
    """
    Retrieves a lottery draw result for a specific region, game, and date.

    Args:
        region (str): The region code (e.g., "us").
        game (str): The game slug (e.g., "powerball").
        date (str): The draw date in ISO 8601 format (e.g., "2026-06-17").

    Returns:
        dict: The lottery draw result object.

    Raises:
        Exception: If the API request fails or returns an error.
    """
    headers = {
        "x-api-market-key": API_KEY
    }
    
    url = f"{BASE_URL}/get_result/{region}/{game}/{date}"
    response = requests.get(url, headers=headers)
    
    if response.status_code != 200:
        try:
            error_data = response.json()
            error_message = error_data.get("error", "Unknown error")
        except json.JSONDecodeError:
            error_message = response.text
        raise Exception(f"API error: {response.status_code} {response.reason} - {error_message}")
    
    result = response.json()
    print("Lotto Draw Result:", result)
    return result

# Example usage:
# try:
#     result = get_lotto_draw_result("us", "powerball", "2026-06-17")
#     # Process the result
# except Exception as e:
#     print(f"Failed to get result: {e}")
```

## cURL
```bash
# Example for getting a lottery draw result
curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/lotto/get_result/us/powerball/2026-06-17" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

## FAQ

**Q: What countries' lottery results are available?**

A: The API provides results for up to 65 countries. You can programmatically retrieve the full list of supported regions and their names using the `GET /get_regions` endpoint.

**Q: How often are the lottery results updated?**

A: The results are available in real-time, meaning they are updated as soon as the official draw information is released by the lottery providers.

**Q: Is historical lottery data available?**

A: Yes, you can retrieve historical draw results by specifying the desired date in ISO 8601 format (e.g., "2023-01-15") when calling the `GET /get_result/{region}/{game}/{date}` endpoint.

**Q: What happens if a lottery result is not found for a specific date?**

A: If no draw result exists for the requested `region`, `game`, and `date`, the API will return a `404 Not Found` HTTP status code with an error message indicating that the draw result was not found.

**Q: How can I find out which games are available for a specific region?**

A: You can use the `GET /get_games` endpoint. This will return a mapping of region codes to the list of game slugs available within that region.

## Contact Us
If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.

Access real-time lottery draw results for over 65 countries and numerous games worldwide. Easily retrieve historical and current lotto numbers with this compreh

Global Lotto Draw Results API - Real-time for 65+ Countries

Free