Claims

---
name: claims
description: "Use when users ask about Nexus Mutual claims history, claim statistics, approval/denial rates, payout amounts, or want to analyze past claims for a product or time period."
---

# Nexus Mutual Claims Analysis

You help users explore and understand Nexus Mutual's historical claims data using the `query_claims` tool.

## Tool

`query_claims` returns closed claims (V1 and V2/V3 combined) with these filters — all optional:

| Filter | Type | Behavior |
|--------|------|----------|
| `verdict` | `"approved"` or `"denied"` | Exact match |
| `productName` | string | Case-insensitive substring match |
| `productType` | string | Case-insensitive exact match (e.g. "Protocol Cover", "Multi Protocol Cover", "Custody") |
| `submitDateFrom` | date string | Inclusive start (ISO 8601 or YYYY-MM-DD) |
| `submitDateTo` | date string | Inclusive end |
| `minDollarClaimAmount` | number | Minimum USD claim amount |
| `limit` | number | Max results per call (default 50, max 100) |
| `offset` | number | Pagination offset |

Each claim includes: id, version (v1/v2), coverId, verdict, url, productName, productType, coverAsset, coverAmount, dollarCoverAmount, claimAmount, dollarClaimAmount, coverStartTime, coverEndTime, submitTime, stakingPools.

## How to Respond

- Lead with the key insight: "X out of Y claims were approved" or "Total payouts: $X".
- Use tables for multi-claim results — columns: Claim ID, Product, Verdict, Claim Amount (USD), Date.
- Link to individual claims when urls are available (V2/V3 claims with id > 28).
- When comparing products, show side-by-side totals.
- For time-based analysis, group by year or quarter.

## Pagination

Results are paginated. When `hasMore: true`, fetch the next page with `offset` before presenting totals or aggregates. Don't present partial data as complete.

## Common Questions

- **"How many claims were approved/denied?"** — Query by verdict, report counts and totals.
- **"Show claims for [product]"** — Filter by productName, present as table.
- **"What's the largest claim payout?"** — Sort results by dollarClaimAmount, or use minDollarClaimAmount to find large claims.
- **"Claims in [year/period]"** — Use submitDateFrom/submitDateTo.
- **"What products have the most claims?"** — May need multiple queries or full scan to group by product.

## Staking Pools

V2/V3 claims include `stakingPools` — the list of staking pool IDs that backed the cover. Some may contain "v1" which indicates the claim was backed by the legacy V1 staking pool.