步骤1：列出您的账户
检查为您的API密钥配置了哪些博彩公司账户：curl -H "x-api-key: YOUR_API_KEY" \
https://v2.55-tech.com/accounts
[
{
"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" }
}
]
步骤2：获取投注单
下注前，获取当前赔率和限额。需要fixtureId、outcomeId 和 playerId：
- cURL
- Python
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"])
{
"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" }
}
}
}
}
使用 OddsPapi API 查找赛事ID和结果ID。ABP 直接使用 OddsPapi 标识符。
步骤3：下单
下一个带最低价格保护的投注订单。每个订单需要唯一的requestUuid 以确保幂等性：
- cURL
- Python
- JavaScript
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());
| 字段 | 必填 | 描述 |
|---|---|---|
requestUuid | 是 | 用于幂等性的唯一UUID（30分钟内的重复项会被跳过；仅当每个订单都是重复时才返回409） |
fixtureId | 是 | OddsPapi 赛事ID |
outcomeId | 是 | 市场结果（例如 103 = 客胜） |
playerId | 是 | 非球员盘设为 0 |
orderStake | 是 | 总投注金额 |
orderPrice | 是 | 最低可接受十进制赔率 |
userRef | 是 | 用于分组相关订单的引用 |
testOrder | 是 | 仅验证不实际下注（实际投注设为 false） |
bookmakers | 否 | 逗号分隔的目标博彩公司标识（省略则自动选择） |
orderCurrency | 否 | 货币代码（默认：USD） |
acceptBetterOdds | 否 | 接受优于 orderPrice 的赔率（默认：true） |
acceptPartialStake | 否 | 允许部分成交（默认：true） |
back | 否 | 买入注（true）或卖出注（false）（默认：true） |
expiresAt | 否 | ISO 8601 过期时间（默认：从现在起5秒） |
meta | 否 | 自定义元数据对象（存储但不发送给博彩公司） |
{
"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": []
}
declinedOrders 中，并包含 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"
}
]
}
无需真实下注即可测试。设置
testOrder: true 会走完整的校验与路由流程（额度、价格检查、账户选择），但不会向博彩公司发送投注。这是上线前确认你的请求体与 ID 正确的最快方式。步骤4：跟踪您的订单
按userRef、orderIds 或 requestUuids 查询订单（至少需要一个过滤条件）：
curl -H "x-api-key: YOUR_API_KEY" \
"https://v2.55-tech.com/orders?userRef=my-strategy-1"
curl -H "x-api-key: YOUR_API_KEY" \
"https://v2.55-tech.com/bets?orderIds=327"
{
"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
}
步骤5：查看持仓和盈亏
查看您的汇总敞口（默认按博彩公司分组）：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
}
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
}
下一步
核心概念
订单与投注、标识符、幂等性与生命周期。
订单下注
成交、定价与额度级联。
WebSocket 更新
实时订单、投注与结算更新。
实战范例
常见集成的可复制模式。