---
title: "Register Crash Shield"
method: POST
path: "/v1/crypto/portfolio/crash-shield"
tags: ["crypto-v3"]
---

# Register Crash Shield

`POST /v1/crypto/portfolio/crash-shield`

## Request

- Base URL: `https://zarq.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://zarq.ai/v1/crypto/portfolio/crash-shield`
- Auth: none declared

Register a webhook for real-time crash alerts on your portfolio.

## Request body

- CrashShieldRequest
  - `webhook_url` string, required: HTTPS URL that receives POST alerts
  - `holdings` HoldingItem[], required
    - `token` string, required: Token symbol e.g. ETH, BTC, PEPE
    - `weight` number, nullable: Portfolio weight 0-1
    - `value_usd` number, nullable: USD value
  - `portfolio_value_usd` number
  - `alert_levels` string[]

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zarq/apis/zarq-nerq.md) · [All operations](https://skmtc.dev/zarq/apis/zarq-nerq/llms.txt) · [OpenAPI document](https://skmtc.dev/zarq/apis/zarq-nerq/revisions/adc2843b9273?raw)