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,
        "updatedAt": "2026-02-07T17:29:32+00:00"
      }
    }
  ],
  "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": []
    }
  ]
}

Orders

Place betting orders

Submit one or more betting orders for placement with bookmakers.

Required fields per order: requestUuid, outcomeId, playerId, orderPrice, orderStake, userRef, testOrder, and either fixtureId (fixture markets) or futureId (futures/outright markets — coming soon)

Optional fields: bookmakers, participantId (futures only), orderCurrency, back, expiresAt, acceptBetterOdds, acceptPartialStake, meta

Key behavior:

requestUuid must be a valid UUID format (used for idempotency — a duplicate within 30 minutes is skipped; if ALL orders in the request are duplicates the request returns 409)
fixtureId and futureId are mutually exclusive — provide one or the other
Orders with futureId currently return 501 Not Implemented (coming soon)
Server automatically selects the best bookmaker by odds/limits unless bookmakers is specified
clientName is set automatically from your API key
Orders expire after expiresAt (default: 5 seconds from now, capped at 24 hours maximum)
Maximum 100 orders per request

Response:

status: “accepted” (all accepted), “partial-success” (some declined), or “declined” (all declined)
acceptedOrders: Orders that passed validation with their current status and any placed bets
declinedOrders: Orders that failed validation with declineReason

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,
        "updatedAt": "2026-02-07T17:29:32+00:00"
      }
    }
  ],
  "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

Show child attributes

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

Get orders Cancel specific orders