# Stock Dividends API > 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. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/dividends-api/..." ``` ## Pricing - **Free** (Free) — 9,000 calls/Mo, 4 req/s - **Starter** ($9/Mo) — 125,000 calls/Mo, 12 req/s - **Pro** ($24/Mo) — 640,000 calls/Mo, 35 req/s - **Desk** ($57/Mo) — 3,200,000 calls/Mo, 100 req/s ## Endpoints ### Dividends #### `GET /v1/dividends` — TTM dividend, yield, frequency, last payment **Parameters:** - `symbol` (query, optional, string) — Ticker symbol Example: `AAPL` - `name` (query, optional, string) — Company name (resolved via search) Example: `Coca-Cola` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/dividends-api/v1/dividends?symbol=AAPL&name=Coca-Cola" ``` **Response:** ```json { "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": { "times …(truncated, see openapi.json for full schema) ``` ### History #### `GET /v1/history` — Full dividend payment history **Parameters:** - `symbol` (query, optional, string) — Ticker symbol Example: `KO` - `name` (query, optional, string) — Company name Example: `Coca-Cola` - `years` (query, optional, string) — Years of history (1-10) Example: `5` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/dividends-api/v1/history?symbol=KO&name=Coca-Cola&years=5" ``` **Response:** ```json { "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 }, …(truncated, see openapi.json for full schema) ``` ### Search #### `GET /v1/search` — Find a ticker by company name **Parameters:** - `q` (query, required, string) — Company name query Example: `coca` - `limit` (query, optional, string) — Max results (1-20) Example: `10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/dividends-api/v1/search?q=coca&limit=10" ``` **Response:** ```json { "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 …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/dividends-api/v1/meta" ``` **Response:** ```json { "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 } ``` --- Marketplace page: https://www.oanor.com/api/dividends-api OpenAPI spec: https://www.oanor.com/api/dividends-api/openapi.json