apiverve_dividends 1.2.3 → 1.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42bfc6c3609410521d807f40d20f64d38b72f9c1ac5ad2d45923f42f54a7584c
-  data.tar.gz: 124ee25bf1fce473a70b6457af66664fc0961a2fbb1f54ab3cfd5cf3a392a839
+  metadata.gz: 0df50f4b93cfab2521d4c956a7800ea742ffbc00f252e695a98dddee1f8eb3b6
+  data.tar.gz: a1712aefcce5a598fc9e472eb530ad779fb1a147241ba58532ec86a5faa13902
 SHA512:
-  metadata.gz: ab08400799ea72d1f1c52dcc8ac43e4fc7cad9fd378468118fc52e1167c54f5e0d718ee7c4bfbd0c08d5a794e8456e0f1dd34a9c700cbdc79c3939f6d31c6eb2
-  data.tar.gz: 04ae08080a955bd2591c87f2cfe10164a3269780b7731e3299363cb982a259ab024ba0fcf0b234cf1f448c876cddefb95425aa35d608d023eae3d667d1c3e3a6
+  metadata.gz: 0d2479f8d3d17c9ff38f61f6fab0e005d0780aefc43541e85ab9c950238139d80be74a5532dba2012f8acfeac71eb3f8f0d8c67269c3ee821bb523d76e7a6f2f
+  data.tar.gz: 63369d9ca77ceb0f06f295fb1c42493d559efae7b91940f2dd613d5555b18edaf9a56b554007471cc8645ae5785e6b3e6e9da2dcd7270beca51de403025f294d

data/README.md

@@ -1,6 +1,6 @@
 # Dividends API - Ruby Gem
 
-Dividends returns the dividend-per-share history for a US public company by ticker - the amount reported each quarter and year straight from official SEC filings - plus a derived dividend-growth summary with year-over-year growth, multi-year growth rates and a consecutive-years-of-growth streak calculated for you.
+Dividends returns the dividend-per-share history for a US public company by ticker - the amount reported each quarter and year straight from official SEC filings - plus a derived dividend-growth summary with year-over-year growth, multi-year growth rates and a consecutive-years-of-growth streak calculated for you. Paid plans can add dividend yield and the full-year payout ratio.
 
 ## Installation
 
@@ -38,7 +38,8 @@ client = APIVerve::Dividends::Client.new(api_key: "YOUR_API_KEY")
 response = client.execute({
   ticker: "AAPL",
   period: "annual",
-  limit: 10
+  limit: 10,
+  metrics: true
 })
 
 # Print the response
@@ -50,7 +51,7 @@ puts response
 
 ```ruby
 begin
-  response = client.execute({ ticker: "AAPL", period: "annual", limit: 10 })
+  response = client.execute({ ticker: "AAPL", period: "annual", limit: 10, metrics: true })
   puts response["data"]
 rescue APIVerve::Dividends::ValidationError => e
   puts "Validation error: #{e.errors.join(', ')}"
@@ -159,6 +160,14 @@ client = APIVerve::Dividends::Client.new(
           "perShare": 1.02
         }
       ]
+    },
+    "metrics": {
+      "trailingAnnualDividend": 1.02,
+      "trailingAnnualPeriod": "CY2025",
+      "dividendYield": 0.33,
+      "priceAsOf": "2026-08-17T19:27:12.559994467Z",
+      "payoutRatio": 13.67,
+      "payoutRatioFiscalYear": 2025
     }
   }
 }

data/lib/apiverve_dividends/client.rb

@@ -10,7 +10,7 @@ module APIVerve
     #
     # @example Basic usage
     #   client = APIVerve::Dividends::Client.new(api_key: "your_api_key")
-    #   response = client.execute({ ticker: "AAPL", period: "annual", limit: 10 })
+    #   response = client.execute({ ticker: "AAPL", period: "annual", limit: 10, metrics: true })
     #   puts response
     #
     # @see https://apiverve.com/marketplace/dividends?utm_source=ruby&utm_medium=referral&utm_content=readme
@@ -19,7 +19,7 @@ module APIVerve
       DEFAULT_TIMEOUT = 30
 
       # Validation rules for parameters
-      VALIDATION_RULES = { 'ticker' => { type: 'string', required: true, min_length: 1, max_length: 6 }, 'period' => { type: 'string', required: false }, 'limit' => { type: 'integer', required: false, min: 1, max: 25 } }
+      VALIDATION_RULES = { 'ticker' => { type: 'string', required: true, min_length: 1, max_length: 6 }, 'period' => { type: 'string', required: false }, 'limit' => { type: 'integer', required: false, min: 1, max: 25 }, 'metrics' => { type: 'boolean', required: false } }
 
       # Format validation patterns
       FORMAT_PATTERNS = {

data/lib/apiverve_dividends.rb

@@ -4,6 +4,6 @@ require_relative "apiverve_dividends/client"
 
 module APIVerve
   module Dividends
-    VERSION = "1.2.3"
+    VERSION = "1.2.5"
   end
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: apiverve_dividends
 version: !ruby/object:Gem::Version
-  version: 1.2.3
+  version: 1.2.5
 platform: ruby
 authors:
 - APIVerve
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-10-26 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -61,7 +60,8 @@ dependencies:
 description: Dividends returns the dividend-per-share history for a US public company
   by ticker - the amount reported each quarter and year straight from official SEC
   filings - plus a derived dividend-growth summary with year-over-year growth, multi-year
-  growth rates and a consecutive-years-of-growth streak calculated for you.
+  growth rates and a consecutive-years-of-growth streak calculated for you. Paid plans
+  can add dividend yield and the full-year payout ratio.
 email:
 - hello@apiverve.com
 executables: []
@@ -80,7 +80,6 @@ metadata:
   source_code_uri: https://github.com/apiverve/dividends-API/tree/main/ruby
   changelog_uri: https://apiverve.com/changelog
   documentation_uri: https://docs.apiverve.com/ref/dividends
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -95,8 +94,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 4.0.23
 specification_version: 4
 summary: Dividends API - Ruby Client
 test_files: []