MM 快速入门 - 首次API调用

MM 引擎根据博彩公司赔率自动下单。客户端API让您可以监控所有交易活动、控制交易状态（暂停、恢复、停止、启动）以及取消订单。您不通过此API下单 — 引擎会自动完成。

步骤1：检查交易状态

确认您的API密钥有效并查看引擎当前状态：

curl -H "X-API-Key: YOUR_API_KEY" \
  https://mmapi.55-tech.com/api/v1/trading/status

响应：

{
  "client": "your-client",
  "clientName": "Your Client Name",
  "oddsFormat": "decimal",
  "status": "live",
  "tradingActive": true,
  "manualPaused": false,
  "manualStopped": false,
  "systemTradingBlocked": false,
  "emergencyActive": false,
  "systemStopped": false,
  "softPaused": false
}

响应字段：

字段	描述
`status`	状态汇总：`live`、`manual_paused`、`manual_stopped`、`soft_paused`、`system_stopped`、`emergency`
`tradingActive`	引擎正在主动下单时为 `true`
`manualPaused`	通过 `POST /trading/pause` 暂停时为 `true`
`manualStopped`	通过 `POST /trading/stop` 停止时为 `true`
`systemTradingBlocked`	系统全局暂停或停止时为 `true`（非客户端独有）

步骤2：查看交易所订单

引擎已在交易所下单的分页列表。 查询参数：

参数	必需	描述
`fixtureId`	否	按赛事ID过滤
`exchange`	否	按交易所过滤（`polymarket`、`kalshi` 等）
`status`	否	按订单状态过滤，逗号分隔（如 `PLACED,FILLED`）。取值：`PENDING_PLACEMENT`、`PLACED`、`FILLED`、`FAILED`、`CANCELLED`、`EXPIRED`
`fromDate`	否	在此日期或之后创建的订单（`YYYY-MM-DD`）
`toDate`	否	在此日期或之前创建的订单（`YYYY-MM-DD`）
`page`	否	页码，从 1 开始（默认：`1`）
`pageSize`	否	每页条数，最大 `2000`（默认：`50`）

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://mmapi.55-tech.com/api/v1/orders?exchange=polymarket&status=FILLED"

响应：

{
  "data": [
    {
      "orderId": 123,
      "fixtureId": "id1000000861624412",
      "outcomeId": 161,
      "playerId": 0,
      "exchange": "polymarket",
      "account": "0x1234...abcd",
      "exchangeOrderId": "0x1a2b3c...",
      "exchangeOutcomeId": "12345678",
      "orderStatus": "FILLED",
      "matchedStatus": "FULLY_MATCHED",
      "orderCents": 0.45,
      "orderStake": 100.0,
      "matchedStake": 100.0,
      "back": true,
      "side": "buy",
      "settlementStatus": "UNDECIDED",
      "settledAt": null,
      "bookmakerOutcomePrice": 1.808,
      "bookmakerOutcomeLimit": 5000.0,
      "bookmakerOutcomeActive": true,
      "createdAt": "2026-02-15T10:30:00Z",
      "matchedAt": "2026-02-15T10:30:05Z",
      "updatedAt": "2026-02-15T10:30:05Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 50,
  "totalPages": 1
}

响应字段（仅列出非自明字段）：

字段	描述
`playerId`	球员盘市场的球员 ID，非球员盘为 `0`
`account`	此订单使用的交易所账户用户名
`orderStatus`	`PENDING_PLACEMENT`、`PLACED`、`FILLED`、`FAILED`、`CANCELLED`、`EXPIRED`
`matchedStatus`	`NOT_MATCHED`、`PARTIALLY_MATCHED` 或 `FULLY_MATCHED`
`orderCents`	订单价格（美分，预测市场为 `0.01`–`0.99`）
`orderStake`	引擎计划下单的金额
`matchedStake`	在交易所实际成交的金额
`back`	`true` = 买入，`false` = 卖出
`side`	字符串形式：`buy` 或 `sell`（由 `back` 推导）
`bookmakerOutcomePrice`	触发此订单的博彩公司十进制赔率
`bookmakerOutcomeLimit`	下单时博彩公司的可用限额
`bookmakerOutcomeActive`	下单时博彩公司侧是否活跃
`settlementStatus`	`UNDECIDED`、`WON`、`LOST`、`VOID`、`HALF_WON`、`HALF_LOST`
`settledAt`	应用结算的时间戳（结算前为 null）
`updatedAt`	最后状态变更时间戳

如只查看当前未结订单（无分页），使用 GET /orders/open，可选 fixtureId 和 exchange 过滤。

步骤3：查看对冲投注

订单在交易所成交后，引擎会自动在博彩公司下对冲投注。每个投注通过 orderId 与其订单关联。 查询参数：

参数	必需	描述
`orderId`	否	按特定订单关联的投注过滤
`bookmaker`	否	按博彩公司过滤
`status`	否	投注状态，逗号分隔（`placed`、`pending`、`declined`）
`fromDate`	否	在此日期或之后创建的投注（`YYYY-MM-DD`）
`toDate`	否	在此日期或之前创建的投注（`YYYY-MM-DD`）
`page`	否	页码（默认：`1`）
`pageSize`	否	每页条数，最大 `2000`（默认：`50`）

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://mmapi.55-tech.com/api/v1/bets?orderId=123"

响应：

{
  "data": [
    {
      "betId": 456,
      "orderId": 123,
      "client": "your-client",
      "bookmaker": "vertex",
      "bookmakerBetId": "789",
      "placedPrice": 1.808,
      "placedStake": 100.0,
      "betStatus": "placed",
      "settlementStatus": "undecided",
      "placedAt": "2026-02-15T10:30:08Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 50,
  "totalPages": 1
}

步骤4：查看持仓

按所有赛事和交易所汇总的持仓。 查询参数：

参数	必需	描述
`fixtureId`	否	按赛事ID过滤
`exchange`	否	按交易所过滤
`status`	否	逗号分隔：`open`、`matched`、`filled`、`cancelled`、`active`（默认：`active`）
`fromDate`	否	从此日期开始过滤（`YYYY-MM-DD`）
`toDate`	否	至此日期为止过滤（`YYYY-MM-DD`）

curl -H "X-API-Key: YOUR_API_KEY" \
  https://mmapi.55-tech.com/api/v1/positions

响应：

{
  "positions": [
    {
      "fixtureId": "id1000000861624412",
      "outcomeId": 161,
      "exchange": "polymarket",
      "totalStake": 100.0,
      "matchedStake": 100.0,
      "avgPrice": 0.45
    }
  ],
  "count": 1
}

如需跨所有赛事的单一汇总摘要，使用 GET /positions/summary。

步骤5：查看盈亏

做市盈亏：交易所成交与对应博彩公司对冲之间捕获的价差。 查询参数：

参数	必需	描述
`fromDate`	否	在此日期或之后创建的订单（`YYYY-MM-DD`）
`toDate`	否	在此日期或之前创建的订单（`YYYY-MM-DD`）

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://mmapi.55-tech.com/api/v1/pnl?fromDate=2026-01-29&toDate=2026-02-01"

响应：

{
  "totalTurnover": 98350.00,
  "validTurnover": 72415.30,
  "netRealizedSpread": 1482.55,
  "nakedPnl": -220.10,
  "unhedgedStake": 1622.78,
  "unhedgedStakePct": 1.65,
  "avgHedgePriceDrift": 0.0042,
  "settledPairCount": 1420,
  "nakedSettledCount": 12,
  "fromDate": "2026-01-29",
  "toDate": "2026-02-01"
}

响应字段：

字段	描述
`totalTurnover`	在博彩公司侧对冲的总下注额
`validTurnover`	风险调整后的成交量。1.1 赔率下的 100 美元贡献小于 3.0 赔率下的 100 美元
`netRealizedSpread`	已结算的交易所 + 博彩公司配对的盈亏（双腿都已终态）
`nakedPnl`	已结算但从未成功对冲的交易所成交盈亏
`unhedgedStake`	未成功对冲的已成交交易所下注金额（美元）
`unhedgedStakePct`	未成功对冲的已成交交易所下注百分比
`avgHedgePriceDrift`	按下注额加权的平均对冲价格滑点（十进制赔率点）
`settledPairCount`	完全结算的交易所 + 对冲配对数量
`nakedSettledCount`	计入 `nakedPnl` 的已结算交易所成交数量

步骤6：列出账户

查看您的交易所账户（凭证永远不会暴露）：

curl -H "X-API-Key: YOUR_API_KEY" \
  https://mmapi.55-tech.com/api/v1/accounts

{
  "oddsFormat": "decimal",
  "accounts": [
    {
      "username": "0x1234...abcd",
      "exchange": "polymarket",
      "active": true,
      "maxOutcomeStake": 1000.0,
      "balance": 50000.0,
      "createdAt": "2026-01-15T12:00:00Z"
    }
  ],
  "count": 1
}

步骤7：交易控制

暂停会保留交易所上的现有订单但停止新订单。停止会立即取消所有未结订单。

# 暂停 — 保留现有订单，停止新订单
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
  https://mmapi.55-tech.com/api/v1/trading/pause

# 暂停后恢复
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
  https://mmapi.55-tech.com/api/v1/trading/resume

# 停止 — 取消所有未结订单
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
  https://mmapi.55-tech.com/api/v1/trading/stop

# 停止后启动
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
  https://mmapi.55-tech.com/api/v1/trading/start

步骤8：取消订单

按ID取消单个订单，或一次取消所有未结订单。 cancel-all 查询参数：

参数	必需	描述
`exchange`	否	仅取消特定交易所上的订单
`fixtureId`	否	仅取消特定赛事的订单

# 取消全部
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
  https://mmapi.55-tech.com/api/v1/orders/cancel-all

# 仅取消 Polymarket 订单
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
  "https://mmapi.55-tech.com/api/v1/orders/cancel-all?exchange=polymarket"

# 取消特定订单
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
  https://mmapi.55-tech.com/api/v1/orders/123/cancel

入门

API 参考

MM 快速入门 - 首次API调用

步骤1：检查交易状态

步骤2：查看交易所订单

步骤3：查看对冲投注

步骤4：查看持仓

步骤5：查看盈亏

步骤6：列出账户

步骤7：交易控制

步骤8：取消订单

下一步

WebSocket 更新

API 参考

入门

API 参考

Documentation Index

​步骤1：检查交易状态

​步骤2：查看交易所订单

​步骤3：查看对冲投注

​步骤4：查看持仓

​步骤5：查看盈亏

​步骤6：列出账户

​步骤7：交易控制

​步骤8：取消订单

​下一步

WebSocket 更新

API 参考

步骤1：检查交易状态

步骤2：查看交易所订单

步骤3：查看对冲投注

步骤4：查看持仓

步骤5：查看盈亏

步骤6：列出账户

步骤7：交易控制

步骤8：取消订单

下一步