Get PIT Dividends

OpenAPI JSON Spec Feature Overview Get Point-in-Time (PIT) dividend data for a specific symbol within a time range.

Main Use Cases

• Dividend Analysis: Track historical dividend payments and distributions
• Income Planning: Analyze dividend frequency and yield trends
• Investment Research: Study dividend history for income-focused portfolios
• Backtesting: Historical dividend data for quantitative analysis
• Tax Planning: Review dividend payment dates and amounts

Query Parameters & Logic

Required Parameters:

• symbol: Stock symbol (e.g., AAPL, MSFT, KO)
• start_time: Start timestamp (Unix seconds, UTC)
• end_time: End timestamp (Unix seconds, UTC)
• time_type: Date type to filter by (RECORD_DATE, PAYMENT_DATE, or DECLARATION_DATE)

Optional Parameters:

• limit: Maximum number of results (1-1000, default: 50)

Validation Rules:

• Symbol is required and must be a valid stock symbol
• start_time must be before end_time
• time_type must be one of: RECORD_DATE, PAYMENT_DATE, DECLARATION_DATE
• Limit defaults to 50 if not provided, max 1000

Response Data Structure

• data ([]PITDividendData): Array of PIT dividend data points

PITDividendData fields:

• symbol (string): Stock symbol
• date (string): Ex-dividend date (YYYY-MM-DD)
• record_date (string): Record date (YYYY-MM-DD)
• payment_date (string): Payment date (YYYY-MM-DD)
• declaration_date (string): Declaration date (YYYY-MM-DD)
• adj_dividend (float64): Adjusted dividend amount
• dividend (float64): Dividend amount
• yield (float64): Dividend yield percentage
• frequency (string): Dividend frequency (e.g., “Quarterly”, “Monthly”)

Dividend Date Explanation:

• Declaration Date: Date when board announces dividend (use time_type=DECLARATION_DATE)
• Ex-Dividend Date: Date when stock trades without dividend
• Record Date: Date to be on record to receive dividend (use time_type=RECORD_DATE)
• Payment Date: Date when dividend is actually paid (use time_type=PAYMENT_DATE)

Usage Examples

1. Get AAPL dividends by payment date for 2024: ?symbol=AAPL&start_time=1704067200&end_time=1735689600&time_type=PAYMENT_DATE
2. Get by record date with custom limit: ?symbol=KO&start_time=1704067200&end_time=1735689600&time_type=RECORD_DATE&limit=100
3. Get by declaration date: ?symbol=MSFT&start_time=1640995200&end_time=1735689600&time_type=DECLARATION_DATE&limit=1000

Important Notes

• All required parameters must be provided
• Results are ordered by the specified time_type date (typically descending)
• PIT dividends provide point-in-time snapshots as they were known historically
• Choose time_type based on your use case: RECORD_DATE for eligibility, PAYMENT_DATE for cash flow, DECLARATION_DATE for announcements