> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alterscope.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoring Portfolio Risk

> Keep a live view of exposure and get pushed alerts when risk changes — exposure breakdowns, the risk-events feed, and webhooks.

Due diligence is a point-in-time check; positions drift and markets move. This workflow keeps a continuous view of what you're exposed to and pushes you an alert the moment something changes.

## The workflow

<Steps>
  <Step title="Map your exposure">
    `GET /v2/exposure/{id}/by-asset`, `GET /v2/exposure/by-protocol`, and `GET /v2/exposure/by-borrower` break a portfolio down by where the risk actually concentrates — a single asset, a single protocol, or a single borrower — not just by position.
  </Step>

  <Step title="Watch the risk-events feed">
    `GET /v2/risk-events/feed` is a cursor-paginated stream of material risk events; on Analyst and above, `wss://…/v2/ws/risk-events` pushes them live. Market-level detail is available via `GET /v2/market/{id}/liquidation-events` and `…/bad-debt-events`.
  </Step>

  <Step title="Get pushed, don't poll">
    Register a signed webhook (`/v2/dashboard/webhooks`, Team and above) so risk events reach your systems without polling. See [Webhooks](/develop/realtime/webhooks) for the signature and replay model.
  </Step>

  <Step title="Set factor thresholds">
    `GET /v2/factors/...` returns explainable risk factor scores per position, and `/v2/factors/alerts/thresholds` lets you define the levels that should trip an alert. The methodology behind the scores is on the [Risk factors](/trust/methodology/risk-factors) page.
  </Step>
</Steps>

## What you learn

Where your real concentration sits, and a live signal when a position's risk profile changes — early enough to act. As always, each response carries [freshness and quality](/trust/data/freshness-and-quality) metadata, and live-stream access varies by [plan tier](/pricing). Full detail is in the [API reference](/api-reference/overview).