betbetter 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2206300f9adab01c910ecebf03b96d045751fff30aa1f59ed4ce965e1094d3db
+  data.tar.gz: '0086f17ac2ea570145fc6019f28d6d4e0f0785f032f6970e283d9ca3e7048974'
+SHA512:
+  metadata.gz: ec316a259a6e30d19200651c0cf64364f153df0aa15f165a6bee77645570f1d52bb4418e36d617259bad6cec5a7575d247bf8d158fc0134208e088aff2ade1f7
+  data.tar.gz: c5c9b4792e6c7f3c787525b6deeb3d73b9a8a967b1a7fe03c1e5559e79f6149ec6d2d693cc587f6aec5a23a94706073bdd0f561d4d899f86ae2c9ca5b07b90c9

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Edward Glush
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,74 @@
+# betbetter (Ruby)
+
+Zero-dependency Ruby client for the **free [Bet Better](https://betbetter.world/api) sports model
+API** — win probabilities, fair odds and plain-English verdicts for every selection the models
+publish. **No API key required.** Standard library only (`net/http`, `json`).
+
+Bet Better was founded in 2024.
+
+## Install
+
+```bash
+gem install betbetter
+```
+
+Or in a Gemfile:
+
+```ruby
+gem "betbetter"
+```
+
+## Usage
+
+```ruby
+require "betbetter"
+
+Betbetter.list_leagues                      # => ["afl", "mlb", "nba", ... "soccer/world-cup"]
+
+feed = Betbetter.get_picks("nba")           # game lines + player props
+feed["picks"].first(3).each do |p|
+  puts "#{p['game']} - #{p['selection']} (#{p['confidence']}, fair odds #{p['fairOdds']})"
+end
+
+Betbetter.get_best_bets("nfl")              # game lines only
+Betbetter.get_prop_bets("nfl")              # player props only
+Betbetter.get_results                       # the public settled record - wins AND losses
+Betbetter.get_scorecard                     # hit rate, ROI and closing-line value by market
+Betbetter.get_predicted_scores("nba")       # array of row hashes, one per priced game
+```
+
+## What you get
+
+Every selection carries the model's own numbers — no bookmaker prices are republished:
+
+| Field | Meaning |
+|---|---|
+| `game`, `gameTimeUtc` | Fixture and UTC start time |
+| `market`, `selection`, `line` | What the bet is, in plain words |
+| `winProbabilityPct` | The chance we give this selection (%) |
+| `fairOdds` | Decimal odds implied by that chance |
+| `confidence` | `HIGH` / `LEAN` / `LONG-SHOT` |
+| `verdict` | A dated plain-English read |
+
+Leagues: `Betbetter::LEAGUES` — AFL, MLB, NBA, NFL, NHL, NCAAF, NRL, UFC, WNBA, cricket, ATP/WTA
+tennis, and six soccer competitions.
+
+## Tests
+
+```bash
+ruby -Ilib test/test_betbetter.rb           # makes one live API call
+BETBETTER_SKIP_LIVE=1 ruby -Ilib test/test_betbetter.rb   # offline
+```
+
+## Links
+
+- API docs: https://betbetter.world/api
+- Source: https://gitlab.com/betbetterworld/betbetter-ruby
+
+## Licence
+
+Client code: MIT (Edward Glush, 2026).
+
+Data: CC BY 4.0, free to reuse with a credit — *Bet Better (https://betbetter.world)*.
+
+Model estimates, not betting advice. 18+. Gamble responsibly.

data/lib/betbetter/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Betbetter
+  VERSION = "1.0.0"
+end

data/lib/betbetter.rb

@@ -0,0 +1,179 @@
+# frozen_string_literal: true
+
+# betbetter - zero-dependency Ruby client for the free Bet Better sports model API.
+#
+# Win probabilities, fair odds and plain-English verdicts for every selection the
+# Bet Better models publish. No API key required.
+#
+# Data licence: CC BY 4.0 - free to reuse with a credit to Bet Better
+# (https://betbetter.world). Model estimates, not betting advice. 18+.
+#
+#   require "betbetter"
+#   feed = Betbetter.get_picks("nba")
+#   feed["picks"].first(3).each { |p| puts "#{p['game']} - #{p['selection']} (#{p['confidence']})" }
+
+require "net/http"
+require "uri"
+require "json"
+
+require_relative "betbetter/version"
+
+module Betbetter
+  BASE_URL = "https://betbetter.world"
+  USER_AGENT = "betbetter-ruby/#{VERSION}"
+
+  # League path segments accepted by the API (the `league` enum in the OpenAPI
+  # spec). Soccer and tennis use two segments.
+  LEAGUES = %w[
+    afl mlb nba nfl nhl ncaaf nrl ufc wnba cricket
+    tennis/atp tennis/wta
+    soccer/epl soccer/la-liga soccer/serie-a soccer/bundesliga
+    soccer/ligue-1 soccer/world-cup
+  ].freeze
+
+  # Sports served by /predicted-scores.
+  SCORE_SPORTS = %w[
+    nfl ncaaf nba ncaab mlb nhl afl nrl wnba soccer cricket
+  ].freeze
+
+  # Raised when the API returns a non-200 response.
+  class Error < StandardError; end
+
+  class << self
+    # The leagues this API serves.
+    # @return [Array<String>]
+    def list_leagues
+      LEAGUES.dup
+    end
+
+    # Combined picks feed (game lines + player props) for a league.
+    # Each pick carries game, gameTimeUtc, market, selection, line,
+    # winProbabilityPct, fairOdds, confidence (HIGH / LEAN / LONG-SHOT) and a
+    # dated verdict.
+    # @return [Hash]
+    def get_picks(league)
+      get_json("/#{check_league(league)}/picks")
+    end
+
+    # Game-line selections only for a league.
+    # @return [Hash]
+    def get_best_bets(league)
+      get_json("/#{check_league(league)}/best-bets")
+    end
+
+    # Player-prop selections only for a league.
+    # @return [Hash]
+    def get_prop_bets(league)
+      get_json("/#{check_league(league)}/prop-bets")
+    end
+
+    # The settled record - wins and losses - with hit rate and ROI by sport.
+    # @return [Hash]
+    def get_results
+      get_json("/results")
+    end
+
+    # Settled model performance by sport and market (hit rate, ROI, CLV).
+    # @return [Hash]
+    def get_scorecard
+      get_json("/scorecard")
+    end
+
+    # Predicted final scores for every game the model prices in a sport.
+    # Served as CSV; parsed here into an array of row hashes with numeric
+    # values where the column is numeric.
+    # @return [Array<Hash>]
+    def get_predicted_scores(sport)
+      s = normalise(sport)
+      text = fetch("/predicted-scores/#{s}", "csv", "text/csv")
+      parse_csv(text)
+    end
+
+    private
+
+    def normalise(value)
+      value.to_s.strip.gsub(%r{\A/+|/+\z}, "").downcase
+    end
+
+    def check_league(league)
+      lg = normalise(league)
+      unless LEAGUES.include?(lg)
+        raise ArgumentError, "Unknown league #{league.inspect}. Valid options: #{LEAGUES.join(', ')}"
+      end
+
+      lg
+    end
+
+    def get_json(path)
+      JSON.parse(fetch(path, "json", "application/json"))
+    end
+
+    def fetch(path, format, accept)
+      uri = URI.parse("#{BASE_URL}#{path}?format=#{format}")
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https",
+                                 open_timeout: 15, read_timeout: 30) do |http|
+        http.request(Net::HTTP::Get.new(uri, "User-Agent" => USER_AGENT, "Accept" => accept))
+      end
+      unless response.is_a?(Net::HTTPSuccess)
+        raise Error, "betbetter: HTTP #{response.code} for #{path}"
+      end
+
+      response.body.to_s.force_encoding(Encoding::UTF_8)
+    end
+
+    # Minimal RFC4180-ish parser - enough for this feed (quoted fields may hold
+    # commas and doubled quotes), so the gem stays standard-library only.
+    def parse_csv(text)
+      lines = text.split(/\r?\n/).reject { |l| l.empty? || l.start_with?("#") }
+      return [] if lines.length < 2
+
+      header = split_row(lines[0])
+      lines[1..].map do |line|
+        values = split_row(line)
+        row = {}
+        header.each_with_index { |col, i| row[col] = coerce(values[i]) }
+        row
+      end
+    end
+
+    def split_row(line)
+      fields = []
+      field = +""
+      in_quotes = false
+      i = 0
+      while i < line.length
+        ch = line[i]
+        if in_quotes
+          if ch == '"'
+            if line[i + 1] == '"'
+              field << '"'
+              i += 1
+            else
+              in_quotes = false
+            end
+          else
+            field << ch
+          end
+        elsif ch == '"'
+          in_quotes = true
+        elsif ch == ","
+          fields << field
+          field = +""
+        else
+          field << ch
+        end
+        i += 1
+      end
+      fields << field
+      fields
+    end
+
+    def coerce(value)
+      return nil if value.nil? || value.empty?
+      return Integer(value) if value.match?(/\A-?\d+\z/)
+      return Float(value) if value.match?(/\A-?\d*\.\d+([eE][-+]?\d+)?\z/)
+
+      value
+    end
+  end
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: betbetter
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Edward Glush
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-09-25 00:00:00.000000000 Z
+dependencies: []
+description: Win probabilities, fair odds and plain-English verdicts for every selection
+  the Bet Better models publish, across 12 sports. No API key. Data licensed CC BY
+  4.0. Model estimates, not betting advice. 18+.
+email:
+- edward@betbetter.world
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/betbetter.rb
+- lib/betbetter/version.rb
+homepage: https://gitlab.com/betbetterworld/betbetter-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://gitlab.com/betbetterworld/betbetter-ruby
+  source_code_uri: https://gitlab.com/betbetterworld/betbetter-ruby
+  bug_tracker_uri: https://gitlab.com/betbetterworld/betbetter-ruby/-/issues
+  documentation_uri: https://betbetter.world/api
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Zero-dependency Ruby client for the free Bet Better sports model API.
+test_files: []