# ClinVar Gene Variant Finder

> ClinVar Gene Variant Finder is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-20).

Returns ClinVar variants associated with a human gene, filterable by clinical classification and review status, given an NCBI Gene ID or official gene symbol.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/find/gene-variants?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/clinvar-gene-variant-finder-71e27dbf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZUrT_YUoYoMhufXur4ROb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability clinvar-gene-variant-finder-71e27dbf -d '<json body>'
```

Example prompt: Can you find the top 10 pathogenic ClinVar variants for BRCA1, limited to those reviewed by an expert panel?

## When to prefer this

Use this endpoint when you need to enumerate ClinVar variants for a known human gene by symbol or NCBI Gene ID, especially with filtering by clinical significance or expert panel review. Prefer this over general variant lookup endpoints when your starting point is a gene identifier rather than an HGVS expression or rsID. For resolving aliases or non-standard gene names, use the companion gene_resolve endpoint first.

## Known failure modes

- Invalid or non-existent gene symbol returns empty result or error
- Supplying both gene_id and symbol simultaneously may cause ambiguous request error
- Classification enum value mismatch returns validation error
- Limit out of range (below 1 or above 20) returns validation error
- Gene with no ClinVar entries returns empty list
- Network or upstream NCBI ClinVar unavailability causes timeout or 503 error

## How this service works

Find ClinVar variants in a human gene by NCBI Gene ID or official symbol.

## Output

A list of ClinVar variant records associated with the specified human gene, each including variant identity, clinical classification, and review details. Results are constrained by the requested limit and any applied filters such as classification category or expert panel review status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Maximum number of variants returned. From 1 to 20. Defaults to `10`."
  },
  "symbol": {
   "type": "string",
   "description": "Official human gene symbol, for example BRCA1; use gene_resolve for aliases. 1 to 30 characters."
  },
  "gene_id": {
   "type": "string",
   "description": "NCBI Gene ID, for example 672; supply exactly one of gene_id or symbol. 1 to 12 characters."
  },
  "classification": {
   "enum": [
    "pathogenic",
    "likely_pathogenic",
    "uncertain",
    "likely_benign",
    "benign",
    "conflicting"
   ],
   "type": "string",
   "description": "ClinVar classification property filter; may include combined classifications"
  },
  "expert_panel_only": {
   "type": "boolean",
   "description": "Only variants reviewed by an expert panel. Defaults to `false`."
  },
  "include_multi_gene": {
   "type": "boolean",
   "description": "Include variants spanning multiple genes. Defaults to `false`."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/clinvar-gene-variant-finder-71e27dbf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)