Price Confirmation Callback

Overview

The Price Confirmation Callback endpoint is part of the ProphetX API, designed to handle price confirmations for parlay bets. This process ensures that the agreed-upon prices are confirmed with the Service Providers (SPs) before finalizing the order.

Workflow

Request Initiation: Users send parlay quote requests to the ProphetX backend.
Broadcast: ProphetX broadcasts these requests to SPs via WebSocket.
Callback: SPs confirm prices through this RESTful API endpoint.
Finalization: Upon confirmation, an order.finalized message is sent to confirm execution.

Endpoint Details

URL: /orders/confirmations
Method: POST
Security: Requires a valid token in the header.

Request Body

action: "accept" or "reject"
confirmed_odds: The odds confirmed by the SP.
confirmed_stake: The stake amount confirmed (optional).
order_uuid: Unique identifier for the order.
price_probability: Array of price probability details.
signature: Digital signature for verification.

Response

200 OK: Confirmation received successfully.
Default: Error response with details.

Example Payload

{
  "action": "accept",
  "confirmed_odds": 1.5,
  "confirmed_stake": 100.0,
  "order_uuid": "123e4567-e89b-12d3-a456-426614174000",
  "price_probability": [
    {
      "computed_odds": 1.5,
      "lines": [
        {"line_id": "line_1", "probability": 0.5},
        {"line_id": "line_2", "probability": 0.4}
      ],
      "max_risk": 200.0,
      "vig": 0.1
    }
  ],
  "signature": "abc123signature"
}

Additional Resources

ProphetX Parlay Price Quoting/Confirmation Integration