一块纸质面板上有两把钥匙,一把只是轮廓,一把是实心的,旁边是一把圆形的锁。

Betfair API访问:需要什么、花多少钱、适合谁

脚本写到一半,Betfair的API在别的一切之前先要一把密钥。这把密钥挂在一个经过核验的、你自己的Betfair账户上,所以如果你的国家或地区被拒绝,或者账户已被关闭,这就不是一条进入之路。

Betfair API访问,就是你自己的Betfair账户上的两把应用密钥。Delayed key(延迟密钥)免费,立刻可用,但它的赔率是延迟的,用它下的投注是真实的投注。Live key(实时密钥)需要申请,要求账户已通过Betfair的身份核验,并且余额足够支付一次性的激活费,目前是£499,不可退还(请查看现行条款)。个人密钥只供个人使用;公司走Betfair的商业渠道。没有Betfair账户,就没有密钥,而经纪商的交易所工具不是Betfair账户。

API是用来做什么的

Betfair自己的开发者文档的一份较早副本,把Exchange API描述为一种构建自动化投注系统或自定义投注界面的方式,开发免费,且仅限个人使用(请查看现行条款)。Betfair的条款把通过其他自动化手段投注视为可疑,并说通过API下的投注不属于此类(我们读到的存档副本的第12.1.4条)。通过同一把密钥自动化下注在另一页里讲得更深入。

它适合为自己投注、想让代码而不是手指去按按钮的人。它不适合任何没有自己Betfair账户的人。想看更全的图景,请看API在各条路径中的位置;我们的访问指南里有从头到尾的进入方式地图。

先有账户,再有密钥

第一步,是一些读者止步的地方。

  1. 持有一个经过核验的、你自己的Betfair账户

    如果你还没有,要做的事就是先开设一个直接账户,用你自己的名字,在Betfair提供服务的国家或地区。Betfair的开发者帮助说,在任何情况下都需要一个已通过身份验证(KYC)的Betfair账户,没有Betfair账户就无法继续办理授权。在围绕Live key做计划之前,请先读Live key所依赖的KYC核验,并在账户里留够第四步的费用。

  2. 创建密钥

    每个账户有两把应用密钥。Delayed key一创建就处于启用状态。Live key起初是未启用的。

  3. 在Delayed key上开发和测试

    它的赔率是延迟到达的,延迟1到180秒,所以要按这个来构建。每一笔测试投注都保持最低投注额,并且在脚本下第一笔投注之前,用back与lay计算器手算核对脚本的数字,因为用这把密钥,每一笔投注都是真的。这类系统所用的价格数据究竟来自哪里另有一页专门讲。

  4. 申请Live key并支付费用

    Betfair要求你先完成测试,再通过它的Developer Program(开发者计划)为个人投注提出申请。访问获批之后,激活费从你的Betfair账户中扣除,且不予退还。

  5. 此后没有任何东西会改变Betfair的条款

    Live key不会解除账户的任何规则:仅限个人使用,每人一个账户,以及Betfair关闭账户的权利。

密钥的开放程度,只取决于它背后的账户。

Delayed key与Live key对比

两把密钥的区别,在于它们能看到什么和要花多少钱。两把都能在真实的交易所里下注。

Delayed key与Live key,依Betfair开发者文档所述
功能Delayed keyLive key
用途开发,以及不能下注的练习软件实时投注的应用
赔率延迟1到180秒实时
下注允许,在真实的交易所上允许
只读使用允许不允许
价格深度3个价格档位所有价格档位
按所选项计的已撮合总额,以及Betfair SP(起跑赔率)的近价和远价不提供提供
激活费无一次性£499,不可退还(请查看现行条款)

Live key不能只读

只用来读取赔率的Live key是不被允许的;只需要数据的用户会被告知:继续使用Delayed key,否则Live key有被停用的风险。花£499只为看赔率,行不通。

费用是固定的,回报不是

Betfair的开发者页面目前说,Live key的费用是£499,一次性。较早的来源说是£299,所以在做预算之前,请查看现行条款。£499算不算便宜,取决于一个谁也无法提前告诉你的数字:每笔投注平均价值多少。

纯属假设,所有输入都是虚构的。假设有一个脚本,每笔投注的投注额为£100,扣除交易所佣金后,每笔的期望值为£2,每天下10笔。那么£499 ÷ £2 = 249.5,也就是250笔,或者25天,才能收回这笔费用。如果换成每笔£0.50,就是£499 ÷ £0.50 = 998笔,约100天。每笔为£0,费用永远收不回来。低于£0,窟窿只会越来越深。

期望利润是很多笔投注上的平均值,不是对接下来一百笔的承诺。谁也不该从这些数字里读出收入;这个脚本是想象出来的。

第二个虚构的案例,也是最容易让人栽跟头的一个:一位投注者有一个已核验的账户,里面有£650,用三个周末在Delayed key上写出一个脚本,假定它的测试投注能保本,从这£650里付了£499,等第一批实时投注下出去时,才发现账户里只剩£151可以用来投注,这和计划所假设的投注本金大不相同。

我不会在Delayed key以最低投注额把同一套策略跑上几周之前,就去买Live key,要知道赔率最多晚180秒,测试只能作为一个粗略的参考。这笔费用是回不来的。

个人密钥,商业授权

个人密钥用于你自己的投注。同一份存档文档说,一切商业场景下的数据或API使用都必须经Betfair批准,未经批准的使用会被识别并被屏蔽(请查看现行条款)。

概括起来:为Betfair客户开发应用的软件供应商,要支付£1,499的授权费,在安全认证时到期。想要自动交易的公司,要通过Flutter的业务部门申请“Exchange Trading Account”,这从公司文件以及对其董事和股东的身份核验开始。两者都不是预算更大的个人密钥。

两把密钥仍然受到哪些限制

Betfair限定了单次请求最多可以索取多少市场数据,上限是200点,内容越丰富的数据耗点越多;它还会拒绝一秒钟内超过1,000条的订单指令。滚球(in-play)市场在下注时通常有1到12秒的延迟,Betfair说这能让客户在情况变化时取消未撮合的订单。无论用哪把密钥,一小时内的合格交易超过5,000笔之后,都可能产生交易费用,而且出错也计入(条款见Betfair的“Charges”页面;请查看现行条款)。

Betfair的开发者页面还说,来自所列地区的API请求会被屏蔽。这份名单与条款里的名单不同,两者都不完整,所以请查看现行名单并核对当地法律。当国家和地区的措辞把你排除在外时,在它自己的页面上另行解读。

四家经纪商对API和机器人是怎么说的

经纪商开设的是它自己的账户,不是Betfair账户,所以经纪商的API(如果有的话)连接的是经纪商。这些工具是按各家经纪商自己的条款达成的商业安排。在我们读到的页面上,四家都没有提供Betfair密钥,而且各自保留自己排除的国家和地区;经纪商的登录里到底有什么展示了其中的层次。下面是每一家的说法;每一行都请查看现行条款。

BetInAsia。它首页的一份较新的存档副本,仍然宣传与BLACK Sports Betting API的连接。它API页面的一份较早副本说,访问需要申请,而且这是与BLACK的连接,不是与背后各交易所的直接API连接。不适合你的情况:你住在英国或美国,条款把两者都排除在外,另外还有其他国家和地区。

AsianConnect。它的帮助中心说,它通过其赔率聚合平台Asianodds88提供API账户:这是接入Asianodds88的API,不是Betfair密钥。关于Piwi247或OrbitX,我们没有找到任何API或机器人方面的内容。请先看它的受限名单,再做别的:一份较早的名单点名了美国和中国等,而它的注册表单和帮助中心在某些国家和地区上并不一致。

MadMarket。我们没有找到面向客户的API页面,而且它的条款禁止抓取,以及任何机器人、爬虫或其他自动化机制。它的条款还排除了英国、美国和澳大利亚等国家和地区。

Sportmarket。它的帮助文章说,FairExchange不能与API软件机器人一起使用,而且我们没有找到公开的API文档。如果你住在英国、美国或法国等地,它的条款就把你排除在外。

名单会变,经纪商自己的页面有时也互相矛盾,所以请对照四家经纪商的条款,放在同一张表里,并以各家经纪商的现行条款为准。我会把经纪商页面上的“API访问”,当成一个要用书面形式去问的问题,而不是一项可以围绕它制定策略的功能。

经纪商的工具,只有在Betfair和经纪商都接受你的地方才算一条路径,而且它永远不是Betfair密钥。

常见问题

Betfair API访问是自动的,还是需要申请?

一部分是自动的。只要你持有一个已核验的Betfair账户,密钥就由你自己创建,Delayed key立刻可用。Live key则需要申请、完整的身份核验,以及账户里有足够的钱来付激活费。在你依赖任何一步之前,请查看Betfair现行的开发者帮助。

Betfair API访问要花多少钱,费用能退吗?

Delayed key免费。Live key有一笔一次性的激活费,目前是£499,访问获批后从你的Betfair账户中扣除,不可退还。你赢款的交易所佣金另算。请查看现行条款。

没有Betfair账户,能用Betfair API吗?

不能。密钥发给的是已通过身份验证(KYC)的账户,Betfair的开发者帮助说得很明白:没有Betfair账户,就无法继续办理授权。

如果Betfair在我所在的地方不可用呢?

那么就不存在API路径,因为密钥挂在一个必须由Betfair接受的账户上。伪装所在位置解决不了问题:伪装位置为什么会以糟糕的结果收场里有相关条款和后果。