Variant Resolve

curl -X POST https://win.oneshotagent.com/v1/tools/resolve/variant \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "hgvs": "NM_007294.4:c.5266dup"
  }'

const response = await fetch("https://win.oneshotagent.com/v1/tools/resolve/variant", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "hgvs": "NM_007294.4:c.5266dup"
  }),
});

const result = await agent.tool('resolve/variant', {
  hgvs: 'NM_007294.4:c.5266dup'
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "variant_resolve",
    "result": {
      "variants": [
        {
          "vcv": "VCV000017677",
          "version": "VCV000017677.176",
          "title": "NM_007294.4(BRCA1):c.5266dup (p.Gln1756fs)",
          "variant_type": "Duplication",
          "genes": [
            {
              "symbol": "BRCA1",
              "gene_id": "672"
            }
          ],
          "rsid": "rs80357906",
          "canonical_spdi": "NC_000017.11:43057062:GGG:GGGG",
          "cdna_change": "c.5266dup",
          "protein_change": "Q1756fs, Q1777fs, Q652fs, Q1709fs",
          "other_names": [
            "5382_5383insC",
            "p.Gln1756ProfsX74",
            "NP_009225.1:p.Gln1756ProfsTer74",
            "p.(Gln1756ProfsTer74)",
            "5382insC",
            "5384insC",
            "5385insC",
            "5383insC"
          ],
          "location": {
            "grch38": {
              "chromosome": "17",
              "band": "17q21.31",
              "start": 43057062,
              "stop": 43057063
            },
            "grch37": {
              "chromosome": "17",
              "band": "17q21.31",
              "start": 41209079,
              "stop": 41209080
            }
          },
          "page_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/17677/"
        }
      ],
      "ambiguous": false
    },
    "evidence": {
      "source": "US National Center for Biotechnology Information (ClinVar)",
      "source_kind": "public",
      "retrieved_at": "2026-01-15T12:00:00.000Z",
      "calls": [
        {
          "retrieved_at": "2026-01-15T12:00:00.000Z"
        },
        {
          "retrieved_at": "2026-01-15T12:00:00.000Z"
        }
      ],
      "as_of": null
    }
  }
}

POST

tools

resolve

variant

curl -X POST https://win.oneshotagent.com/v1/tools/resolve/variant \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "hgvs": "NM_007294.4:c.5266dup"
  }'

const response = await fetch("https://win.oneshotagent.com/v1/tools/resolve/variant", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "hgvs": "NM_007294.4:c.5266dup"
  }),
});

const result = await agent.tool('resolve/variant', {
  hgvs: 'NM_007294.4:c.5266dup'
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "variant_resolve",
    "result": {
      "variants": [
        {
          "vcv": "VCV000017677",
          "version": "VCV000017677.176",
          "title": "NM_007294.4(BRCA1):c.5266dup (p.Gln1756fs)",
          "variant_type": "Duplication",
          "genes": [
            {
              "symbol": "BRCA1",
              "gene_id": "672"
            }
          ],
          "rsid": "rs80357906",
          "canonical_spdi": "NC_000017.11:43057062:GGG:GGGG",
          "cdna_change": "c.5266dup",
          "protein_change": "Q1756fs, Q1777fs, Q652fs, Q1709fs",
          "other_names": [
            "5382_5383insC",
            "p.Gln1756ProfsX74",
            "NP_009225.1:p.Gln1756ProfsTer74",
            "p.(Gln1756ProfsTer74)",
            "5382insC",
            "5384insC",
            "5385insC",
            "5383insC"
          ],
          "location": {
            "grch38": {
              "chromosome": "17",
              "band": "17q21.31",
              "start": 43057062,
              "stop": 43057063
            },
            "grch37": {
              "chromosome": "17",
              "band": "17q21.31",
              "start": 41209079,
              "stop": 41209080
            }
          },
          "page_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/17677/"
        }
      ],
      "ambiguous": false
    },
    "evidence": {
      "source": "US National Center for Biotechnology Information (ClinVar)",
      "source_kind": "public",
      "retrieved_at": "2026-01-15T12:00:00.000Z",
      "calls": [
        {
          "retrieved_at": "2026-01-15T12:00:00.000Z"
        },
        {
          "retrieved_at": "2026-01-15T12:00:00.000Z"
        }
      ],
      "as_of": null
    }
  }
}

Says which variant a public registry, ClinVar, records under one identifier, for research; not medical advice. Supply exactly one HGVS expression on a reference sequence accession (genomic, coding, non-coding or protein) or one dbSNP rsID, never a person’s genome, sequencing data or a VCF file. The expression is matched as one quoted variant name; expressions containing double quotes or square brackets are refused, so use the rsID for repeat notation. An rsID can match several alleles at one position: returns up to five variations carrying that rsID. A short protein change can match several variants too; ambiguous is then true. No match returns an empty variants list. Identity only: no germline, somatic or oncogenicity classification, conditions or submissions; pass vcv to variant_clinical_significance for those. ClinVar refreshes weekly, and accession versions change when records change. NCBI places no restriction on use of ClinVar.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string

HGVS expression starting with a reference sequence accession, for example NM_007294.4:c.5266dup or NM_007294.4(BRCA1):c.5266dup; supply only hgvs or rsid. 5 to 200 characters.

string

dbSNP identifier, for example rs80357906; supply only rsid or hgvs.

Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.

string

Durable job ID for audit and lookup

string

Job status: completed

string

Always variant_resolve

object

The answer, described under Result below

object

Where the answer came from and when

string

The public body the data comes from. Always US National Center for Biotechnology Information (ClinVar).

string

public when the data comes from a public body, commercial otherwise

string

When the lookup was made, as an ISO 8601 UTC time

string

When the source says the fact was last updated, or null when the source gives no date

Result

Nested under data.result.

object[]

Up to five variations the identifier names, in search order.

string

ClinVar variation accession.

string

Versioned ClinVar accession.

string

ClinVar preferred name.

string

Variant type.

object[]

Genes.

string

Symbol.

string

Gene id.

string

dbSNP identifier from the record’s cross-reference. null when the source gives no value.

string

Canonical spdi. null when the source gives no value.

string

Cdna change. null when the source gives no value.

string

Protein change. null when the source gives no value.

string[]

Other names ClinVar records, such as legacy nomenclature.

object

Location.

object

Coordinates on GRCh38. null when the source gives no value.

string

Chromosome.

string

Band. null when the source gives no value.

integer

Start. null when the source gives no value.

integer

Stop. null when the source gives no value.

object

Coordinates on GRCh37. null when the source gives no value.

string

Chromosome.

string

Band. null when the source gives no value.

integer

Start. null when the source gives no value.

integer

Stop. null when the source gives no value.

string

Page url.

boolean

True when more than one variant is returned.

curl -X POST https://win.oneshotagent.com/v1/tools/resolve/variant \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "hgvs": "NM_007294.4:c.5266dup"
  }'

const response = await fetch("https://win.oneshotagent.com/v1/tools/resolve/variant", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "hgvs": "NM_007294.4:c.5266dup"
  }),
});

const result = await agent.tool('resolve/variant', {
  hgvs: 'NM_007294.4:c.5266dup'
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "variant_resolve",
    "result": {
      "variants": [
        {
          "vcv": "VCV000017677",
          "version": "VCV000017677.176",
          "title": "NM_007294.4(BRCA1):c.5266dup (p.Gln1756fs)",
          "variant_type": "Duplication",
          "genes": [
            {
              "symbol": "BRCA1",
              "gene_id": "672"
            }
          ],
          "rsid": "rs80357906",
          "canonical_spdi": "NC_000017.11:43057062:GGG:GGGG",
          "cdna_change": "c.5266dup",
          "protein_change": "Q1756fs, Q1777fs, Q652fs, Q1709fs",
          "other_names": [
            "5382_5383insC",
            "p.Gln1756ProfsX74",
            "NP_009225.1:p.Gln1756ProfsTer74",
            "p.(Gln1756ProfsTer74)",
            "5382insC",
            "5384insC",
            "5385insC",
            "5383insC"
          ],
          "location": {
            "grch38": {
              "chromosome": "17",
              "band": "17q21.31",
              "start": 43057062,
              "stop": 43057063
            },
            "grch37": {
              "chromosome": "17",
              "band": "17q21.31",
              "start": 41209079,
              "stop": 41209080
            }
          },
          "page_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/17677/"
        }
      ],
      "ambiguous": false
    },
    "evidence": {
      "source": "US National Center for Biotechnology Information (ClinVar)",
      "source_kind": "public",
      "retrieved_at": "2026-01-15T12:00:00.000Z",
      "calls": [
        {
          "retrieved_at": "2026-01-15T12:00:00.000Z"
        },
        {
          "retrieved_at": "2026-01-15T12:00:00.000Z"
        }
      ],
      "as_of": null
    }
  }
}

See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

Notes

Results return inline. The finished job stays available at /v1/requests/{request_id}

Overview

Compute

Data

Monitoring

Research & Enrich

Messaging

Web & Browser

Build

Commerce

Account & billing

Other

Variant Resolve

Authentication

Request Body

Response (200 OK)

Result

Notes

​Authentication

​Request Body

​Response (200 OK)

​Result

​Notes

Authentication

Request Body

Response (200 OK)

Result

Notes