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

1. Request Initiation: Users send parlay quote requests to the ProphetX backend.
2. Broadcast: ProphetX broadcasts these requests to SPs via WebSocket.
3. Callback: SPs confirm prices through this RESTful API endpoint.
4. 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.

Headers

• Authorization: Bearer token required.

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": [
    {
      "calculated_price": 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