Liquidez e Limites

O SharpAPI exibe cada sinal de liquidez e limite que recebemos das casas upstream. Esses campos são opcionais nas linhas de /api/v1/odds porque casas de apostas tradicionais e baseadas em exchange expõem dados diferentes.

Campos nas linhas de oddsPermalink for this section

Esses valores são retornados apenas quando presentes no feed de origem. A ausência significa que a casa upstream não expôs esse sinal para a linha; não implica liquidez zero ou limite zero. Especificamente para max_bet, a lista de casas acima é um retrato pontual: /api/v1/sportsbooks publica a resposta atual por casa como has_limits, derivada das linhas atuais de cada casa (null até que linhas sejam observadas).

Valores monetários em linhas de exchangePermalink for this section

Uma exchange cota um preço ao qual só uma quantia finita de dinheiro pode ser casada, então os campos de tamanho significam ali algo diferente do que significam em uma casa tradicional.

• max_bet é o tamanho que está ao melhor preço, não um teto publicado. O max_bet de uma casa tradicional é o máximo que ela aceitará no mercado — uma regra que ela própria definiu. O de uma exchange é quanto dinheiro está realmente ao preço cotado neste momento. O nome do campo é o mesmo; o fato não é. A presença de size_currency é o que distingue os dois casos.
• size_currency rotula a moeda. Nada é convertido. O número é o valor próprio do operador na moeda dele, repassado sem alteração. Ordenar ou filtrar exchanges por tamanho sem ler size_currency compara libras com dólares.
• Uma única regra para os três campos monetários: a ausência significa “o operador não publica este valor”, e um número — inclusive 0.0 — é uma medição real. Nunca leia um campo ausente como zero nem um 0.0 como dado faltante.
• Em uma exchange, max_bet aparece apenas enquanto há dinheiro ao melhor preço. O campo acompanha esse tamanho no livro, então um melhor preço vazio chega como best_bid_liquidity: 0.0 sem max_bet ao lado. Leia esse par como um único fato dito uma vez — não há nada ao preço cotado — e não como um tamanho desconhecido e zero ao mesmo tempo. Nessas casas, max_bet: 0.0 não é enviado, porque seria a afirmação muito mais forte “este mercado não aceita aposta”.
• Não toda exchange publica os dois números de profundidade. Algumas dão só o tamanho ao melhor preço, outras só o total do livro. Nenhum pode ser derivado do outro, então leia cada campo separadamente.

O que não exibimosPermalink for this section

• Profundidade do livro de ordens preço por preço. As casas baseadas em exchange que publicam profundidade nos dão o tamanho ao melhor preço (best_bid_liquidity) e um total de todo o livro (total_liquidity), ambos listados acima. A escada completa — cada nível de preço com o tamanho que está em cada um — não está disponível hoje em nenhum endpoint. Casas de apostas tradicionais não operam um livro de ordens visível.
• Verificações de limite pré-aposta. Nenhuma casa upstream expõe uma verificação pública. Em uma casa tradicional, max_bet é o teto publicado dela para o mercado; em uma casa baseada em exchange é o tamanho que está ao melhor preço. Em ambos os casos, a decisão de aceitar ou recusar acontece no envio do bilhete.
• Razões de suspensão em tempo real. Quando uma casa retira uma linha, /api/v1/odds/delta pode emitir uma remoção, mas os feeds upstream geralmente não incluem uma razão estruturada.

Detectar lacunas de coberturaPermalink for this section

Se uma verificação de cobertura do lado do cliente depende de liquidez:

1. Filtre /api/v1/odds pelas casas que você se interessa.
2. Para casas baseadas em exchange, filtre linhas onde volume_24h ou open_interest exceda seu limite mínimo.
3. Para casas tradicionais, use max_bet quando emitido como sinal de limite aproximado.
4. Para todo o resto, recorra à presença da linha: uma linha de odds é um sinal positivo de que a casa está cotando atualmente esse mercado.