{"openapi":"3.1.0","info":{"title":"Stock Dividends API","version":"1.0.0","description":"Live stock dividend data as an API — the dividends any listed stock or ETF actually pays, served from Yahoo Finance. For any ticker it returns the trailing-twelve-month dividend per share, the current dividend yield, the payment frequency (monthly, quarterly, semi-annual or annual), the most recent payment with its date, and the dividend payment history. Look a stock up by ticker or company name, or pull its full payment history over several years. Non-paying stocks are reported cleanly with a zero yield so you can screen for income. The dividend-income layer for investing, screening and dashboard apps. Live, no key, no cache. Distinct from dividend-ratio calculators and from price-quote APIs — this returns the stock's actual dividends paid and its real yield.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/dividends-api","description":"oanor gateway"}],"tags":[{"name":"Dividends"},{"name":"History"},{"name":"Search"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/dividends":{"get":{"operationId":"get_v1_dividends","tags":["Dividends"],"summary":"TTM dividend, yield, frequency, last payment","description":"","parameters":[{"name":"symbol","in":"query","required":false,"description":"Ticker symbol","schema":{"type":"string"},"example":"AAPL"},{"name":"name","in":"query","required":false,"description":"Company name (resolved via search)","schema":{"type":"string"},"example":"Coca-Cola"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Apple Inc.","price":301.54,"recent":[{"ts":1778506200,"date":"2026-05-11","amount":0.27},{"ts":1770647400,"date":"2026-02-09","amount":0.26},{"ts":1762785000,"date":"2025-11-10","amount":0.26},{"ts":1754919000,"date":"2025-08-11","amount":0.26},{"ts":1747056600,"date":"2025-05-12","amount":0.26},{"ts":1739197800,"date":"2025-02-10","amount":0.25},{"ts":1731076200,"date":"2024-11-08","amount":0.25},{"ts":1723469400,"date":"2024-08-12","amount":0.25}],"symbol":"AAPL","currency":"USD","frequency":"quarterly","last_payment":{"date":"2026-05-11","amount":0.27},"payments_ttm":4,"ttm_dividend":1.05,"pays_dividend":true,"dividend_yield_pct":0.35},"meta":{"timestamp":"2026-06-09T03:02:12.031Z","request_id":"7e8af875-9f80-416e-a399-c6421e685fdd"},"status":"ok","message":"Dividends retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/history":{"get":{"operationId":"get_v1_history","tags":["History"],"summary":"Full dividend payment history","description":"","parameters":[{"name":"symbol","in":"query","required":false,"description":"Ticker symbol","schema":{"type":"string"},"example":"KO"},{"name":"name","in":"query","required":false,"description":"Company name","schema":{"type":"string"},"example":"Coca-Cola"},{"name":"years","in":"query","required":false,"description":"Years of history (1-10)","schema":{"type":"string"},"example":"5"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"The Coca-Cola Company","count":20,"years":5,"symbol":"KO","currency":"USD","payments":[{"ts":1773408600,"date":"2026-03-13","amount":0.53},{"ts":1764599400,"date":"2025-12-01","amount":0.51},{"ts":1757943000,"date":"2025-09-15","amount":0.51},{"ts":1749821400,"date":"2025-06-13","amount":0.51},{"ts":1741959000,"date":"2025-03-14","amount":0.51},{"ts":1732890600,"date":"2024-11-29","amount":0.485},{"ts":1726234200,"date":"2024-09-13","amount":0.485},{"ts":1718371800,"date":"2024-06-14","amount":0.485},{"ts":1710423000,"date":"2024-03-14","amount":0.485},{"ts":1701354600,"date":"2023-11-30","amount":0.46},{"ts":1694698200,"date":"2023-09-14","amount":0.46},{"ts":1686835800,"date":"2023-06-15","amount":0.46},{"ts":1678973400,"date":"2023-03-16","amount":0.46},{"ts":1669818600,"date":"2022-11-30","amount":0.44},{"ts":1663248600,"date":"2022-09-15","amount":0.44},{"ts":1655213400,"date":"2022-06-14","amount":0.44},{"ts":1647264600,"date":"2022-03-14","amount":0.44},{"ts":1638282600,"date":"2021-11-30","amount":0.42},{"ts":1631626200,"date":"2021-09-14","amount":0.42},{"ts":1623677400,"date":"2021-06-14","amount":0.42}]},"meta":{"timestamp":"2026-06-09T03:02:12.355Z","request_id":"70029ca0-e249-4f9c-82ae-fea1184f1c8c"},"status":"ok","message":"History retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Find a ticker by company name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Company name query","schema":{"type":"string"},"example":"coca"},{"name":"limit","in":"query","required":false,"description":"Max results (1-20)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":7,"query":"coca","results":[{"name":"Coca-Cola Company (The)","type":"EQUITY","symbol":"KO","exchange":"NYQ"},{"name":"Coca-Cola Consolidated, Inc.","type":"EQUITY","symbol":"COKE","exchange":"NMS"},{"name":"Coca-Cola Bottlers JP Hldg.IncR","type":"EQUITY","symbol":"CCW.F","exchange":"FRA"},{"name":"Coca-Cola Europacific Partners ","type":"EQUITY","symbol":"CCEPL.XC","exchange":"CXE"},{"name":"THE COCA-COLA COMPANY","type":"EQUITY","symbol":"4KO.TI","exchange":"TLO"},{"name":"Coca Cola Femsa S.A.B. de C.V.","type":"EQUITY","symbol":"KOF","exchange":"NYQ"},{"name":"MSCI GREECE IMI + COCA NETR EUR","type":"INDEX","symbol":"^714828-EUR-NETR","exchange":"MSC"}]},"meta":{"timestamp":"2026-06-09T03:02:12.526Z","request_id":"86d25549-7bd9-4b9e-82bb-f01078962957"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Yahoo Finance dividend events + search (live)","service":"dividends-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/search":"Find a ticker by company name (q=coca).","GET /v1/history":"Full dividend payment history (symbol, years up to 10).","GET /v1/dividends":"TTM dividend, yield, frequency, last payment (symbol=AAPL or name=Apple)."},"description":"Live stock dividend data from Yahoo Finance: for any ticker, the trailing-twelve-month dividend per share, the dividend yield, the payment frequency (monthly/quarterly/semi-annual/annual), the most recent payment with its date, and the dividend payment history. Look up by ticker or company name, or pull multi-year history. Non-paying stocks are reported with a zero yield. Live, no key. Distinct from dividend-ratio calculators and price-quote APIs — this returns the actual dividends paid.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T03:02:12.744Z","request_id":"508a2fa9-4c52-4fc5-bd46-b8ecaf1b4800"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":9000,"rps_limit":4,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":900,"monthly_call_quota":125000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2400,"monthly_call_quota":640000,"rps_limit":35,"hard_limit":true},{"slug":"desk","name":"Desk","price_cents_month":5700,"monthly_call_quota":3200000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/dividends-api"}