peddler 3.0.0.beta1 → 4.0.0

data/lib/peddler/{api → apis}/fba_inventory_v1.rb

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def fba_inventory_v1(...)
+      APIs::FBAInventoryV1.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for FBA Inventory
     #
     # The Selling Partner API for FBA Inventory lets you programmatically retrieve information about inventory in
@@ -19,30 +25,28 @@ module Peddler
       # sellerSkus. The sellerSku parameter is ignored. - When the sellerSku parameter is provided, the operation
       # returns inventory summaries for only the specified sellerSku. Note: The parameters associated with this
       # operation may contain special characters that must be encoded to successfully call the API. To avoid errors with
-      # SKUs when encoding URLs, refer to URL Encoding. Usage Plan: | Rate (requests per second) | Burst | | ---- | ----
-      # | | 2 | 2 | The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to
-      # the requested operation, when available. The table above indicates the default rate and burst values for this
-      # operation. Selling partners whose business demands require higher throughput may see higher rate and burst
-      # values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.
+      # SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).
       #
-      # @param [Boolean] details true to return inventory summaries with additional summarized inventory details and
+      # @note This operation can make a dynamic sandbox call.
+      # @param details [Boolean] true to return inventory summaries with additional summarized inventory details and
       #   quantities. Otherwise, returns inventory summaries only (default value).
-      # @param [String] granularity_type The granularity type for the inventory aggregation level.
-      # @param [String] granularity_id The granularity ID for the inventory aggregation level.
-      # @param [String] start_date_time A start date and time in ISO8601 format. If specified, all inventory summaries
+      # @param granularity_type [String] The granularity type for the inventory aggregation level.
+      # @param granularity_id [String] The granularity ID for the inventory aggregation level.
+      # @param start_date_time [String] A start date and time in ISO8601 format. If specified, all inventory summaries
       #   that have changed since then are returned. You must specify a date and time that is no earlier than 18 months
       #   prior to the date and time when you call the API. Note: Changes in inboundWorkingQuantity,
       #   inboundShippedQuantity and inboundReceivingQuantity are not detected.
-      # @param [Array<String>] seller_skus A list of seller SKUs for which to return inventory summaries. You may
+      # @param seller_skus [Array<String>] A list of seller SKUs for which to return inventory summaries. You may
       #   specify up to 50 SKUs.
-      # @param [String] seller_sku A single seller SKU used for querying the specified seller SKU inventory summaries.
-      # @param [String] next_token String token returned in the response of your previous request. The string token will
+      # @param seller_sku [String] A single seller SKU used for querying the specified seller SKU inventory summaries.
+      # @param next_token [String] String token returned in the response of your previous request. The string token will
       #   expire 30 seconds after being created.
-      # @param [Array<String>] marketplace_ids The marketplace ID for the marketplace for which to return inventory
+      # @param marketplace_ids [Array<String>] The marketplace ID for the marketplace for which to return inventory
       #   summaries.
-      # @return [Hash] The API response
-      def get_inventory_summaries(granularity_type, granularity_id, marketplace_ids, details: nil,
-        start_date_time: nil, seller_skus: nil, seller_sku: nil, next_token: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_inventory_summaries(granularity_type, granularity_id, marketplace_ids, details: nil, start_date_time: nil,
+        seller_skus: nil, seller_sku: nil, next_token: nil, rate_limit: 2.0)
         path = "/fba/inventory/v1/summaries"
         params = {
           "details" => details,
@@ -55,16 +59,20 @@ module Peddler
           "marketplaceIds" => marketplace_ids,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Requests that Amazon create product-details in the Sandbox Inventory in the sandbox environment. This is a
       # sandbox-only operation and must be directed to a sandbox endpoint. Refer to [Selling Partner API
       # sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more information.
       #
-      # @param [Hash] create_inventory_item_request_body CreateInventoryItem Request Body Parameter.
-      # @return [Hash] The API response
-      def create_inventory_item(create_inventory_item_request_body)
+      # @note This operation can make a dynamic sandbox call.
+      # @param create_inventory_item_request_body [Hash] CreateInventoryItem Request Body Parameter.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_inventory_item(create_inventory_item_request_body, rate_limit: nil)
+        must_sandbox!
+
         path = "/fba/inventory/v1/items"
         body = create_inventory_item_request_body
 
@@ -75,10 +83,14 @@ module Peddler
       # sandbox-only operation and must be directed to a sandbox endpoint. Refer to [Selling Partner API
       # sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more information.
       #
-      # @param [String] seller_sku A single seller SKU used for querying the specified seller SKU inventory summaries.
-      # @param [String] marketplace_id The marketplace ID for the marketplace for which the sellerSku is to be deleted.
-      # @return [Hash] The API response
-      def delete_inventory_item(seller_sku, marketplace_id)
+      # @note This operation can make a dynamic sandbox call.
+      # @param seller_sku [String] A single seller SKU used for querying the specified seller SKU inventory summaries.
+      # @param marketplace_id [String] The marketplace ID for the marketplace for which the sellerSku is to be deleted.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def delete_inventory_item(seller_sku, marketplace_id, rate_limit: nil)
+        must_sandbox!
+
         path = "/fba/inventory/v1/items/#{seller_sku}"
         params = {
           "marketplaceId" => marketplace_id,
@@ -92,10 +104,14 @@ module Peddler
       # Partner API sandbox](https://developer-docs.amazon.com/sp-api/docs/the-selling-partner-api-sandbox) for more
       # information.
       #
-      # @param [String] x_amzn_idempotency_token A unique token/requestId provided with each call to ensure idempotency.
-      # @param [Hash] add_inventory_request_body List of items to add to Sandbox inventory.
-      # @return [Hash] The API response
-      def add_inventory(x_amzn_idempotency_token, add_inventory_request_body)
+      # @note This operation can make a dynamic sandbox call.
+      # @param x_amzn_idempotency_token [String] A unique token/requestId provided with each call to ensure idempotency.
+      # @param add_inventory_request_body [Hash] List of items to add to Sandbox inventory.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def add_inventory(x_amzn_idempotency_token, add_inventory_request_body, rate_limit: nil)
+        must_sandbox!
+
         path = "/fba/inventory/v1/items/inventory"
         body = add_inventory_request_body
 

data/lib/peddler/{api → apis}/feeds_2021_06_30.rb

@@ -1,33 +1,44 @@
 # frozen_string_literal: true
 
 require "peddler/api"
+require "peddler/helpers/feeds_2021_06_30"
 
 module Peddler
-  class API
-    # Selling Partner API for Feeds
+  class << self
+    def feeds_2021_06_30(...)
+      APIs::Feeds20210630.new(...)
+    end
+  end
+
+  module APIs
+    # Feeds v2021-06-30
     #
     # The Selling Partner API for Feeds lets you upload data to Amazon on behalf of a selling partner.
     class Feeds20210630 < API
+      include Peddler::Helpers::Feeds20210630
+
       # Returns feed details for the feeds that match the filters that you specify.
       #
-      # @param [Array<String>] feed_types A list of feed types used to filter feeds. When feedTypes is provided, the
+      # @note This operation can make a static sandbox call.
+      # @param feed_types [Array<String>] A list of feed types used to filter feeds. When feedTypes is provided, the
       #   other filter parameters (processingStatuses, marketplaceIds, createdSince, createdUntil) and pageSize may also
       #   be provided. Either feedTypes or nextToken is required.
-      # @param [Array<String>] marketplace_ids A list of marketplace identifiers used to filter feeds. The feeds
+      # @param marketplace_ids [Array<String>] A list of marketplace identifiers used to filter feeds. The feeds
       #   returned will match at least one of the marketplaces that you specify.
-      # @param [Integer] page_size The maximum number of feeds to return in a single call.
-      # @param [Array<String>] processing_statuses A list of processing statuses used to filter feeds.
-      # @param [String] created_since The earliest feed creation date and time for feeds included in the response, in
+      # @param page_size [Integer] The maximum number of feeds to return in a single call.
+      # @param processing_statuses [Array<String>] A list of processing statuses used to filter feeds.
+      # @param created_since [String] The earliest feed creation date and time for feeds included in the response, in
       #   ISO 8601 format. The default is 90 days ago. Feeds are retained for a maximum of 90 days.
-      # @param [String] created_until The latest feed creation date and time for feeds included in the response, in ISO
+      # @param created_until [String] The latest feed creation date and time for feeds included in the response, in ISO
       #   8601 format. The default is now.
-      # @param [String] next_token A string token returned in the response to your previous request. nextToken is
+      # @param next_token [String] A string token returned in the response to your previous request. nextToken is
       #   returned when the number of results exceeds the specified pageSize value. To get the next page of results,
       #   call the getFeeds operation and include this token as the only parameter. Specifying nextToken with any other
       #   parameters will cause the request to fail.
-      # @return [Hash] The API response
-      def get_feeds(feed_types: nil, marketplace_ids: nil, page_size: nil, processing_statuses: nil,
-        created_since: nil, created_until: nil, next_token: nil)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_feeds(feed_types: nil, marketplace_ids: nil, page_size: 10, processing_statuses: nil, created_since: nil,
+        created_until: nil, next_token: nil, rate_limit: 0.0222)
         path = "/feeds/2021-06-30/feeds"
         params = {
           "feedTypes" => feed_types,
@@ -39,17 +50,19 @@ module Peddler
           "nextToken" => next_token,
         }.compact
 
-        rate_limit(0.0222).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Creates a feed. Upload the contents of the feed document before calling this operation.
       #
-      # @param [Hash] body Information required to create the feed.
-      # @return [Hash] The API response
-      def create_feed(body)
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] Information required to create the feed.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_feed(body, rate_limit: 0.0083)
         path = "/feeds/2021-06-30/feeds"
 
-        rate_limit(0.0083).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Cancels the feed that you specify. Only feeds with `processingStatus=IN_QUEUE` can be cancelled. Cancelled feeds
@@ -57,24 +70,28 @@ module Peddler
       # [`getFeed`](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference#getfeed) and
       # [`getFeeds`](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference#getfeeds) operations.
       #
-      # @param [String] feed_id The identifier for the feed. This identifier is unique only in combination with a seller
+      # @note This operation can make a static sandbox call.
+      # @param feed_id [String] The identifier for the feed. This identifier is unique only in combination with a seller
       #   ID.
-      # @return [Hash] The API response
-      def cancel_feed(feed_id)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def cancel_feed(feed_id, rate_limit: 2.0)
         path = "/feeds/2021-06-30/feeds/#{feed_id}"
 
-        rate_limit(2.0).delete(path)
+        meter(rate_limit).delete(path)
       end
 
       # Returns feed details (including the `resultDocumentId`, if available) for the feed that you specify.
       #
-      # @param [String] feed_id The identifier for the feed. This identifier is unique only in combination with a seller
+      # @note This operation can make a static sandbox call.
+      # @param feed_id [String] The identifier for the feed. This identifier is unique only in combination with a seller
       #   ID.
-      # @return [Hash] The API response
-      def get_feed(feed_id)
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_feed(feed_id, rate_limit: 2.0)
         path = "/feeds/2021-06-30/feeds/#{feed_id}"
 
-        rate_limit(2.0).get(path)
+        meter(rate_limit).get(path)
       end
 
       # Creates a feed document for the feed type that you specify. This operation returns a presigned URL for uploading
@@ -82,22 +99,26 @@ module Peddler
       # to the [`createFeed`](https://developer-docs.amazon.com/sp-api/docs/feeds-api-v2021-06-30-reference#createfeed)
       # operation.
       #
-      # @param [Hash] body Specifies the content type for the createFeedDocument operation.
-      # @return [Hash] The API response
-      def create_feed_document(body)
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] Specifies the content type for the createFeedDocument operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def create_feed_document(body, rate_limit: 0.5)
         path = "/feeds/2021-06-30/documents"
 
-        rate_limit(0.5).post(path, body:)
+        meter(rate_limit).post(path, body:)
       end
 
       # Returns the information required for retrieving a feed document's contents.
       #
-      # @param [String] feed_document_id The identifier of the feed document.
-      # @return [Hash] The API response
-      def get_feed_document(feed_document_id)
+      # @note This operation can make a static sandbox call.
+      # @param feed_document_id [String] The identifier of the feed document.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def get_feed_document(feed_document_id, rate_limit: 0.0222)
         path = "/feeds/2021-06-30/documents/#{feed_document_id}"
 
-        rate_limit(0.0222).get(path)
+        meter(rate_limit).get(path)
       end
     end
   end

data/lib/peddler/apis/finances_2024_06_19.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def finances_2024_06_19(...)
+      APIs::Finances20240619.new(...)
+    end
+  end
+
+  module APIs
+    # The Selling Partner API for Finances
+    #
+    # The Selling Partner API for Finances provides financial information relevant to a seller's business. You can
+    # obtain financial events for a given order or date range without having to wait until a statement period closes.
+    class Finances20240619 < API
+      # Returns transactions for the given parameters. Orders from the last 48 hours might not be included in financial
+      # events.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param posted_after [String] The response includes financial events posted after (or on) this date. This date
+      #   must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format. The date-time
+      #   must be more than two minutes before the time of the request.
+      # @param posted_before [String] The response includes financial events posted before (but not on) this date. This
+      #   date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format. The
+      #   date-time must be later than `PostedAfter` and more than two minutes before the request was submitted. If
+      #   `PostedAfter` and `PostedBefore` are more than 180 days apart, the response is empty. **Default:** Two minutes
+      #   before the time of the request.
+      # @param marketplace_id [String] The ID of the marketplace from which you want to retrieve transactions.
+      # @param next_token [String] The response includes `nextToken` when the number of results exceeds the specified
+      #   `pageSize` value. To get the next page of results, call the operation with this token and include the same
+      #   arguments as the call that produced the token. To get a complete list, call this operation until `nextToken`
+      #   is null. Note that this operation can return empty pages.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def list_transactions(posted_after, posted_before: nil, marketplace_id: nil, next_token: nil, rate_limit: 0.5)
+        path = "/finances/2024-06-19/transactions"
+        params = {
+          "postedAfter" => posted_after,
+          "postedBefore" => posted_before,
+          "marketplaceId" => marketplace_id,
+          "nextToken" => next_token,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/{api → apis}/finances_v0.rb

@@ -3,7 +3,13 @@
 require "peddler/api"
 
 module Peddler
-  class API
+  class << self
+    def finances_v0(...)
+      APIs::FinancesV0.new(...)
+    end
+  end
+
+  module APIs
     # Selling Partner API for Finances
     #
     # The Selling Partner API for Finances helps you obtain financial information relevant to a seller's business. You
@@ -13,21 +19,23 @@ module Peddler
       # Returns financial event groups for a given date range. It may take up to 48 hours for orders to appear in your
       # financial events.
       #
-      # @param [Integer] max_results_per_page The maximum number of results to return per page. If the response exceeds
+      # @note This operation can make a static sandbox call.
+      # @param max_results_per_page [Integer] The maximum number of results to return per page. If the response exceeds
       #   the maximum number of transactions or 10 MB, the API responds with 'InvalidInput'.
-      # @param [String] financial_event_group_started_before A date used for selecting financial event groups that
+      # @param financial_event_group_started_before [String] A date used for selecting financial event groups that
       #   opened before (but not at) a specified date and time, in [ISO
       #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format. The date-time must be later than
       #   FinancialEventGroupStartedAfter and no later than two minutes before the request was submitted. If
       #   FinancialEventGroupStartedAfter and FinancialEventGroupStartedBefore are more than 180 days apart, no
       #   financial event groups are returned.
-      # @param [String] financial_event_group_started_after A date used for selecting financial event groups that opened
+      # @param financial_event_group_started_after [String] A date used for selecting financial event groups that opened
       #   after (or at) a specified date and time, in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601)
       #   format. The date-time must be no later than two minutes before the request was submitted.
-      # @param [String] next_token A string token returned in the response of your previous request.
-      # @return [Hash] The API response
-      def list_financial_event_groups(max_results_per_page: nil, financial_event_group_started_before: nil,
-        financial_event_group_started_after: nil, next_token: nil)
+      # @param next_token [String] A string token returned in the response of your previous request.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def list_financial_event_groups(max_results_per_page: 10, financial_event_group_started_before: nil,
+        financial_event_group_started_after: nil, next_token: nil, rate_limit: 0.5)
         path = "/finances/v0/financialEventGroups"
         params = {
           "MaxResultsPerPage" => max_results_per_page,
@@ -36,30 +44,31 @@ module Peddler
           "NextToken" => next_token,
         }.compact
 
-        rate_limit(0.5).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Returns all financial events for the specified financial event group. It may take up to 48 hours for orders to
-      # appear in your financial events.
-      # @note This operation will only retrieve group's data for the past two years. If a request is submitted for data
-      #   spanning more than two years, an empty response is returned.
+      # appear in your financial events. **Note:** This operation will only retrieve group's data for the past two
+      # years. If a request is submitted for data spanning more than two years, an empty response is returned.
       #
-      # @param [Integer] max_results_per_page The maximum number of results to return per page. If the response exceeds
+      # @note This operation can make a static sandbox call.
+      # @param max_results_per_page [Integer] The maximum number of results to return per page. If the response exceeds
       #   the maximum number of transactions or 10 MB, the API responds with 'InvalidInput'.
-      # @param [String] posted_after A date used for selecting financial events posted after (or at) a specified time.
+      # @param posted_after [String] A date used for selecting financial events posted after (or at) a specified time.
       #   The date-time **must** be more than two minutes before the time of the request, in [ISO
       #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date time format.
-      # @param [String] posted_before A date used for selecting financial events posted before (but not at) a specified
+      # @param posted_before [String] A date used for selecting financial events posted before (but not at) a specified
       #   time. The date-time must be later than `PostedAfter` and no later than two minutes before the request was
       #   submitted, in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date time format. If
       #   `PostedAfter` and `PostedBefore` are more than 180 days apart, no financial events are returned. You must
       #   specify the `PostedAfter` parameter if you specify the `PostedBefore` parameter. Default: Now minus two
       #   minutes.
-      # @param [String] event_group_id The identifier of the financial event group to which the events belong.
-      # @param [String] next_token A string token returned in the response of your previous request.
-      # @return [Hash] The API response
-      def list_financial_events_by_group_id(event_group_id, max_results_per_page: nil, posted_after: nil,
-        posted_before: nil, next_token: nil)
+      # @param event_group_id [String] The identifier of the financial event group to which the events belong.
+      # @param next_token [String] A string token returned in the response of your previous request.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def list_financial_events_by_group_id(event_group_id, max_results_per_page: 100, posted_after: nil,
+        posted_before: nil, next_token: nil, rate_limit: 0.5)
         path = "/finances/v0/financialEventGroups/#{event_group_id}/financialEvents"
         params = {
           "MaxResultsPerPage" => max_results_per_page,
@@ -68,44 +77,49 @@ module Peddler
           "NextToken" => next_token,
         }.compact
 
-        rate_limit(0.5).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Returns all financial events for the specified order. It may take up to 48 hours for orders to appear in your
       # financial events.
       #
-      # @param [String] order_id An Amazon-defined order identifier, in 3-7-7 format.
-      # @param [Integer] max_results_per_page The maximum number of results to return per page. If the response exceeds
+      # @note This operation can make a static sandbox call.
+      # @param order_id [String] An Amazon-defined order identifier, in 3-7-7 format.
+      # @param max_results_per_page [Integer] The maximum number of results to return per page. If the response exceeds
       #   the maximum number of transactions or 10 MB, the API responds with 'InvalidInput'.
-      # @param [String] next_token A string token returned in the response of your previous request.
-      # @return [Hash] The API response
-      def list_financial_events_by_order_id(order_id, max_results_per_page: nil, next_token: nil)
+      # @param next_token [String] A string token returned in the response of your previous request.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def list_financial_events_by_order_id(order_id, max_results_per_page: 100, next_token: nil, rate_limit: 0.5)
         path = "/finances/v0/orders/#{order_id}/financialEvents"
         params = {
           "MaxResultsPerPage" => max_results_per_page,
           "NextToken" => next_token,
         }.compact
 
-        rate_limit(0.5).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Returns financial events for the specified data range. It may take up to 48 hours for orders to appear in your
-      # financial events.
-      # @note in `ListFinancialEvents`, deferred events don't show up in responses until in they are released.
+      # financial events. **Note:** in `ListFinancialEvents`, deferred events don't show up in responses until in they
+      # are released.
       #
-      # @param [Integer] max_results_per_page The maximum number of results to return per page. If the response exceeds
+      # @note This operation can make a static sandbox call.
+      # @param max_results_per_page [Integer] The maximum number of results to return per page. If the response exceeds
       #   the maximum number of transactions or 10 MB, the API responds with 'InvalidInput'.
-      # @param [String] posted_after A date used for selecting financial events posted after (or at) a specified time.
+      # @param posted_after [String] A date used for selecting financial events posted after (or at) a specified time.
       #   The date-time must be no later than two minutes before the request was submitted, in [ISO
       #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date time format.
-      # @param [String] posted_before A date used for selecting financial events posted before (but not at) a specified
+      # @param posted_before [String] A date used for selecting financial events posted before (but not at) a specified
       #   time. The date-time must be later than PostedAfter and no later than two minutes before the request was
       #   submitted, in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date time format. If
       #   PostedAfter and PostedBefore are more than 180 days apart, no financial events are returned. You must specify
       #   the PostedAfter parameter if you specify the PostedBefore parameter. Default: Now minus two minutes.
-      # @param [String] next_token A string token returned in the response of your previous request.
-      # @return [Hash] The API response
-      def list_financial_events(max_results_per_page: nil, posted_after: nil, posted_before: nil, next_token: nil)
+      # @param next_token [String] A string token returned in the response of your previous request.
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def list_financial_events(max_results_per_page: 100, posted_after: nil, posted_before: nil, next_token: nil,
+        rate_limit: 0.5)
         path = "/finances/v0/financialEvents"
         params = {
           "MaxResultsPerPage" => max_results_per_page,
@@ -114,7 +128,7 @@ module Peddler
           "NextToken" => next_token,
         }.compact
 
-        rate_limit(0.5).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
     end
   end