# info.description
Interactive documentation for the Trader Dashboard service.

# paths./api/all-alerts/.get.description
Return all alert types using a DB-level union for speed.

Optionally include `is_in_watchlist` and/or filter by watchlist with
`?is_in_watchlist=1`.

# paths./api/stocks/all/.get.description
Return all active stocks with ticker and name only.

# paths./api/stocks/.get.description
Return paginated stock data with watchlist info.

# paths./api/stocks/{stock_symbol}/.get.description
Return detailed information for a single stock.

# paths./api/portfolio/.get.description
Return portfolio summary, chart data and positions for the authenticated user.

# paths./api/portfolio/asset-allocation/.get.description
Return allocation by sector and by holding (percent of total).

# paths./api/portfolio/risk/.get.description
Return basic risk metrics computed from portfolio daily values.

# paths./api/user/.get.description
Return basic information for the authenticated user.

# paths./api/user/.patch.description
Allow a user to update first and last name.

# paths./api/manage-subscription/.get.description
Return a billing portal session URL or checkout redirect.

# paths./api/subscription-info/.get.description
Return the user's current plan and upcoming billing details.

# paths./api/create-checkout-session/.get.description
Create a checkout session and return the URL for the frontend.

# paths./api/create-checkout-session/.post.description
Create a checkout session and return the URL for the frontend.

# paths./api/user/alert-preferences/.get.description
Retrieve and update alert preferences for the authenticated user.

# paths./api/user/alert-preferences/.patch.description
Retrieve and update alert preferences for the authenticated user.

# paths./api/help-center.get.description
Return active help center sections and popular articles.

# paths./api/help-center/sections/{section_id}.get.description
Return one section with its published articles.

# paths./api/help-center/articles/{article_id}.get.description
Return one published article and related content.

Accepts lookup by slug (preferred) or legacy id.

# paths./api/dashboard/.get.description
Return summary information for the dashboard.

# paths./stripe/webhook/.post.description
Stripe webhook endpoint (no auth, no CSRF via DRF).

Stripe posts signed JSON payloads; we verify the signature using the
`STRIPE_WEBHOOK_SECRET` from settings and update local subscription state.

# paths./api/contact/.post.description
Receive contact form submissions and email support.

# paths./api/signup/.post.description
Create a new user and send a verification email.

# paths./api/resend-verification/.post.description
Resend verification email for inactive users.

# paths./api/unified-endpoint/.post.description
Accept raw unified payload and queue async processing.

This keeps the endpoint fast during spikes (e.g., market close).

# paths./api/stocks/{stock_symbol}/weekly-trend/.post.description
Queue async regeneration of the weekly trend snapshot for a stock.

# paths./api/watchlist/{stock_symbol}/.delete.description
Remove a stock from the user's watchlist.

# paths./api/portfolio/transactions/.post.description
Add a new transaction for the authenticated user.

# paths./api/change-password/.post.description
Allow an authenticated user to change their password.

# paths./api/reset-password/.post.description
Handle password reset requests by sending a reset link.

# paths./api/reset-password/confirm/.post.description
Confirm a password reset using a valid token.

# paths./api/token/refresh/.post.description
Takes a refresh type JSON web token and returns an access type JSON web
token if the refresh token is valid.