GET
/stocks/v1/dividends
Stocks Dividends
Historical cash dividend distributions for a ticker.
Endpoint Details
| HTTP Method | GET |
|---|---|
| Path | /stocks/v1/dividends |
| Version | stocks/v1 |
| Minimum Plan | free |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key |
string | Required | Your API key for authentication |
limit |
integer | Optional | Maximum number of results to return |
sort |
string | Optional | Sort order (asc or desc) |
Example Request
curl "https://mail.tradeiqai.com/api/stocks/v1/dividends?api_key=YOUR_API_KEY"
Note: Replace YOUR_API_KEY with your actual API key.
Response Attributes
| Attribute | Type | Description |
|---|---|---|
ok |
boolean | Indicates if the request was successful |
data.status |
string | The status of the request response (typically "OK") |
data.request_id |
string | A unique request ID assigned by the server |
data.results |
object|array | Object or array containing endpoint-specific data |
data.next_url |
string (optional) | URL for pagination to fetch the next page of results |
Example Response
{
"ok": true,
"data": {
"status": "OK",
"request_id": "abc123def456...",
"results": {
// Endpoint-specific data structure
},
"next_url": "https://api.tradeiqai.com/...?cursor=xyz789"
}
}