Get Balance

The Get Balance endpoint allows you to retrieve the current balance of a user's wallet. This includes the total balance, matched wager balance, and unmatched wager balance. It is a crucial endpoint for applications that need to display or manage user funds.

Endpoint

URL: /mm/get_balance
Method: GET
Security: Requires a valid Bearer Token in the Authorization header.

Description

This endpoint is used to fetch the balance details of a user. It provides a comprehensive view of the user's financial status within the application, including:

Total Balance: The overall amount available in the user's wallet.
Matched Wager Balance: Funds that are currently tied up in matched wagers.
Unmatched Wager Balance: Funds that are reserved for wagers that have not yet been matched.

Responses

200 OK: Returns the balance details in JSON format.
400 Bad Request: Indicates a problem with the request, such as missing or invalid parameters.
401 Unauthorized: The request lacks valid authentication credentials.
500 Internal Server Error: An error occurred on the server side.

Example Request

GET /mm/get_balance HTTP/1.1
Host: api-ss-sandbox.betprophet.co
Authorization: Bearer YOUR_ACCESS_TOKEN

Example Response

{
  "data": {
    "balance": 1000.00,
    "matched_wager_balance": 200.00,
    "unmatched_wager_balance": 50.00
  },
  "success": true
}

This endpoint is part of the wallet management features and is tagged under wallet. It is essential for tracking and managing user funds effectively.