feat: adds search endpoints

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    kalshi (0.0.1)
+    kalshi (0.0.2)
       dry-cli
       dry-configurable
       dry-container
@@ -230,7 +230,7 @@ CHECKSUMS
   httpx (1.7.0) sha256=e219689555951f9c13c40862da120cdd2535e1454189bed589f04d7059557154
   io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
   json (2.18.0) sha256=b10506aee4183f5cf49e0efc48073d7b75843ce3782c68dbeb763351c08fd505
-  kalshi (0.0.1)
+  kalshi (0.0.2)
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
   lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
   logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203

Readme.adoc

@@ -156,6 +156,32 @@ candlesticks = client.market.candlesticks.batch(
 )
 ----
 
+=== Search
+
+Access Search endpoints via the `search` namespace.
+
+==== Tags by Category
+
+https://docs.kalshi.com/api-reference/search/get-tags-for-series-categories[API Reference]
+
+Get tags organized by series categories:
+
+[source,ruby]
+----
+tags = client.search.tags_by_category
+----
+
+==== Filters by Sport
+
+https://docs.kalshi.com/api-reference/search/get-filters-for-sports[API Reference]
+
+Get filters organized by sport:
+
+[source,ruby]
+----
+filters = client.search.filters_by_sport
+----
+
 === WebSocket Client
 
 A raw WebSocket client is included in `bin/wss-raw` for testing connection and subscription.

lib/kalshi/api_client.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Rubyists
+  module Kalshi
+    # API Client Base Class
+    class ApiClient
+      attr_reader :client
+
+      def initialize(client)
+        @client = client
+      end
+    end
+  end
+end

lib/kalshi/client.rb

@@ -28,6 +28,10 @@ def market
         @market ||= Market::Client.new(clone)
       end
 
+      def search
+        @search ||= Search::Client.new(clone)
+      end
+
       private
 
       def full_url(path)

lib/kalshi/search/client.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Rubyists
+  module Kalshi
+    module Search
+      # Search API Client
+      class Client < ApiClient
+        def tags_by_categories
+          SeriesTags.new(client).all
+        end
+
+        def filters_by_sports
+          SportsFilters.new(client).all
+        end
+      end
+    end
+  end
+end

lib/kalshi/search/series_tags.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Rubyists
+  module Kalshi
+    module Search
+      # Series Tags API endpoint
+      class SeriesTags < Kalshi::Endpoint
+        def all
+          client.get('search/tags_by_categories')
+        end
+      end
+    end
+  end
+end

lib/kalshi/search/sports_filters.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Rubyists
+  module Kalshi
+    module Search
+      # Sports Filters API endpoint
+      class SportsFilters < Kalshi::Endpoint
+        def all
+          client.get('search/filters_by_sports')
+        end
+      end
+    end
+  end
+end

test/kalshi/client_test.rb

@@ -25,6 +25,14 @@
       assert_instance_of Rubyists::Kalshi::Market::Client, client.market
     end
   end
+
+  describe '#search' do
+    it 'returns a Search::Client instance' do
+      client = Rubyists::Kalshi::Client.new
+
+      assert_instance_of Rubyists::Kalshi::Search::Client, client.search
+    end
+  end
 end
 
 describe Rubyists::Kalshi do

test/kalshi/search/client_test.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative '../../helper'
+
+describe Rubyists::Kalshi::Search::Client do
+  let(:client) { Rubyists::Kalshi::Client.new }
+  let(:search_client) { client.search }
+  let(:base_url) { Rubyists::Kalshi.config.base_url }
+
+  describe '#tags_by_categories' do
+    it 'fetches tags by categories' do
+      stub_request(:get, "#{base_url}/search/tags_by_categories")
+        .to_return(status: 200, body: '{"tags_by_categories": {}}', headers: { 'Content-Type' => 'application/json' })
+
+      response = search_client.tags_by_categories
+
+      assert_equal({ tags_by_categories: {} }, response)
+    end
+  end
+
+  describe '#filters_by_sports' do
+    it 'fetches filters by sports' do
+      stub_request(:get, "#{base_url}/search/filters_by_sports")
+        .to_return(status: 200, body: '{"filters_by_sports": {}}', headers: { 'Content-Type' => 'application/json' })
+
+      response = search_client.filters_by_sports
+
+      assert_equal({ filters_by_sports: {} }, response)
+    end
+  end
+end