Skip to main content

Validate Symbol

Validate a stock symbol using Finnhub API before adding to portfolio. Parameters:
  • symbol (path): Stock ticker symbol
Response:
Error Response:

Get Symbol Price

Get current price for a symbol and update cache. Parameters:
  • symbol (path): Stock ticker symbol
Response:

Capture Portfolio Snapshot

Capture a snapshot of current portfolio value for historical tracking. Request Body:
Response:
Snapshot Types:
  • MANUAL - User-initiated snapshot
  • AUTOMATIC - System-generated snapshot
  • EOD - End of day snapshot

Get Portfolio History

Get historical portfolio value snapshots for charting and analysis. Query Parameters:
  • days (number, optional): Number of days to retrieve (default: 30, 0 for all)
  • type (string, optional): Filter by snapshot type
Example:
Response:

Delete Portfolio Snapshot

Delete a portfolio snapshot. Parameters:
  • snapshot_id (path): ID of the snapshot to delete
Response:

Upload Portfolio CSV

or
Upload CSV file with portfolio holdings for bulk import. Content-Type: multipart/form-data Parameters:
  • csv_file (file, required): CSV file with holdings
CSV Format: Required columns: symbol, shares Optional columns: cost_basis, average_cost, security_type, holding_type, type, purchase_date, notes Example CSV:
Response:

Use Cases

Symbol Validation

Verify symbols before adding to portfolio to prevent errors

Price Tracking

Get real-time price data for individual symbols

Historical Tracking

Capture snapshots to track portfolio performance over time

Bulk Import

Import multiple holdings at once from CSV

Portfolio Holdings

Main portfolio CRUD operations

Portfolio Refresh

Refresh all portfolio prices