Step 1: List your accounts Check which bookmaker accounts are configured for your API key:
curl -H "x-api-key: YOUR_API_KEY" \ https://v2.55-tech.com/accounts
Response includes each account’s bookmaker, balance, priority, stake limits, and currency:
[ { "bookmaker" : "pinnacle" , "username" : "pinnacle_main" , "client" : "your-client" , "password" : "***" , "balance" : 5000.0 , "active" : true , "priority" : 10 , "maxStake" : 1000.0 , "minStake" : 5.0 , "currencyId" : "USD" , "verifyBetslip" : false , "meta" : {}, "createdAt" : "2026-01-01T00:00:00Z" , "updatedAt" : "2026-02-01T12:00:00Z" , "multiLimitAllowed" : true , "currencyInfo" : { "currency" : "USD" , "currencyValue" : 1 , "updatedAt" : "2026-02-07T17:29:32+00:00" } } ]
Step 2: Get a betslip Before placing a bet, retrieve current odds and limits. You need a fixtureId, outcomeId, and playerId:
curl -H "x-api-key: YOUR_API_KEY" \ "https://v2.55-tech.com/betslip?fixtureId=id1000004461512432&outcomeId=103&playerId=0"
import requests resp = requests.get( "https://v2.55-tech.com/betslip" , headers = { "x-api-key" : "YOUR_API_KEY" }, params = { "fixtureId" : "id1000004461512432" , "outcomeId" : 103 , "playerId" : 0 }, ) print (resp.json()[ "odds" ])
The betslip returns live odds from every bookmaker that has this market, with fixture and outcome metadata:
{ "fixtureId" : "id1000004461512432" , "outcomeId" : 103 , "playerId" : 0 , "client" : "your-client" , "fixtureInfo" : { "sport" : { "sportId" : 10 , "sportName" : "Soccer" }, "tournament" : { "tournamentName" : "Serie A" , "categoryName" : "Italy" }, "participants" : { "participant1Name" : "AS Roma" , "participant2Name" : "Cagliari Calcio" } }, "outcomeInfo" : { "marketName" : "Full Time Result" , "outcomeName" : "2" }, "odds" : { "pinnacle" : { "id1000004461512432:pinnacle:103:0" : { "price" : 1.98 , "limit" : 15000 , "limitMin" : 5 , "limitCurrency" : "USD" , "limitUsd" : 15000 , "limitMinUsd" : 5 , "active" : true , "account" : "pinnacle_main" , "currencyInfo" : { "currency" : "USD" , "currencyValue" : 1 , "updatedAt" : "2026-02-07T17:29:32+00:00" } } }, "sharpbet" : { "id1000004461512432:sharpbet:103:0" : { "price" : 2.0 , "limit" : 751.34 , "limitMin" : 1 , "limitCurrency" : "EUR" , "limitUsd" : 886.13 , "limitMinUsd" : 1.18 , "active" : true , "account" : "sharpbet_user" , "currencyInfo" : { "currency" : "EUR" , "currencyValue" : 0.84788876 , "updatedAt" : "2026-02-07T17:29:32+00:00" } } } } }
Use the OddsPapi API to discover fixture IDs and outcome IDs. ABP uses OddsPapi identifiers directly. Step 3: Place an order Place a bet order with minimum price protection. Each order needs a unique requestUuid for idempotency:
curl -X POST \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "orders": [ { "requestUuid": "eb45b192-317b-42d5-9f65-af497b9fa8c1", "fixtureId": "id1000004461512432", "outcomeId": 103, "playerId": 0, "orderStake": 10.0, "orderPrice": 1.95, "userRef": "my-strategy-1", "testOrder": false } ] }' \ https://v2.55-tech.com/place-orders
import uuid, requests resp = requests.post( "https://v2.55-tech.com/place-orders" , headers = { "x-api-key" : "YOUR_API_KEY" }, json = { "orders" : [{ "requestUuid" : str (uuid.uuid4()), "fixtureId" : "id1000004461512432" , "outcomeId" : 103 , "playerId" : 0 , "orderStake" : 10.0 , "orderPrice" : 1.95 , "userRef" : "my-strategy-1" , "testOrder" : False , }]}, ) print (resp.json())
import { randomUUID } from "crypto" ; const resp = await fetch ( "https://v2.55-tech.com/place-orders" , { method: "POST" , headers: { "x-api-key" : "YOUR_API_KEY" , "Content-Type" : "application/json" , }, body: JSON . stringify ({ orders: [{ requestUuid: randomUUID (), fixtureId: "id1000004461512432" , outcomeId: 103 , playerId: 0 , orderStake: 10.0 , orderPrice: 1.95 , userRef: "my-strategy-1" , testOrder: false , }], }), }); console . log ( await resp . json ());
Key fields: Field Required Description requestUuidYes Unique UUID for idempotency (a duplicate within 30 min is skipped; 409 only if every order is a duplicate) fixtureIdYes OddsPapi fixture ID outcomeIdYes Market outcome (e.g., 103 = away win) playerIdYes Set to 0 for non-player-prop markets orderStakeYes Total amount to wager orderPriceYes Minimum acceptable decimal odds userRefYes Your reference for grouping related orders testOrderYes Validate only, don’t actually place (false for real bets) bookmakersNo Comma-separated slugs to target (omit for automatic selection) orderCurrencyNo Currency code (default: USD) acceptBetterOddsNo Accept odds better than orderPrice (default: true) acceptPartialStakeNo Allow partial fills (default: true) backNo Back bet (true) or lay bet (false) (default: true) expiresAtNo ISO 8601 expiry time (default: 5 seconds from now) metaNo Custom metadata object (stored but not sent to bookmaker)
Response: { "status" : "accepted" , "acceptedOrders" : [ { "orderId" : 327 , "requestUuid" : "eb45b192-317b-42d5-9f65-af497b9fa8c1" , "orderStatus" : "FILLED" , "fixtureId" : "id1000004461512432" , "outcomeId" : 103 , "orderStake" : 10.0 , "orderPrice" : 1.95 , "filledStake" : 10.0 , "bets" : [ { "betId" : 73 , "bookmaker" : "pinnacle" , "placedPrice" : 1.98 , "placedStake" : 10.0 , "betStatus" : "CONFIRMED" } ] } ], "declinedOrders" : [] }
Orders that fail validation appear in declinedOrders with a declineReason:
{ "status" : "declined" , "acceptedOrders" : [], "declinedOrders" : [ { "requestUuid" : "fb5f2dd9-c855-4ba9-8ef9-4c2278ca2f1d" , "fixtureId" : "id1000004461512432" , "outcomeId" : 103 , "declineReason" : "Order stake 100.00 USD exceeds available limit 50.00 USD" } ] }
Test without staking real money. Set testOrder: true to run the full validation and routing path (limits, price checks, account selection) without sending a bet to the bookmaker. It’s the fastest way to confirm your payloads and IDs are correct before going live.
Step 4: Track your order Query orders by userRef, orderIds, or requestUuids (at least one filter required):
curl -H "x-api-key: YOUR_API_KEY" \ "https://v2.55-tech.com/orders?userRef=my-strategy-1"
View individual bets for specific orders:
curl -H "x-api-key: YOUR_API_KEY" \ "https://v2.55-tech.com/bets?orderIds=327"
Each bet includes the bookmaker, placed price, placed stake, bet status, and settlement status:
{ "status" : "success" , "bets" : [ { "betId" : 73 , "orderId" : 327 , "bookmaker" : "pinnacle" , "bookmakerBetId" : "3332684214" , "placedStake" : 10.0 , "placedPrice" : 1.98 , "placedCurrency" : "USD" , "betStatus" : "CONFIRMED" , "settlementStatus" : "UNSETTLED" , "account" : "pinnacle_main" , "userRef" : "my-strategy-1" } ], "count" : 1 , "hasMore" : false , "nextCursor" : null }
Step 5: Check positions & PnL View your aggregated open positions (grouped by bookmaker by default):
curl -H "x-api-key: YOUR_API_KEY" \ https://v2.55-tech.com/positions
{ "status" : "success" , "groupBy" : "bookmaker" , "positions" : [ { "bookmaker" : "pinnacle" , "openBets" : 5 , "totalStake" : 250.0 , "avgPrice" : 1.92 } ], "count" : 1 , "totalStake" : 250.0 , "totalOpenBets" : 5 }
View profit and loss:
curl -H "x-api-key: YOUR_API_KEY" \ https://v2.55-tech.com/pnl
{ "status" : "success" , "groupBy" : "bookmaker" , "pnl" : [ { "bookmaker" : "pinnacle" , "settledBets" : 42 , "wins" : 23 , "losses" : 17 , "netPnl" : 250.0 , "winRate" : 54.8 } ], "count" : 1 , "totalNetPnl" : 250.0 , "totalStaked" : 2100.0 , "totalSettledBets" : 42 }
Next steps
Core Concepts Orders vs bets, identifiers, idempotency, and lifecycles.
Order Placement Fills, pricing, and the limit cascade.
WebSocket updates Real-time order, bet, and settlement updates.
Recipes Copy-paste patterns for common integrations.
