Skip to main content
POST
/
place-orders
Place betting orders
curl --request POST \
  --url https://v2.55-tech.com/place-orders \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "orders": [
    {
      "requestUuid": "eb45b192-317b-42d5-9f65-af497b9fa8c1",
      "fixtureId": "id1000004461512432",
      "outcomeId": 103,
      "playerId": 0,
      "orderPrice": 1.95,
      "orderStake": 10,
      "userRef": "bettor1234",
      "testOrder": false
    },
    {
      "requestUuid": "fb5f2dd9-c855-4ba9-8ef9-4c2278ca2f1d",
      "fixtureId": "id1000000758265385",
      "outcomeId": 101,
      "playerId": 0,
      "orderPrice": 1.88,
      "orderStake": 250.25,
      "userRef": "bettor1234",
      "testOrder": false,
      "bookmakers": "pinnacle,vertex",
      "orderCurrency": "USD",
      "back": true,
      "expiresAt": "2026-02-07T22:26:05Z",
      "acceptBetterOdds": true,
      "acceptPartialStake": true,
      "meta": {
        "strategy": "value",
        "source": "api"
      }
    }
  ]
}
'
{
  "status": "partial-success",
  "acceptedOrders": [
    {
      "orderId": 327,
      "requestUuid": "eb45b192-317b-42d5-9f65-af497b9fa8c1",
      "allowedBookmakers": "*",
      "fixtureId": "id1000004461512432",
      "outcomeId": 103,
      "playerId": 0,
      "orderPrice": 1.95,
      "orderStake": 10,
      "filledStake": 10,
      "userRef": "bettor1234",
      "testOrder": false,
      "orderCurrency": "USD",
      "back": true,
      "expiresAt": "2026-02-07T17:29:37.311377+00:00",
      "acceptBetterOdds": true,
      "acceptPartialStake": true,
      "clientName": "demo",
      "orderStatus": "FILLED",
      "createdAt": "2026-02-07T17:29:32.265368+00:00",
      "updatedAt": "2026-02-07T17:29:32.265368+00:00",
      "meta": null,
      "bets": [
        {
          "betId": 73,
          "orderId": 327,
          "bookmaker": "pinnacle",
          "bookmakerBetId": "3332684214",
          "placedPrice": 1.98,
          "placedStake": 10,
          "placedCurrency": "USD",
          "placedAt": "2026-02-07T17:29:32+00:00",
          "betStatus": "CONFIRMED",
          "settlementStatus": "UNSETTLED",
          "clientName": "demo",
          "testBet": false,
          "userRef": "bettor1234",
          "requestUuid": "eb45b192-317b-42d5-9f65-af497b9fa8c1",
          "declineReason": null
        }
      ],
      "fixtureInfo": {
        "fixtureId": "id1000004461512432",
        "status": {
          "live": false,
          "statusId": 0,
          "statusName": "Pre-Game"
        },
        "sport": {
          "sportId": 10,
          "sportName": "Soccer"
        },
        "tournament": {
          "tournamentId": 44,
          "tournamentName": "2. Bundesliga",
          "categoryName": "Germany"
        },
        "startTime": 1754159400,
        "participants": {
          "participant1Id": 2540,
          "participant1Name": "Arminia Bielefeld",
          "participant2Id": 2588,
          "participant2Name": "Fortuna Dusseldorf"
        }
      },
      "outcomeInfo": {
        "marketId": 101,
        "marketName": "Full Time Result",
        "marketNameShort": "1X2",
        "marketType": "1x2",
        "period": "fulltime",
        "playerProp": false,
        "handicap": 0,
        "outcomeId": 103,
        "outcomeName": "2"
      },
      "playerInfo": null,
      "currencyInfo": {
        "currency": "USD",
        "currencyValue": 1
      }
    }
  ],
  "declinedOrders": [
    {
      "requestUuid": "fb5f2dd9-c855-4ba9-8ef9-4c2278ca2f1d",
      "allowedBookmakers": "vertex",
      "fixtureId": "id1000004461512432",
      "outcomeId": 103,
      "playerId": 0,
      "orderPrice": 1.95,
      "orderStake": 10,
      "userRef": "bettor1234",
      "testOrder": false,
      "orderCurrency": "USD",
      "back": true,
      "clientName": "demo",
      "declineReason": "Odds temporarily unavailable; please retry",
      "bets": []
    }
  ]
}

Authorizations

X-API-Key
string
header
required

API key for authentication. Contact contact@55-tech.com to obtain a key.

Body

application/json
orders
object[]
required

List of orders to place (max 100 per request)

Required array length: 1 - 100 elements

Response

Order placement results with accepted and declined orders

status
enum<string>

Overall result: accepted (all OK), partial-success (some declined), declined (all failed)

Available options:
accepted,
partial-success,
declined
acceptedOrders
object[]

Enriched orders that passed validation

declinedOrders
object[]

Orders that failed validation with declineReason