curl -X POST https://win.oneshotagent.com/v1/tools/lookup/gene-diseases \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"gene": "BRCA1",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/gene-diseases", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"gene": "BRCA1",
"limit": 2
}),
});
const result = await agent.tool('lookup/gene-diseases', {
gene: 'BRCA1',
limit: 2
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "gene_diseases",
"result": {
"matched": true,
"gene": {
"ensembl_id": "ENSG00000012048",
"symbol": "BRCA1",
"name": "BRCA1 DNA repair associated"
},
"total_associations": 1324,
"diseases": [
{
"disease_id": "MONDO_0007254",
"name": "breast cancer",
"score": 0.8436508158150241,
"evidence": [
{
"datatype": "literature",
"score": 0.9984727309333157
},
{
"datatype": "genetic_association",
"score": 0.9857814423386521
},
{
"datatype": "genetic_literature",
"score": 0.607930797611621
}
],
"page_url": "https://platform.opentargets.org/evidence/ENSG00000012048/MONDO_0007254"
},
{
"disease_id": "MONDO_0003582",
"name": "hereditary breast ovarian cancer syndrome",
"score": 0.8278837838347972,
"evidence": [
{
"datatype": "literature",
"score": 0.40300598598830056
},
{
"datatype": "animal_model",
"score": 0.40179666241146067
},
{
"datatype": "genetic_association",
"score": 0.9179786150922271
},
{
"datatype": "genetic_literature",
"score": 0.8855819352769478
}
],
"page_url": "https://platform.opentargets.org/evidence/ENSG00000012048/MONDO_0003582"
}
],
"release": "26.09"
},
"evidence": {
"source": "Open Targets Platform (EMBL-EBI and partners)",
"source_kind": "public",
"retrieved_at": "2026-10-22T17:37:55.000Z",
"calls": [
{
"retrieved_at": "2026-10-22T17:37:55.000Z"
},
{
"retrieved_at": "2026-10-22T17:37:55.000Z"
}
],
"as_of": null
}
}
}
Life sciences
Gene Diseases
Rank the diseases linked to a human gene by association evidence, with per-datatype scores.
POST
/
v1
/
tools
/
lookup
/
gene-diseases
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/gene-diseases \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"gene": "BRCA1",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/gene-diseases", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"gene": "BRCA1",
"limit": 2
}),
});
const result = await agent.tool('lookup/gene-diseases', {
gene: 'BRCA1',
limit: 2
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "gene_diseases",
"result": {
"matched": true,
"gene": {
"ensembl_id": "ENSG00000012048",
"symbol": "BRCA1",
"name": "BRCA1 DNA repair associated"
},
"total_associations": 1324,
"diseases": [
{
"disease_id": "MONDO_0007254",
"name": "breast cancer",
"score": 0.8436508158150241,
"evidence": [
{
"datatype": "literature",
"score": 0.9984727309333157
},
{
"datatype": "genetic_association",
"score": 0.9857814423386521
},
{
"datatype": "genetic_literature",
"score": 0.607930797611621
}
],
"page_url": "https://platform.opentargets.org/evidence/ENSG00000012048/MONDO_0007254"
},
{
"disease_id": "MONDO_0003582",
"name": "hereditary breast ovarian cancer syndrome",
"score": 0.8278837838347972,
"evidence": [
{
"datatype": "literature",
"score": 0.40300598598830056
},
{
"datatype": "animal_model",
"score": 0.40179666241146067
},
{
"datatype": "genetic_association",
"score": 0.9179786150922271
},
{
"datatype": "genetic_literature",
"score": 0.8855819352769478
}
],
"page_url": "https://platform.opentargets.org/evidence/ENSG00000012048/MONDO_0003582"
}
],
"release": "26.09"
},
"evidence": {
"source": "Open Targets Platform (EMBL-EBI and partners)",
"source_kind": "public",
"retrieved_at": "2026-10-22T17:37:55.000Z",
"calls": [
{
"retrieved_at": "2026-10-22T17:37:55.000Z"
},
{
"retrieved_at": "2026-10-22T17:37:55.000Z"
}
],
"as_of": null
}
}
}
Reports the diseases the Open Targets Platform (CC0) associates with a human gene, strongest overall score first, with the evidence score of each datatype (genetic association, somatic mutation, known drug, affected pathway, literature, RNA expression, animal model, genetic literature). Human genes only. Pass an official gene symbol or an Ensembl gene ID; a version suffix is dropped. A symbol matches only a search hit with exactly that name, ignoring case: otherwise matched is false and the near hits are listed as candidates so you can retry by Ensembl ID. An unknown Ensembl ID returns matched: false. A score between 0 and 1 summarises the strength of the evidence that the gene and disease are associated; it is not a measure of causation or clinical risk. The data is for research and is not medical advice.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
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.
integer
Diseases returned, highest overall score first. From 1 to 25. Defaults to
10.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:
completedstring
Always
gene_diseasesobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
Open Targets Platform (EMBL-EBI and partners).string
public when the data comes from a public body, commercial otherwisestring
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 dateResult
Nested underdata.result.
boolean
Whether the input named one gene in the source.
object[]
Search hits with a near name, only when matched is false after a symbol search.
string
Ensembl gene ID of the search hit.
string
Approved symbol of the search hit.
string
Approved name of the search hit.
null when the source gives no value.object
The matched gene, or null.
string
Ensembl gene ID.
string
Approved gene symbol.
string
Approved gene name.
null when the source gives no value.integer
Number of diseases associated with the gene before limit.
object[]
Associated diseases, highest overall score first.
string
EFO or MONDO disease identifier.
string
Disease name.
number
Overall association score, 0 to 1: strength of evidence, not causation or clinical risk.
object[]
Evidence scores by datatype, in source order.
string
Evidence datatype: genetic_association, somatic_mutation, known_drug, affected_pathway, literature, rna_expression, animal_model or genetic_literature.
number
Association score from this datatype alone, 0 to 1.
string
Open Targets evidence page for the gene and disease.
string
Open Targets Platform release as year.month (26.09); null when no association query ran.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/gene-diseases \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"gene": "BRCA1",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/gene-diseases", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"gene": "BRCA1",
"limit": 2
}),
});
const result = await agent.tool('lookup/gene-diseases', {
gene: 'BRCA1',
limit: 2
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "gene_diseases",
"result": {
"matched": true,
"gene": {
"ensembl_id": "ENSG00000012048",
"symbol": "BRCA1",
"name": "BRCA1 DNA repair associated"
},
"total_associations": 1324,
"diseases": [
{
"disease_id": "MONDO_0007254",
"name": "breast cancer",
"score": 0.8436508158150241,
"evidence": [
{
"datatype": "literature",
"score": 0.9984727309333157
},
{
"datatype": "genetic_association",
"score": 0.9857814423386521
},
{
"datatype": "genetic_literature",
"score": 0.607930797611621
}
],
"page_url": "https://platform.opentargets.org/evidence/ENSG00000012048/MONDO_0007254"
},
{
"disease_id": "MONDO_0003582",
"name": "hereditary breast ovarian cancer syndrome",
"score": 0.8278837838347972,
"evidence": [
{
"datatype": "literature",
"score": 0.40300598598830056
},
{
"datatype": "animal_model",
"score": 0.40179666241146067
},
{
"datatype": "genetic_association",
"score": 0.9179786150922271
},
{
"datatype": "genetic_literature",
"score": 0.8855819352769478
}
],
"page_url": "https://platform.opentargets.org/evidence/ENSG00000012048/MONDO_0003582"
}
],
"release": "26.09"
},
"evidence": {
"source": "Open Targets Platform (EMBL-EBI and partners)",
"source_kind": "public",
"retrieved_at": "2026-10-22T17:37:55.000Z",
"calls": [
{
"retrieved_at": "2026-10-22T17:37:55.000Z"
},
{
"retrieved_at": "2026-10-22T17:37:55.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}