Duas chaves, uma em contorno e outra sólida, sobre um painel de papel ao lado de um cadeado redondo.

API da Betfair: O Que Precisa, Quanto Custa, A Quem Convém

O script está escrito a meio, e a API da Betfair pede uma chave antes de tudo o resto. A chave depende de uma conta própria e verificada da Betfair, por isso, se o seu país for excluído ou a sua conta estiver encerrada, isto não é uma via de entrada.

O acesso à API da Betfair são duas chaves de aplicação numa conta própria da Betfair. A chave Delayed é gratuita e funciona de imediato, mas os seus preços chegam com atraso e uma aposta feita com ela é uma aposta real. A chave Live exige um pedido, uma conta que já passou as verificações de identidade da Betfair e com saldo suficiente para pagar uma taxa de ativação única, atualmente 499 £ e não reembolsável (verifique as condições atuais). Uma chave pessoal é só para uso pessoal; as empresas passam pelas vias comerciais da Betfair. Sem uma conta da Betfair não há chave, e a ferramenta de exchange de um broker não é uma conta da Betfair.

Para que serve a API

Uma cópia mais antiga da própria documentação de programadores da Betfair descreve a Exchange API como uma forma de construir sistemas de apostas automatizados ou ecrãs de apostas personalizados, gratuita para desenvolver e só para uso pessoal (verifique as condições atuais). As condições da Betfair contam as apostas feitas por outros meios automatizados como suspeitas e dizem que as apostas feitas pela API não são isso (cláusula 12.1.4 da cópia arquivada que lemos). Uma página em separado vai mais longe sobre automatizar apostas através dessa mesma chave.

Convém a quem aposta para si próprio e quer código, não dedos, nos botões. Não convém a quem não tenha uma conta própria da Betfair. Para o panorama mais amplo, veja onde a API se encaixa entre as outras vias; o nosso guia de acesso tem o mapa completo das vias de entrada.

Primeiro a conta, depois as chaves

O primeiro passo é onde alguns leitores ficam pelo caminho.

  1. Tenha uma conta própria e verificada da Betfair

    Se não tiver nenhuma, abrir primeiro uma conta direta é a tarefa, em seu nome, num país que a Betfair sirva. A ajuda para programadores da Betfair diz que uma conta da Betfair com KYC verificado é exigida em todos os casos, e que sem uma conta da Betfair não pode avançar com o licenciamento. Leia as verificações de KYC de que uma chave Live depende antes de planear em torno de uma chave Live, e mantenha saldo suficiente na conta para a taxa do passo quatro.

  2. Crie as chaves

    Cada conta recebe duas chaves de aplicação. A chave Delayed fica ativa logo que é criada. A chave Live começa inativa.

  3. Construa e teste na chave Delayed

    Os seus preços chegam com atraso, de 1 a 180 segundos, por isso construa o script a pensar nisso. Mantenha cada aposta de teste no montante mínimo, e confirme as contas de um script à mão numa calculadora de back e lay antes de ele fazer a primeira aposta, porque com esta chave toda a aposta é real. Uma página em separado cobre de onde vêm realmente os dados de preços para um sistema deste tipo.

  4. Peça a chave Live e pague a taxa

    A Betfair pede-lhe que termine os testes primeiro, e só depois peça através do seu Developer Program para apostas pessoais. Uma vez aprovado o acesso, a taxa de ativação é debitada da sua conta da Betfair, e não é reembolsada.

  5. Nada disto muda as condições da Betfair

    A chave Live não levanta nenhuma das regras da conta: só uso pessoal, uma conta por pessoa, o direito da Betfair de a encerrar.

Uma chave só é tão aberta quanto a conta por trás dela.

Chave Delayed contra chave Live

As duas chaves diferem no que veem e no que custam. Ambas podem fazer uma aposta na exchange em tempo real.

Chave Delayed e chave Live, como a documentação de programadores da Betfair as define
O que fazChave DelayedChave Live
Feita paraDesenvolvimento, e software de prática que não pode apostarAplicações de apostas em tempo real
PreçosCom atraso, de 1 a 180 segundosEm tempo real
Fazer apostasPermitido, na exchange em tempo realPermitido
Uso só de leituraPermitidoNão permitido
Profundidade de preços3 níveis de preçoTodos os níveis de preço
Total associado por seleção, preços Betfair SP próximos e distantesNão disponívelDisponível
Taxa de ativaçãoNenhuma499 £ uma vez, não reembolsável (verifique as condições atuais)

Uma chave Live não pode ser só de leitura

Uma chave Live usada só para ler preços não é permitida, e aos utilizadores que só querem dados é dito para ficarem na chave Delayed ou arriscarem a desativação da chave Live. Pagar 499 £ só para ver preços está fora de questão.

A taxa é fixa, o retorno não

As páginas atuais de programadores da Betfair dizem que a chave Live custa 499 £, uma vez. Fontes mais antigas diziam 299 £, por isso verifique as condições atuais antes de planear o orçamento. Se 499 £ é pouco ou muito depende de um número que ninguém lhe pode dar de antemão: quanto vale cada aposta em média.

Hipótese, com todos os dados inventados. Assuma um script cujas apostas, a um montante de 100 £, valem em média 2 £ cada depois da comissão da exchange, fazendo 10 por dia. Então 499 £ ÷ 2 £ = 249,5, ou seja, 250 apostas, ou 25 dias, para cobrir a taxa. Assuma 0,50 £ por aposta em vez disso e fica 499 £ ÷ 0,50 £ = 998 apostas, cerca de 100 dias. A 0 £ por aposta a taxa nunca é recuperada. Abaixo de 0 £, o buraco só se aprofunda.

Um lucro esperado é uma média ao longo de muitas apostas, não uma promessa sobre as próximas cem. Ninguém deve ler rendimento nestes números; o script é imaginário.

Um segundo caso inventado, e o que apanha as pessoas: um apostador com uma conta verificada e 650 £ nela escreve um script ao longo de três fins de semana na chave Delayed, assumindo que as suas apostas de teste empatam, paga 499 £ desses 650 £, e descobre que a conta fica com 151 £ para apostar quando as primeiras apostas reais entram, o que é uma banca muito diferente da que o plano assumia.

Eu não pagaria uma chave Live até a Delayed ter corrido a mesma estratégia durante semanas no montante mínimo, sabendo que preços até 180 segundos atrasados tornam o teste num guia aproximado. A taxa não é devolvida.

Chave pessoal, licença comercial

Uma chave pessoal é para as suas próprias apostas. A mesma documentação arquivada diz que todo o uso de dados ou da API em contexto comercial tem de ser aprovado pela Betfair, e que um uso não aprovado será identificado e bloqueado (verifique as condições atuais).

Em resumo: um fornecedor de software que construa uma aplicação para clientes da Betfair paga uma licença de 1.499 £, devida na certificação de segurança. Uma empresa que queira negociar de forma automática passa pelo braço empresarial da Flutter para uma «Exchange Trading Account», que começa com documentos da empresa e verificações de identidade aos seus diretores e acionistas. Nenhuma delas é uma chave pessoal com um orçamento maior.

O que continua a limitar qualquer uma das chaves

A Betfair limita quantos dados de mercado um pedido pode exigir, a 200 pontos, custando mais pontos os dados mais detalhados, e recusa instruções de ordens acima de 1.000 num único segundo. Os mercados em direto costumam ter um atraso de 1 a 12 segundos ao fazer apostas, o que a Betfair diz permitir aos clientes cancelar ordens não associadas quando as condições mudam. Podem aplicar-se encargos de transação em qualquer das chaves depois de passar 5.000 transações elegíveis numa hora, e os erros contam (a página de Charges da Betfair tem as condições; verifique as condições atuais).

As páginas de programadores da Betfair também dizem que os pedidos à API de regiões listadas são bloqueados. Essa lista difere da lista das condições, e nenhuma das duas é completa, por isso verifique a lista atual e a legislação local. Quando a redação sobre países o exclui é lido na sua própria página.

O que os quatro brokers dizem sobre APIs e bots

Um broker abre uma conta própria, não uma conta da Betfair, por isso a API de um broker, onde exista, liga-se ao broker. Estas ferramentas são acordos comerciais sob as condições de cada broker. Nas páginas que lemos, nenhum dos quatro oferece uma chave da Betfair, e cada um mantém a sua própria lista de países excluídos; o que um início de sessão de broker realmente contém mostra as camadas. O que cada um diz vem a seguir; verifique as condições atuais para cada linha.

BetInAsia. Uma cópia arquivada recente da sua página inicial continua a anunciar uma ligação à API BLACK Sports Betting. Uma cópia mais antiga da sua página de API diz que o acesso é a pedido e que é uma ligação à BLACK, não uma ligação direta à API das exchanges por trás dela. Não é para si se viver no Reino Unido ou nos EUA, ambos excluídos pelas suas condições, entre outros.

AsianConnect. O seu centro de ajuda diz que oferece uma conta de API através da Asianodds88, o seu agregador de odds: uma API para a Asianodds88, não uma chave da Betfair. Não encontrámos nada sobre APIs ou bots para a Piwi247 ou a OrbitX. Verifique a sua lista de restrições antes de mais nada: uma lista mais antiga nomeia os EUA e a China, entre outros, e o seu formulário de registo e o seu centro de ajuda não coincidem em alguns países.

MadMarket. Não encontrámos nenhuma página de API para clientes, e as suas condições proíbem scraping e qualquer robô, spider ou outro mecanismo automatizado. As suas condições também excluem o Reino Unido, os EUA e a Austrália, entre outros.

Sportmarket. O seu artigo de ajuda diz que a FairExchange não pode ser usada com bots de software por API, e não encontrámos documentação pública de API. Se viver no Reino Unido, nos EUA ou em França, entre outros, as suas condições excluem-no.

As listas mudam, e as próprias páginas de um broker discordam por vezes, por isso compare as condições dos quatro brokers numa só tabela e trate as condições atuais de cada broker como a palavra final. Eu leria «acesso a API» na página de um broker como uma pergunta a fazer por escrito, não como uma funcionalidade sobre a qual planear uma estratégia.

A ferramenta de um broker só é uma via onde a Betfair e o broker aceitam ambos, e nunca é uma chave da Betfair.

Perguntas frequentes

O acesso à API da Betfair é automático, ou é preciso pedi-lo?

Em parte. Depois de ter uma conta verificada da Betfair, cria as chaves você mesmo, e a chave Delayed funciona de imediato. A chave Live exige um pedido, verificação de identidade completa e saldo suficiente na conta para cobrir a taxa de ativação. Verifique a ajuda atual de programadores da Betfair antes de depender de qualquer passo.

Quanto custa o acesso à API da Betfair, e a taxa é reembolsável?

A chave Delayed é gratuita. A chave Live tem uma taxa de ativação única, atualmente 499 £, retirada da sua conta da Betfair depois de o acesso ser aprovado, e não é reembolsável. A comissão da exchange sobre os seus ganhos é separada. Verifique as condições atuais.

É possível usar a API da Betfair sem uma conta da Betfair?

Não. A chave é emitida a uma conta com KYC verificado, e a ajuda de programadores da Betfair diz com todas as letras: sem uma conta da Betfair não pode avançar com o licenciamento.

E se a Betfair não estiver disponível onde vivo?

Então não existe via de API nenhuma, porque a chave depende de uma conta que a Betfair tem de aceitar. Disfarçar a sua localização não é solução: porque é que as localizações disfarçadas acabam mal tem a cláusula e as consequências.