whop_sdk 0.0.39 → 0.0.40

data/rbi/whop_sdk/resources/accounts.rbi

@@ -0,0 +1,137 @@
+# typed: strong
+
+module WhopSDK
+  module Resources
+    class Accounts
+      # Creates an account. User tokens create business accounts; business account API
+      # keys create connected accounts.
+      sig do
+        params(
+          email: String,
+          metadata: T::Hash[Symbol, T.anything],
+          request_options: WhopSDK::RequestOptions::OrHash
+        ).returns(WhopSDK::Account)
+      end
+      def create(
+        # The email address of the account owner. Required for business account API key
+        # requests.
+        email: nil,
+        # Arbitrary key/value metadata to store on the account.
+        metadata: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieves a single account visible to the credential, including its crypto
+      # wallet.
+      sig do
+        params(
+          account_id: String,
+          request_options: WhopSDK::RequestOptions::OrHash
+        ).returns(WhopSDK::Account)
+      end
+      def retrieve(
+        # The ID of the account, which will look like biz\_******\*******
+        account_id,
+        request_options: {}
+      )
+      end
+
+      # Updates an account. User tokens can update business accounts; business account
+      # API keys can update connected accounts.
+      sig do
+        params(
+          account_id: String,
+          affiliate_application_required: T::Boolean,
+          affiliate_instructions: T.nilable(String),
+          banner_image: T.nilable(T::Hash[Symbol, T.anything]),
+          business_type: T.nilable(String),
+          description: T.nilable(String),
+          featured_affiliate_product_id: T.nilable(String),
+          industry_group: T.nilable(String),
+          industry_type: T.nilable(String),
+          logo: T.nilable(T::Hash[Symbol, T.anything]),
+          metadata: T::Hash[Symbol, T.anything],
+          route: T.nilable(String),
+          send_customer_emails: T::Boolean,
+          social_links: T::Array[T::Hash[Symbol, T.anything]],
+          target_audience: T.nilable(String),
+          title: T.nilable(String),
+          request_options: WhopSDK::RequestOptions::OrHash
+        ).returns(WhopSDK::Account)
+      end
+      def update(
+        # The ID of the account, which will look like biz\_******\*******
+        account_id,
+        # Whether prospective affiliates must submit an application before promoting this
+        # account.
+        affiliate_application_required: nil,
+        # Guidelines shown to affiliates promoting this account.
+        affiliate_instructions: nil,
+        # Attachment input for the account banner image.
+        banner_image: nil,
+        # The high-level business category for the account.
+        business_type: nil,
+        # A promotional description for the account.
+        description: nil,
+        # The ID of the product to feature for affiliates. Pass null to clear.
+        featured_affiliate_product_id: nil,
+        # The industry group the account belongs to.
+        industry_group: nil,
+        # The specific industry vertical the account operates in.
+        industry_type: nil,
+        # Attachment input for the account logo.
+        logo: nil,
+        # Arbitrary key/value metadata to store on the account.
+        metadata: nil,
+        # The unique URL slug for the account.
+        route: nil,
+        # Whether Whop sends transactional emails to customers on behalf of this account.
+        send_customer_emails: nil,
+        # The full list of social links to display for the account.
+        social_links: nil,
+        # The target audience for this account.
+        target_audience: nil,
+        # The display name of the account.
+        title: nil,
+        request_options: {}
+      )
+      end
+
+      # Lists accounts visible to the credential. User tokens return the user's business
+      # accounts; business account API keys return the requesting business account and
+      # its connected accounts.
+      sig do
+        params(
+          page: Integer,
+          per: Integer,
+          request_options: WhopSDK::RequestOptions::OrHash
+        ).returns(WhopSDK::Models::AccountListResponse)
+      end
+      def list(
+        # The page number to retrieve
+        page: nil,
+        # The number of resources to return per page. There is a limit of 50 results per
+        # page.
+        per: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieves the business account associated with the current business account API
+      # key.
+      sig do
+        params(request_options: WhopSDK::RequestOptions::OrHash).returns(
+          WhopSDK::Account
+        )
+      end
+      def me(request_options: {})
+      end
+
+      # @api private
+      sig { params(client: WhopSDK::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/whop_sdk/resources/ad_campaigns.rbi

@@ -13,7 +13,7 @@ module WhopSDK
         params(
           id: String,
           request_options: WhopSDK::RequestOptions::OrHash
-        ).returns(WhopSDK::Models::AdCampaignRetrieveResponse)
+        ).returns(WhopSDK::AdCampaign)
       end
       def retrieve(
         # The unique identifier of the ad campaign.
@@ -32,7 +32,7 @@ module WhopSDK
           id: String,
           budget: T.nilable(Float),
           request_options: WhopSDK::RequestOptions::OrHash
-        ).returns(WhopSDK::Models::AdCampaignUpdateResponse)
+        ).returns(WhopSDK::AdCampaign)
       end
       def update(
         # The unique identifier of the ad campaign to update.
@@ -52,27 +52,27 @@ module WhopSDK
       # - `ad_campaign:basic:read`
       sig do
         params(
-          company_id: String,
           after: T.nilable(String),
           before: T.nilable(String),
+          company_id: T.nilable(String),
           created_after: T.nilable(Time),
           created_before: T.nilable(Time),
           first: T.nilable(Integer),
           last: T.nilable(Integer),
           query: T.nilable(String),
-          status: T.nilable(WhopSDK::AdCampaignListParams::Status::OrSymbol),
+          status: T.nilable(WhopSDK::AdCampaignStatus::OrSymbol),
           request_options: WhopSDK::RequestOptions::OrHash
         ).returns(
           WhopSDK::Internal::CursorPage[WhopSDK::Models::AdCampaignListResponse]
         )
       end
       def list(
-        # The unique identifier of the company to list ad campaigns for.
-        company_id:,
         # Returns the elements in the list that come after the specified cursor.
         after: nil,
         # Returns the elements in the list that come before the specified cursor.
         before: nil,
+        # The unique identifier of the company to list ad campaigns for.
+        company_id: nil,
         # Only return ad campaigns created after this timestamp.
         created_after: nil,
         # Only return ad campaigns created before this timestamp.
@@ -98,7 +98,7 @@ module WhopSDK
         params(
           id: String,
           request_options: WhopSDK::RequestOptions::OrHash
-        ).returns(WhopSDK::Models::AdCampaignPauseResponse)
+        ).returns(WhopSDK::AdCampaign)
       end
       def pause(
         # The unique identifier of the ad campaign to pause.
@@ -116,7 +116,7 @@ module WhopSDK
         params(
           id: String,
           request_options: WhopSDK::RequestOptions::OrHash
-        ).returns(WhopSDK::Models::AdCampaignUnpauseResponse)
+        ).returns(WhopSDK::AdCampaign)
       end
       def unpause(
         # The unique identifier of the ad campaign to unpause.

data/rbi/whop_sdk/resources/ad_groups.rbi

@@ -13,7 +13,7 @@ module WhopSDK
         params(
           id: String,
           request_options: WhopSDK::RequestOptions::OrHash
-        ).returns(WhopSDK::Models::AdGroupRetrieveResponse)
+        ).returns(WhopSDK::AdGroup)
       end
       def retrieve(
         # The unique identifier of the ad group.
@@ -32,16 +32,15 @@ module WhopSDK
         params(
           id: String,
           budget: T.nilable(Float),
-          budget_type:
-            T.nilable(WhopSDK::AdGroupUpdateParams::BudgetType::OrSymbol),
+          budget_type: T.nilable(WhopSDK::AdBudgetType::OrSymbol),
           config: T.nilable(WhopSDK::AdGroupUpdateParams::Config::OrHash),
           daily_budget: T.nilable(Float),
           name: T.nilable(String),
           platform_config:
             T.nilable(WhopSDK::AdGroupUpdateParams::PlatformConfig::OrHash),
-          status: T.nilable(WhopSDK::AdGroupUpdateParams::Status::OrSymbol),
+          status: T.nilable(WhopSDK::AdGroupStatus::OrSymbol),
           request_options: WhopSDK::RequestOptions::OrHash
-        ).returns(WhopSDK::Models::AdGroupUpdateResponse)
+        ).returns(WhopSDK::AdGroup)
       end
       def update(
         # The unique identifier of the ad group to update.
@@ -79,9 +78,10 @@ module WhopSDK
           created_after: T.nilable(Time),
           created_before: T.nilable(Time),
           first: T.nilable(Integer),
+          include_paused: T.nilable(T::Boolean),
           last: T.nilable(Integer),
           query: T.nilable(String),
-          status: T.nilable(WhopSDK::AdGroupListParams::Status::OrSymbol),
+          status: T.nilable(WhopSDK::AdGroupStatus::OrSymbol),
           request_options: WhopSDK::RequestOptions::OrHash
         ).returns(
           WhopSDK::Internal::CursorPage[WhopSDK::Models::AdGroupListResponse]
@@ -102,6 +102,9 @@ module WhopSDK
         created_before: nil,
         # Returns the first _n_ elements from the list.
         first: nil,
+        # When false, excludes paused ad groups so pagination matches the dashboard's
+        # hide-paused toggle.
+        include_paused: nil,
         # Returns the last _n_ elements from the list.
         last: nil,
         # Case-insensitive substring match against the ad group name.
@@ -130,6 +133,44 @@ module WhopSDK
       )
       end
 
+      # Pauses an ad group.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:update`
+      # - `ad_campaign:basic:read`
+      sig do
+        params(
+          id: String,
+          request_options: WhopSDK::RequestOptions::OrHash
+        ).returns(WhopSDK::AdGroup)
+      end
+      def pause(
+        # The unique identifier of the ad group to pause.
+        id,
+        request_options: {}
+      )
+      end
+
+      # Resumes a paused ad group.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:update`
+      # - `ad_campaign:basic:read`
+      sig do
+        params(
+          id: String,
+          request_options: WhopSDK::RequestOptions::OrHash
+        ).returns(WhopSDK::AdGroup)
+      end
+      def unpause(
+        # The unique identifier of the ad group to unpause.
+        id,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: WhopSDK::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/whop_sdk/resources/ad_reports.rbi

@@ -4,9 +4,11 @@ module WhopSDK
   module Resources
     # Ad reports
     class AdReports
-      # Performance report for an ad campaign, ad group, or ad. Returns aggregate totals
-      # and an optional per-day breakdown. Exactly one of `adCampaignId`, `adGroupId`,
-      # or `adId` must be provided.
+      # Performance report for a company, ad campaign, ad group, or ad. Always returns
+      # aggregate `summary` totals. Set `granularity` (`daily`/`hourly`) to additionally
+      # get a time series, or set `breakdown` (`campaign`/`ad_group`/`ad`) to
+      # additionally get per-entity rows inside the requested scope. Exactly one of
+      # `companyId`, `adCampaignId`, `adGroupId`, or `adId` must be provided.
       #
       # Required permissions:
       #
@@ -18,8 +20,11 @@ module WhopSDK
           ad_campaign_id: T.nilable(String),
           ad_group_id: T.nilable(String),
           ad_id: T.nilable(String),
+          breakdown:
+            T.nilable(WhopSDK::AdReportRetrieveParams::Breakdown::OrSymbol),
+          company_id: T.nilable(String),
           currency: T.nilable(String),
-          include_daily: T.nilable(T::Boolean),
+          granularity: T.nilable(WhopSDK::Granularities::OrSymbol),
           request_options: WhopSDK::RequestOptions::OrHash
         ).returns(WhopSDK::Models::AdReportRetrieveResponse)
       end
@@ -28,20 +33,26 @@ module WhopSDK
         from:,
         # Inclusive end of the reporting window.
         to:,
-        # The unique identifier of an ad campaign. Mutually exclusive with `adGroupId` and
-        # `adId`.
+        # The unique identifier of an ad campaign. Mutually exclusive with `companyId`,
+        # `adGroupId`, and `adId`.
         ad_campaign_id: nil,
-        # The unique identifier of an ad group. Mutually exclusive with `adCampaignId` and
-        # `adId`.
+        # The unique identifier of an ad group. Mutually exclusive with `companyId`,
+        # `adCampaignId`, and `adId`.
         ad_group_id: nil,
-        # The unique identifier of an ad. Mutually exclusive with `adCampaignId` and
-        # `adGroupId`.
+        # The unique identifier of an ad. Mutually exclusive with `companyId`,
+        # `adCampaignId`, and `adGroupId`.
         ad_id: nil,
+        # Entity level to group an ad report by.
+        breakdown: nil,
+        # The unique identifier of a company. Mutually exclusive with `adCampaignId`,
+        # `adGroupId`, and `adId`. Use with `breakdown` to fan out across every campaign,
+        # ad group, or ad in the company without paging.
+        company_id: nil,
         # ISO 4217 currency code to report `spend` in. Defaults to the company's ads
         # reporting currency.
         currency: nil,
-        # When true, includes a per-day breakdown alongside the summary.
-        include_daily: nil,
+        # Bucket size for external ad stat rows.
+        granularity: nil,
         request_options: {}
       )
       end

data/rbi/whop_sdk/resources/ads.rbi

@@ -13,7 +13,7 @@ module WhopSDK
         params(
           id: String,
           request_options: WhopSDK::RequestOptions::OrHash
-        ).returns(WhopSDK::Models::AdRetrieveResponse)
+        ).returns(WhopSDK::Ad)
       end
       def retrieve(
         # The unique identifier of the ad.
@@ -37,8 +37,14 @@ module WhopSDK
           created_after: T.nilable(Time),
           created_before: T.nilable(Time),
           first: T.nilable(Integer),
+          include_paused: T.nilable(T::Boolean),
           last: T.nilable(Integer),
-          status: T.nilable(WhopSDK::AdListParams::Status::OrSymbol),
+          order_by: T.nilable(WhopSDK::AdListParams::OrderBy::OrSymbol),
+          order_direction: T.nilable(WhopSDK::Direction::OrSymbol),
+          query: T.nilable(String),
+          stats_from: T.nilable(Time),
+          stats_to: T.nilable(Time),
+          status: T.nilable(WhopSDK::ExternalAdStatus::OrSymbol),
           request_options: WhopSDK::RequestOptions::OrHash
         ).returns(
           WhopSDK::Internal::CursorPage[WhopSDK::Models::AdListResponse]
@@ -64,14 +70,65 @@ module WhopSDK
         created_before: nil,
         # Returns the first _n_ elements from the list.
         first: nil,
+        # When false, excludes paused ads so pagination matches the dashboard's
+        # hide-paused toggle.
+        include_paused: nil,
         # Returns the last _n_ elements from the list.
         last: nil,
+        # Columns that the listAds query can sort by.
+        order_by: nil,
+        # The direction of the sort.
+        order_direction: nil,
+        # Case-insensitive substring match against the ad title or tag.
+        query: nil,
+        # Start of the stats date range used when order_by is a stats column.
+        stats_from: nil,
+        # End of the stats date range used when order_by is a stats column.
+        stats_to: nil,
         # The status of an external ad.
         status: nil,
         request_options: {}
       )
       end
 
+      # Pauses an ad.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:update`
+      # - `ad_campaign:basic:read`
+      sig do
+        params(
+          id: String,
+          request_options: WhopSDK::RequestOptions::OrHash
+        ).returns(WhopSDK::Ad)
+      end
+      def pause(
+        # The unique identifier of the ad to pause.
+        id,
+        request_options: {}
+      )
+      end
+
+      # Resumes a paused ad.
+      #
+      # Required permissions:
+      #
+      # - `ad_campaign:update`
+      # - `ad_campaign:basic:read`
+      sig do
+        params(
+          id: String,
+          request_options: WhopSDK::RequestOptions::OrHash
+        ).returns(WhopSDK::Ad)
+      end
+      def unpause(
+        # The unique identifier of the ad to unpause.
+        id,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: WhopSDK::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/whop_sdk/resources/deposits.rbi

@@ -0,0 +1,41 @@
+# typed: strong
+
+module WhopSDK
+  module Resources
+    class Deposits
+      # Resolves a deposit destination and returns the on-chain addresses that can fund
+      # it.
+      sig do
+        params(
+          amount: Float,
+          destination:
+            T.any(
+              String,
+              WhopSDK::DepositCreateParams::Destination::UnionMember1::OrHash
+            ),
+          metadata: T::Hash[Symbol, T.anything],
+          network: T.nilable(String),
+          request_options: WhopSDK::RequestOptions::OrHash
+        ).returns(WhopSDK::Models::DepositCreateResponse)
+      end
+      def create(
+        # Amount to deposit.
+        amount:,
+        # Destination account ID or wallet address. Object form is supported for
+        # compatibility.
+        destination:,
+        # Arbitrary metadata echoed in the response.
+        metadata: nil,
+        # Optional destination network override.
+        network: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: WhopSDK::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/whop_sdk/resources/files.rbi

@@ -9,8 +9,7 @@ module WhopSDK
       sig do
         params(
           filename: String,
-          visibility:
-            T.nilable(WhopSDK::FileCreateParams::Visibility::OrSymbol),
+          visibility: T.nilable(WhopSDK::FileVisibility::OrSymbol),
           request_options: WhopSDK::RequestOptions::OrHash
         ).returns(WhopSDK::Models::FileCreateResponse)
       end

data/rbi/whop_sdk/resources/payments.rbi

@@ -85,6 +85,7 @@ module WhopSDK
           before: T.nilable(String),
           billing_reasons:
             T.nilable(T::Array[WhopSDK::BillingReasons::OrSymbol]),
+          checkout_configuration_ids: T.nilable(T::Array[String]),
           company_id: T.nilable(String),
           created_after: T.nilable(Time),
           created_before: T.nilable(Time),
@@ -114,6 +115,8 @@ module WhopSDK
         before: nil,
         # Filter payments by their billing reason.
         billing_reasons: nil,
+        # Only return payments from these checkout configurations.
+        checkout_configuration_ids: nil,
         # The unique identifier of the company to list payments for.
         company_id: nil,
         # Only return payments created after this timestamp.

data/rbi/whop_sdk/resources/plans.rbi

@@ -29,6 +29,7 @@ module WhopSDK
           initial_price: T.nilable(Float),
           internal_notes: T.nilable(String),
           legacy_payment_method_controls: T.nilable(T::Boolean),
+          metadata: T.nilable(T::Hash[Symbol, T.anything]),
           override_tax_type: T.nilable(WhopSDK::TaxType::OrSymbol),
           payment_method_configuration:
             T.nilable(
@@ -39,6 +40,8 @@ module WhopSDK
           renewal_price: T.nilable(Float),
           split_pay_required_payments: T.nilable(Integer),
           stock: T.nilable(Integer),
+          three_ds_level:
+            T.nilable(WhopSDK::PlanCreateParams::ThreeDSLevel::OrSymbol),
           title: T.nilable(String),
           trial_period_days: T.nilable(Integer),
           unlimited_stock: T.nilable(T::Boolean),
@@ -78,6 +81,10 @@ module WhopSDK
         internal_notes: nil,
         # Whether this plan uses legacy payment method controls.
         legacy_payment_method_controls: nil,
+        # Custom key-value pairs to store on the plan. Included in webhook payloads for
+        # payment and membership events. Max 50 keys, 500 chars per key, 5000 chars per
+        # value.
+        metadata: nil,
         # Whether or not the tax is included in a plan's price (or if it hasn't been set
         # up)
         override_tax_type: nil,
@@ -96,6 +103,8 @@ module WhopSDK
         # The maximum number of units available for purchase. Ignored when unlimited_stock
         # is true.
         stock: nil,
+        # The 3D Secure behavior for a plan.
+        three_ds_level: nil,
         # The display name of the plan shown to customers on the product page.
         title: nil,
         # The number of free trial days before the first charge on a recurring plan.
@@ -151,6 +160,7 @@ module WhopSDK
           initial_price: T.nilable(Float),
           internal_notes: T.nilable(String),
           legacy_payment_method_controls: T.nilable(T::Boolean),
+          metadata: T.nilable(T::Hash[Symbol, T.anything]),
           offer_cancel_discount: T.nilable(T::Boolean),
           override_tax_type: T.nilable(WhopSDK::TaxType::OrSymbol),
           payment_method_configuration:
@@ -161,6 +171,8 @@ module WhopSDK
           stock: T.nilable(Integer),
           strike_through_initial_price: T.nilable(Float),
           strike_through_renewal_price: T.nilable(Float),
+          three_ds_level:
+            T.nilable(WhopSDK::PlanUpdateParams::ThreeDSLevel::OrSymbol),
           title: T.nilable(String),
           trial_period_days: T.nilable(Integer),
           unlimited_stock: T.nilable(T::Boolean),
@@ -197,6 +209,10 @@ module WhopSDK
         internal_notes: nil,
         # Whether this plan uses legacy payment method controls.
         legacy_payment_method_controls: nil,
+        # Custom key-value pairs to store on the plan. Included in webhook payloads for
+        # payment and membership events. Max 50 keys, 500 chars per key, 5000 chars per
+        # value.
+        metadata: nil,
         # Whether to offer a retention discount when a customer attempts to cancel.
         offer_cancel_discount: nil,
         # Whether or not the tax is included in a plan's price (or if it hasn't been set
@@ -217,6 +233,8 @@ module WhopSDK
         # A comparison price displayed with a strikethrough for the renewal price.
         # Provided in the plan's currency (e.g., 19.99 for $19.99).
         strike_through_renewal_price: nil,
+        # The 3D Secure behavior for a plan.
+        three_ds_level: nil,
         # The display name of the plan shown to customers on the product page.
         title: nil,
         # The number of free trial days before the first charge on a recurring plan.

data/rbi/whop_sdk/resources/products.rbi

@@ -28,6 +28,7 @@ module WhopSDK
           member_affiliate_percentage: T.nilable(Float),
           member_affiliate_status:
             T.nilable(WhopSDK::GlobalAffiliateStatus::OrSymbol),
+          metadata: T.nilable(T::Hash[Symbol, T.anything]),
           plan_options:
             T.nilable(WhopSDK::ProductCreateParams::PlanOptions::OrHash),
           product_tax_code_id: T.nilable(String),
@@ -70,6 +71,10 @@ module WhopSDK
         member_affiliate_percentage: nil,
         # The different statuses of the global affiliate program for a product.
         member_affiliate_status: nil,
+        # Custom key-value pairs to store on the product. Included in webhook payloads for
+        # payment and membership events. Max 50 keys, 500 chars per key, 5000 chars per
+        # value.
+        metadata: nil,
         # Configuration for an automatically generated plan to attach to this product.
         plan_options: nil,
         # The unique identifier of the tax classification code to apply to this product.
@@ -130,6 +135,7 @@ module WhopSDK
           member_affiliate_percentage: T.nilable(Float),
           member_affiliate_status:
             T.nilable(WhopSDK::GlobalAffiliateStatus::OrSymbol),
+          metadata: T.nilable(T::Hash[Symbol, T.anything]),
           product_tax_code_id: T.nilable(String),
           redirect_purchase_url: T.nilable(String),
           route: T.nilable(String),
@@ -171,6 +177,10 @@ module WhopSDK
         member_affiliate_percentage: nil,
         # The different statuses of the global affiliate program for a product.
         member_affiliate_status: nil,
+        # Custom key-value pairs to store on the product. Included in webhook payloads for
+        # payment and membership events. Max 50 keys, 500 chars per key, 5000 chars per
+        # value.
+        metadata: nil,
         # The unique identifier of the tax classification code to apply to this product.
         product_tax_code_id: nil,
         # A URL to redirect the customer to after completing a purchase.

data/rbi/whop_sdk/resources/refunds.rbi

@@ -9,6 +9,8 @@ module WhopSDK
       # Required permissions:
       #
       # - `payment:basic:read`
+      # - `plan:basic:read`
+      # - `access_pass:basic:read`
       # - `member:email:read`
       # - `member:basic:read`
       # - `member:phone:read`

data/rbi/whop_sdk/resources/swaps.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module WhopSDK
+  module Resources
+    class Swaps
+      # Returns a stateless swap price preview. No funds move and nothing is persisted.
+      sig do
+        params(
+          amount: String,
+          from_token: String,
+          to_token: String,
+          from_address: T.nilable(String),
+          from_chain:
+            T.nilable(WhopSDK::SwapCreateQuoteParams::FromChain::Variants),
+          metadata: T::Hash[Symbol, T.anything],
+          slippage_bps: T.nilable(Integer),
+          to_address: T.nilable(String),
+          to_chain:
+            T.nilable(WhopSDK::SwapCreateQuoteParams::ToChain::Variants),
+          request_options: WhopSDK::RequestOptions::OrHash
+        ).returns(WhopSDK::Models::SwapCreateQuoteResponse)
+      end
+      def create_quote(
+        # Input token amount.
+        amount:,
+        # Source token contract address.
+        from_token:,
+        # Destination token contract address.
+        to_token:,
+        from_address: nil,
+        from_chain: nil,
+        metadata: nil,
+        slippage_bps: nil,
+        to_address: nil,
+        to_chain: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: WhopSDK::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end