Todo preço que sai da API de odds da Pinnacle chega como um número decimal. Seu armazenamento deve guardar exatamente esse número, e a conversão deve rodar só na borda, quando um humano precisa de americano ou fracionário numa tela. No momento em que um preço é armazenado num formato de exibição, todo cálculo depois dele começa com uma tradução e termina com um arredondamento.
Decimal é o formato do fio
A API serve odds decimais, e decimal é o formato que toda fórmula desse espaço assume: probabilidade implícita é 1 dividido pelo preço, preços justos saem da remoção de margem em decimal, e valor esperado multiplica o preço por uma probabilidade. Armazenar o valor servido mantém seus dados a uma divisão de todo cálculo.
Os formatos americano e fracionário são de apresentação. Existem porque algumas audiências leem +150 mais rápido que 2,50, não porque computam melhor.
O problema da ida e volta
O conversor de odds carrega o aviso nas suas notas de precisão: odds decimais exibidas usam quatro casas e americanas no máximo duas, e arredondar um preço exibido e convertê-lo de volta pode mudar os últimos dígitos, como sua página afirma, verificado em 2026-10-03. Armazene -110 e você guardou um valor de exibição arredondado; o decimal de onde ele veio, 1,90909..., já se foi.
Fracionário não se sai melhor: o conversor aproxima frações com denominador limitado a um milhão. Um preço arredondado para exibição é um preço com um pequeno erro silencioso embutido.
Converta uma vez, na borda
A regra que mantém um sistema honesto: converta quando o preço entra, nunca mais. Na ingestão, o valor vai para o armazenamento como o decimal que a API enviou. Na exibição, um formatador o transforma no que a audiência lê. Entre os dois, toda comparação, todo diff e todo cálculo de margem roda sobre o decimal armazenado.
Três armadilhas desaparecem com essa regra. Comparações de strings falham em silêncio entre formatos: 1,91 e -110 são o mesmo preço e não se parecem em nada. Agregações contam em dobro quando dois formatos de um preço caem numa tabela. E a detecção de deriva quebra quando a comparação inclui um passo de arredondamento. O guia de normalização cobre o lado da identidade da mesma disciplina: chaves para o que o preço é, separadas do valor que você guarda.
Quando você herda uma tabela mista
Se você já armazena americano ou fracionário em algum lugar, converta para frente uma vez e congele: adicione uma coluna decimal, preencha por conversão, e torne a coluna antiga somente leitura. O conversor documenta o conjunto completo de regras nas duas direções, incluindo a rejeição de valores americanos entre -100 e +100, verificado em 2026-10-03.
Um formato canônico, duas línguas de exibição, zero aritmética em strings. Armazene o que o fio enviou; traduza só para humanos.