{"uid":"cap_mP6dwUbCFWMm9wub9vVFm","slug":"gene-disease-association-ranker-9688b8a4","name":"Gene-Disease Association Ranker","description":"Rank the diseases linked to a human gene by association evidence, with per-datatype scores.","url":"https://win.oneshotagent.com/v1/tools/lookup/gene-diseases?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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`."}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-Z816NouYwnXq60YzG0jW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks diseases associated with a human gene by evidence strength, returning per-datatype association scores from Open Targets.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Drug target disease prioritization","prompt":"I'm researching EGFR as a drug target — can you show me the top 15 diseases it's most strongly linked to, with scores broken down by evidence type?"},{"title":"Patient gene variant counseling prep","prompt":"A patient has a BRCA2 variant. Can you pull the top diseases associated with BRCA2 ranked by overall association evidence so I can prepare a counseling summary?"},{"title":"Rare disease gene exploration","prompt":"We just identified LRRK2 as a gene of interest. What diseases are linked to it and how strong is the evidence, especially from genetic association studies?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-25T12:31:16.685Z","isFirstParty":false,"canonicalSlug":"gene-disease-association-ranker-9688b8a4"}