FIfinnhub-stock-api
Default

Dividends

Changed on

Get dividends data for common stocks going back 30 years.

get/stock/dividend

Request

  • Base URL
    https://finnhub.io/api/v1
  • URL
    https://finnhub.io/api/v1/stock/dividend
  • Auth
    API key in query parameter token

Query parameters

symbolstring required

Symbol.

fromstring date required

YYYY-MM-DD.

tostring date required

YYYY-MM-DD.

Response

successful operation

symbolstring

Symbol.

datestring date

Ex-Dividend date.

amountnumber float

Amount in local currency.

adjustedAmountnumber float

Adjusted dividend.

payDatestring date

Pay date.

recordDatestring date

Record date.

declarationDatestring date

Declaration date.

currencystring

Currency.

freqstring
<p>Dividend frequency. Can be 1 of the following values:</p><ul> <li><code>0: Annually</code></li> <li><code>1: Monthly</code></li> <li><code>2: Quarterly</code></li> <li><code>3: Semi-annually</code></li> <li><code>4: Other/Unknown</code></li> <li><code>5: Bimonthly</code></li> <li><code>6: Trimesterly</code></li> <li><code>7: Weekly</code></li> </ul>

Example response

[
  {
    "date": "2000-01-23",
    "symbol": "symbol",
    "amount": 0.8008282,
    "declarationDate": "2000-01-23",
    "adjustedAmount": 6.0274563,
    "freq": "freq",
    "recordDate": "2000-01-23",
    "currency": "currency",
    "payDate": "2000-01-23"
  }
]

Changes