Histórico +EV

Histórico de preços de uma aposta em um jogo: cada momento em que o SharpAPI marcou a aposta como +EV e, opcionalmente, o próprio histórico de preços do sportsbook para a mesma aposta.


GET /api/v1/ev/history

Tier Enterprise obrigatório. Este endpoint é controlado pela feature history. Tiers inferiores recebem 403 tier_restricted.

Parâmetros de ConsultaLink permanente para esta seção

Parâmetro	Tipo	Padrão	Descrição
`game_id`	string	—	Obrigatório. O jogo a ser consultado.
`sportsbook`	string	todos	Filtra por sportsbook(s), separados por vírgula. Exatamente um é obrigatório quando `include_book_trail=true`.
`market_type`	string	todos	Filtra por tipo de mercado. Obrigatório quando `include_book_trail=true`.
`selection`	string	todos	Filtra por seleção. Obrigatório quando `include_book_trail=true`.
`line`	number	todas	Filtra para uma linha. Opcional, inclusive com `include_book_trail=true`; quando omitido, o histórico cobre todas as linhas desse mercado e o campo `points` de cada ponto indica qual.
`player`	string	todos	Correspondência exata com o nome do jogador, para props de jogador.
`since`	string	60 minutos atrás	Início da janela: timestamp RFC 3339 ou segundos Unix.
`limit`	integer	200	Máximo de linhas, 1–500.
`include_book_trail`	boolean	`false`	`true` ou `1` adiciona `book_trail`, `book_trail_carry_in` e `prematch_close` à resposta (veja abaixo).

Com include_book_trail=true, uma requisição que não fixe um sportsbook, um market_type e uma selection é rejeitada com 400 validation_error: os pontos do histórico não trazem rótulo de sportsbook, mercado ou seleção, então uma requisição pouco específica misturaria várias apostas em uma única série.

Histórico do bookLink permanente para esta seção

include_book_trail=true adiciona o próprio histórico de preços do sportsbook para a aposta fixada — os preços que o book exibiu, não apenas os momentos em que o SharpAPI marcou a aposta como +EV.


{
  "success": true,
  "data": [ /* +EV rows */ ],
  "book_trail": [ { "t": "2026-10-13T12:10:00Z", "price": -190, "points": 1.5, "locked": false } ],
  "book_trail_carry_in": { "t": "2026-10-13T01:50:51.66Z", "price": -275, "points": 1.5, "locked": false },
  "prematch_close": null,
  "meta": {
    "game_id": "…",
    "count": 3,
    "book_trail_available": true,
    "book_trail_count": 1,
    "book_trail_truncated": false
  }
}

`book_trail_carry_in`Link permanente para esta seção

O preço já vigente na borda esquerda da sua janela: a linha mais recente da mesma aposta com timestamp anterior a since. Desenhe-o como ponto inicial da linha para que o gráfico não comece na primeira mudança dentro da janela.

Formato: { "t", "price", "points", "locked" }, os mesmos campos de um ponto de book_trail, ou null.
Presente em toda resposta com include_book_trail=true. Sem esse parâmetro, a chave fica ausente.
É null quando não existe nenhuma linha dentro de 36 horas antes de agora (ou de since, se for anterior). Uma aposta atualizada pela última vez mais de 36 horas antes da janela, portanto, também retorna null.
Não faz parte de book_trail: nunca é mesclado com esses pontos e não é contado em meta.book_trail_count nem em meta.book_trail_truncated, que descrevem apenas as linhas da janela.

Como interpretar “linha aberta na janela”. Considere a linha como aberta dentro da janela somente quando book_trail_carry_in for null e meta.book_trail_truncated for false. Quando o histórico está truncado, um ponto de entrada null não diz nada sobre quando a linha foi aberta.

`prematch_close`Link permanente para esta seção

O último preço pré-jogo do book para a aposta fixada, ou null. É null até o evento começar.