Place Orders

Endpoint

POST /api/v1/orders

Description

This endpoint allows you to place new orders. It requires a valid Bearer Token for authentication and a JSON request body containing the order details.

Request

Headers
- Authorization: Bearer Token (required)
Request Body
- Content-Type: application/json
- Schema: handlers.PlaceOrdersRequest

Responses

200 OK
- The order was successfully placed.
- Schema: handlers.PlaceOrdersResponse
400 Bad Request
- The request was invalid. Check the error message for details.
- Schema: types.ErrorResponse
401 Unauthorized
- Authentication failed. Ensure your Bearer Token is valid.
- Schema: types.ErrorResponse
500 Internal Server Error
- An error occurred on the server. Try again later.
- Schema: types.ErrorResponse

Example Request

{
  "data": [
    {
      "external_id": "string",
      "external_user_id": "string",
      "line_id": "string",
      "odds": 1.5,
      "stake": 100
    }
  ]
}

Example Response

{
  "success": true,
  "data": {
    "succeed_orders": [
      {
        "external_id": "string",
        "external_user_id": "string",
        "id": "string",
        "line": 1.5,
        "line_id": "string",
        "market_id": 123,
        "matched_stake": 100,
        "matching_status": "fully_matched",
        "odds": 1.5,
        "outcome_id": 456,
        "profit": 50,
        "sport_event_id": 789,
        "stake": 100,
        "status": "open",
        "unmatched_stake": 0,
        "user_id": "string",
        "winning_status": "tbd"
      }
    ],
    "failed_orders": []
  }
}

Notes

Ensure all required fields are included in the request body.
The odds and stake must be valid numbers.
Check the response for any failed orders and their respective error messages.