trade API ver. 1.0
基址 https://api.takepair.com/trading/v1。密钥放在 Authorization: Bearer tp_bot_…。设置页只显示一次密钥。trade 权限下单和撤单。withdraw 权限只能提到设置里保存的地址。限制为每分钟 600 次请求。金额是十进制字符串,币种为 USDC 或 USDT。重复同一个幂等键不会产生第二笔订单。
不要把密钥放进浏览器、公开页面或手机应用。
两边都挂
做市单留在订单簿上:结果、金额和赔率。一次调用可以两边都挂。吃单可以全部或部分拿走别人的单。closes_at 之前,撤销会把未成交金额全部退回。已成交部分留下。closes_at 之后,平台撤销未成交金额并收取截止费。如果机器人在 heartbeat 之后沉默,trade API ver. 1.0 会在投注仍开放时撤销该密钥的未成交订单。
读取市场
curl "https://api.takepair.com/trading/v1/markets" \ -H "Authorization: Bearer tp_bot_…"
两边一起挂单
curl -X POST https://api.takepair.com/trading/v1/orders/batch \
-H "Authorization: Bearer tp_bot_…" \
-H "Content-Type: application/json" \
-d '{"orders":[{"event_id":"…","outcome_id":"…","side":"YES","currency":"USDC","stake_amount":"10","odds":"1.90","idempotency_key":"up-1"},{"event_id":"…","outcome_id":"…","side":"YES","currency":"USDC","stake_amount":"10","odds":"1.90","idempotency_key":"down-1"}]}'方法
| GET /time | 服务器时间 |
| GET /markets | 仍可投注的市场,以及刚刚停止投注的市场,附带赢方手续费和截止规则 |
| GET /markets/{event_id} | 单个市场 |
| GET /markets/{event_id}/book | 挂着的订单,包括别人的,不含对方账户标识 |
| GET /markets/{event_id}/position | 每个结果上已成交和仍挂着的数量,以及最差的已成交亏损 |
| GET /markets/{event_id}/resolution | 预言机价格、赢家、赢方手续费,以及你的成交回报 |
| POST /orders | 挂单一笔:结果、金额、赔率 |
| POST /orders/batch | 一次调用挂两边。每笔订单有自己的幂等键 |
| POST /orders/{order_id}/take | 全部或部分吃掉别人的订单 |
| GET /orders | 你的订单。open=true 是流断开后的快照 |
| GET /orders/{order_id} | 你的一笔订单及其状态 |
| DELETE /orders/{order_id} | 在 closes_at 之前撤销自己未成交的剩余。金额全部退回 |
| DELETE /orders | 撤销一个市场或全部市场上机器人未成交的订单 |
| GET /fills | 你最近的成交 |
| POST /heartbeat | 如果机器人沉默,该密钥的未成交订单会在投注仍开放时被撤销 |
| GET /stream/book | 开市、订单簿、停止投注和结算。不含账户标识 |
| GET /stream/account | 你的成交和撤销,以及市场进程 |
| GET /balances | 可用和锁定,USDC 与 USDT |
| GET /deposit-addresses | 充值地址和网络。币由机器人自己发送 |
| GET /deposits | 入账状态和交易哈希 |
| GET /withdrawals/fee-estimate | 提现手续费估算。需要 withdraw 权限 |
| GET /withdrawals | 提现状态和交易哈希 |
| POST /withdrawals | 只能提到设置里保存的地址 |
原地改单、子账户和结果代币不属于 trade API ver. 1.0。RevShare、链接和 postback 属于 partner API ver. 1.0。