# Gene-Disease Association Ranker

> Gene-Disease Association Ranker is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-25).

Ranks diseases associated with a human gene by evidence strength, returning per-datatype association scores from Open Targets.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/gene-diseases?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-25
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gene-disease-association-ranker-9688b8a4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mP6dwUbCFWMm9wub9vVFm

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 gene-disease-association-ranker-9688b8a4 -d '<json body>'
```

Example prompt: What are the top 10 diseases associated with BRCA1, ranked by evidence score, including how strong the genetic association and literature evidence are for each?

## When to prefer this

Choose this endpoint when you need ranked disease associations for a specific human gene with granular evidence breakdowns by data type (literature, genetic association, animal model, etc.). It is ideal for genomics research workflows, drug target prioritization, clinical bioinformatics, and any scenario where you need quantitative association scores rather than simple disease lists. Prefer this over general biomedical search APIs when you want Open Targets-quality evidence scoring per disease.

## Known failure modes

- Gene symbol not recognized — returns matched: false with no disease list
- Invalid gene symbol format (too long, illegal characters) — input validation error
- No associations found for a valid but poorly-studied gene — empty diseases array
- Ensembl ID version suffix causes lookup mismatch — version is stripped automatically
- limit out of range (>25 or <1) — validation error returned
- Network or upstream Open Targets API outage — 5xx or timeout error

## How this service works

Rank the diseases linked to a human gene by association evidence, with per-datatype scores.

## Output

A JSON object containing the resolved gene metadata (symbol, name, Ensembl ID), a ranked list of associated diseases (each with overall score, disease ID, MONDO identifier, per-datatype evidence scores, and a link to the Open Targets evidence page), and the total number of known associations in the database.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "gene": {
   "type": "string",
   "description": "An official human gene symbol (BRCA1) or an Ensembl gene ID (ENSG00000012048); a version suffix is dropped. 1 to 30 characters. Letters, digits, \".\", \"_\" and \"-\" only."
  },
  "limit": {
   "type": "integer",
   "description": "Diseases returned, highest overall score first. From 1 to 25. Defaults to `10`."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "gene": {
   "name": "BRCA1 DNA repair associated",
   "symbol": "BRCA1",
   "ensembl_id": "ENSG00000012048"
  },
  "matched": true,
  "release": "26.09",
  "diseases": [
   {
    "name": "breast cancer",
    "score": 0.8436508158150241,
    "evidence": [
     {
      "score": 0.9984727309333157,
      "datatype": "literature"
     },
     {
      "score": 0.9857814423386521,
      "datatype": "genetic_association"
     },
     {
      "score": 0.607930797611621,
      "datatype": "genetic_literature"
     }
    ],
    "page_url": "https://platform.opentargets.org/evidence/ENSG00000012048/MONDO_0007254",
    "disease_id": "MONDO_0007254"
   },
   {
    "name": "hereditary breast ovarian cancer syndrome",
    "score": 0.8278837838347972,
    "evidence": [
     {
      "score": 0.4030059859883006,
      "datatype": "literature"
     },
     {
      "score": 0.4017966624114607,
      "datatype": "animal_model"
     },
     {
      "score": 0.9179786150922271,
      "datatype": "genetic_association"
     },
     {
      "score": 0.8855819352769478,
      "datatype": "genetic_literature"
     }
    ],
    "page_url": "https://platform.opentargets.org/evidence/ENSG00000012048/MONDO_0003582",
    "disease_id": "MONDO_0003582"
   }
  ],
  "total_associations": 1324
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gene-disease-association-ranker-9688b8a4/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)