Calendar Data Endpoints

Get Calendar Data

GET /api/calendar-data

Retrieves daily trading activity data for calendar view including weekly aggregates. Query Parameters:

year (number, optional): Year to display (defaults to current year)
month (number, optional): Month to display 1-12 (defaults to current month)

Example:

GET /api/calendar-data?year=2024&month=8

Response:

{
  "success": true,
  "year": 2024,
  "month": 8,
  "days": [
    {
      "date": "2024-08-01",
      "day": 1,
      "day_of_week": 4,
      "trade_count": 3,
      "trading_pnl": 150.25,
      "dividend_count": 0,
      "dividends": 0,
      "total_pnl": 150.25,
      "has_activity": true,
      "week_trade_count": 12,
      "week_winning_trades": 8,
      "week_total_pnl": 450.75,
      "week_win_rate": 66.67
    }
  ],
  "data_source": "postgresql"
}

Get Day Details

GET /api/day-details

Retrieves detailed trades and dividends for a specific day. Query Parameters:

date (string, required): Date in YYYY-MM-DD format

Example:

GET /api/day-details?date=2024-08-15

Response:

{
  "success": true,
  "date": "2024-08-15",
  "trades": [
    {
      "symbol": "AAPL",
      "buy_date": "2024-08-01",
      "sell_date": "2024-08-15",
      "buy_price": 195.50,
      "sell_price": 198.75,
      "volume": 100,
      "total_profit_loss": 325.00,
      "return_percentage": 1.66,
      "trade_result": "Win"
    }
  ],
  "dividends": [
    {
      "symbol": "MSFT",
      "transaction_date": "2024-08-15",
      "action": "Cash Dividend",
      "amount": 75.50
    }
  ],
  "summary": {
    "date": "2024-08-15",
    "total_trading_pnl": 325.00,
    "total_dividends": 75.50,
    "total_pnl": 400.50,
    "trade_count": 1,
    "dividend_count": 1,
    "winning_trades": 1,
    "win_rate": 100.0
  },
  "data_source": "postgresql"
}

Export Calendar Day Data

GET /api/calendar/export/<format>

Export trades for a specific day in CSV, Excel, or PDF format. Parameters:

format (path): Export format - csv, excel, or pdf

Query Parameters:

date (string, required): Date in YYYY-MM-DD format

Example:

GET /api/calendar/export/csv?date=2024-08-15
GET /api/calendar/export/excel?date=2024-08-15
GET /api/calendar/export/pdf?date=2024-08-15

Response: File download in requested format Error Response:

{
  "success": false,
  "error": "No trades found for this date"
}

HTTP Status: 404 Not Found

Get Trading Calendar Metrics

GET /api/trading-calendar/metrics

Retrieves trading calendar metrics including market open/close times and trading days. Authentication: Not required (public endpoint) Response:

{
  "success": true,
  "metrics": {
    "current_time": "2024-08-15T14:30:00",
    "market_status": "open",
    "market_open_time": "09:30:00",
    "market_close_time": "16:00:00",
    "is_trading_day": true,
    "next_trading_day": "2024-08-16",
    "trading_days_this_month": 22,
    "trading_days_this_year": 252
  }
}

Market Status Values:

open - Market is currently open for trading
closed - Market is closed
pre-market - Before regular trading hours
after-hours - After regular trading hours

Export Monthly Data

GET /api/monthly/export/<format>

Export monthly trading data in CSV, Excel, or PDF format. Parameters:

format (path): Export format - csv, excel, or pdf

Query Parameters:

month (string, required): Month in YYYY-MM format

Example:

GET /api/monthly/export/pdf?month=2024-08
GET /api/monthly/export/excel?month=2024-08
GET /api/monthly/export/csv?month=2024-08

Response: File download with monthly summary, trades, and dividends

Use Cases

Calendar View

Display monthly trading activity with visual heat maps

Daily Analysis

Drill down into specific trading days

Reports & Export

Generate reports for tax or record keeping

Market Hours

Track market status and trading days

Trading Calendar Feature

Learn about the calendar visualization

Month Data

Get complete monthly trading data

Overview

Trading Data

Symbols

Calendar

Portfolio

Data Import

Authentication

Get Calendar Data

Get Day Details

Export Calendar Day Data

Get Trading Calendar Metrics

Export Monthly Data

Use Cases

Calendar View

Daily Analysis

Reports & Export

Market Hours

Trading Calendar Feature

Month Data

​Get Calendar Data

​Get Day Details

​Export Calendar Day Data

​Get Trading Calendar Metrics

​Export Monthly Data

​Use Cases

Calendar View

Daily Analysis

Reports & Export

Market Hours

​Related Documentation

Trading Calendar Feature

Month Data

Get Calendar Data

Get Day Details

Export Calendar Day Data

Get Trading Calendar Metrics

Export Monthly Data

Use Cases

Related Documentation