curl -X POST https://win.oneshotagent.com/v1/tools/lookup/gene-summary \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"symbol": "TP53"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/gene-summary", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"symbol": "TP53"
}),
});
const result = await agent.tool('lookup/gene-summary', {
symbol: 'TP53'
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "gene_summary",
"result": {
"gene": {
"gene_id": "7157",
"symbol": "TP53",
"name": "tumor protein p53",
"status": "live",
"current_gene_id": null,
"aliases": [
"BCC7",
"BMFS5",
"LFS1",
"P53",
"TRP53"
],
"other_names": [
"cellular tumor antigen p53",
"antigen NY-CO-13",
"mutant tumor protein 53",
"phosphoprotein p53",
"transformation-related protein 53",
"tumor protein 53",
"tumor supressor p53"
],
"organism": {
"scientific_name": "Homo sapiens",
"common_name": "human",
"taxon_id": 9606
},
"chromosome": "17",
"map_location": "17p13.1",
"location": {
"assembly_accession": "GCF_000001405.40",
"chromosome_accession": "NC_000017.11",
"start": 7668420,
"end": 7687489,
"strand": "-"
},
"exon_count": 13,
"summary": "This gene encodes a tumor suppressor protein containing transcriptional activation, DNA binding, and oligomerization domains. The encoded protein responds to diverse cellular stresses to regulate expression of target genes, thereby inducing cell cycle arrest, apoptosis, senescence, DNA repair, or changes in metabolism. Mutations in this gene are associated with a variety of human cancers, including hereditary cancers such as Li-Fraumeni syndrome. Alternative splicing of this gene and the use of alternate promoters result in multiple transcript variants and isoforms. Additional isoforms have also been shown to result from the use of alternate translation initiation codons from identical transcript variants (PMIDs: 12032546, 20937277).",
"summary_source": "provided by RefSeq, Dec 2016",
"mim_ids": [
"191170"
]
},
"other_gene_ids": []
},
"evidence": {
"source": "US National Center for Biotechnology Information",
"source_kind": "public",
"retrieved_at": "2026-10-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Life sciences
Gene Summary
Describe a gene from its NCBI Gene ID or official symbol: name, aliases, organism, position on the genome and a summary of its function.
POST
/
v1
/
tools
/
lookup
/
gene-summary
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/gene-summary \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"symbol": "TP53"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/gene-summary", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"symbol": "TP53"
}),
});
const result = await agent.tool('lookup/gene-summary', {
symbol: 'TP53'
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "gene_summary",
"result": {
"gene": {
"gene_id": "7157",
"symbol": "TP53",
"name": "tumor protein p53",
"status": "live",
"current_gene_id": null,
"aliases": [
"BCC7",
"BMFS5",
"LFS1",
"P53",
"TRP53"
],
"other_names": [
"cellular tumor antigen p53",
"antigen NY-CO-13",
"mutant tumor protein 53",
"phosphoprotein p53",
"transformation-related protein 53",
"tumor protein 53",
"tumor supressor p53"
],
"organism": {
"scientific_name": "Homo sapiens",
"common_name": "human",
"taxon_id": 9606
},
"chromosome": "17",
"map_location": "17p13.1",
"location": {
"assembly_accession": "GCF_000001405.40",
"chromosome_accession": "NC_000017.11",
"start": 7668420,
"end": 7687489,
"strand": "-"
},
"exon_count": 13,
"summary": "This gene encodes a tumor suppressor protein containing transcriptional activation, DNA binding, and oligomerization domains. The encoded protein responds to diverse cellular stresses to regulate expression of target genes, thereby inducing cell cycle arrest, apoptosis, senescence, DNA repair, or changes in metabolism. Mutations in this gene are associated with a variety of human cancers, including hereditary cancers such as Li-Fraumeni syndrome. Alternative splicing of this gene and the use of alternate promoters result in multiple transcript variants and isoforms. Additional isoforms have also been shown to result from the use of alternate translation initiation codons from identical transcript variants (PMIDs: 12032546, 20937277).",
"summary_source": "provided by RefSeq, Dec 2016",
"mim_ids": [
"191170"
]
},
"other_gene_ids": []
},
"evidence": {
"source": "US National Center for Biotechnology Information",
"source_kind": "public",
"retrieved_at": "2026-10-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Describe a gene from its NCBI Gene ID or its official symbol: the symbol, the full name, the aliases and other names, the organism, the chromosome and cytogenetic band, the position on the current assembly with the strand, the exon count, the curated summary of its function with the note saying who wrote it, and the OMIM ids. Give exactly one of
gene_id and symbol; taxon_id picks the organism for a symbol search and is human (9606) unless set. A symbol is matched without regard to case in the organism; when several genes carry it, the first is described and the rest are listed in other_gene_ids. status says whether the record is live, replaced (then current_gene_id names the record to use) or discontinued. gene is null when no gene has the id or the symbol. Covers every organism with genes in the US National Center for Biotechnology Information’s Gene database. Coordinates are zero-based, as the source gives them.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
An NCBI Gene ID, digits only, for example 7157. Digits only, 1 to 12.
string
An official gene symbol, for example TP53, matched without regard to case in the organism
taxon_id names. 1 to 30 characters. No spaces, quotes or square brackets.integer
The organism as an NCBI Taxonomy ID, used with
symbol; 9606 (human) unless set, 10090 is mouse. From 1 to 999999999. Defaults to 9606.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_summaryobject
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.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.
object
The gene described; null when no gene has the id or the symbol.
string
The NCBI Gene ID.
string
The gene symbol.
null when the source gives no value.string
The full name.
null when the source gives no value.string
live, replaced or discontinued.
string
The Gene ID that replaced this record; null unless
status is replaced.string[]
Other symbols the gene is known by.
string[]
Other names the gene or its product is known by.
object
The organism the gene belongs to.
string
The organism’s scientific name, for example Homo sapiens.
null when the source gives no value.string
The organism’s common name, for example human.
null when the source gives no value.number
The organism’s NCBI Taxonomy ID.
null when the source gives no value.string
The chromosome, for example 17.
null when the source gives no value.string
The cytogenetic band, for example 17p13.1.
null when the source gives no value.object
The position on the current assembly; null when the source places the gene nowhere.
string
The assembly the position is on, for example GCF_000001405.40.
null when the source gives no value.string
The chromosome sequence the position is on, for example NC_000017.11.
null when the source gives no value.number
The smaller coordinate, zero-based.
null when the source gives no value.number
The larger coordinate, zero-based.
null when the source gives no value.string
The strand: + or -.
null when the source gives no value.number
How many exons the source counts.
null when the source gives no value.string
The curated summary of the gene’s function.
null when the source gives no value.string
Who wrote the summary and when, for example “provided by RefSeq, Dec 2016”.
null when the source gives no value.string[]
The gene’s OMIM ids.
string[]
The other Gene IDs a symbol search found, after the one described; empty otherwise.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/gene-summary \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"symbol": "TP53"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/gene-summary", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"symbol": "TP53"
}),
});
const result = await agent.tool('lookup/gene-summary', {
symbol: 'TP53'
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "gene_summary",
"result": {
"gene": {
"gene_id": "7157",
"symbol": "TP53",
"name": "tumor protein p53",
"status": "live",
"current_gene_id": null,
"aliases": [
"BCC7",
"BMFS5",
"LFS1",
"P53",
"TRP53"
],
"other_names": [
"cellular tumor antigen p53",
"antigen NY-CO-13",
"mutant tumor protein 53",
"phosphoprotein p53",
"transformation-related protein 53",
"tumor protein 53",
"tumor supressor p53"
],
"organism": {
"scientific_name": "Homo sapiens",
"common_name": "human",
"taxon_id": 9606
},
"chromosome": "17",
"map_location": "17p13.1",
"location": {
"assembly_accession": "GCF_000001405.40",
"chromosome_accession": "NC_000017.11",
"start": 7668420,
"end": 7687489,
"strand": "-"
},
"exon_count": 13,
"summary": "This gene encodes a tumor suppressor protein containing transcriptional activation, DNA binding, and oligomerization domains. The encoded protein responds to diverse cellular stresses to regulate expression of target genes, thereby inducing cell cycle arrest, apoptosis, senescence, DNA repair, or changes in metabolism. Mutations in this gene are associated with a variety of human cancers, including hereditary cancers such as Li-Fraumeni syndrome. Alternative splicing of this gene and the use of alternate promoters result in multiple transcript variants and isoforms. Additional isoforms have also been shown to result from the use of alternate translation initiation codons from identical transcript variants (PMIDs: 12032546, 20937277).",
"summary_source": "provided by RefSeq, Dec 2016",
"mim_ids": [
"191170"
]
},
"other_gene_ids": []
},
"evidence": {
"source": "US National Center for Biotechnology Information",
"source_kind": "public",
"retrieved_at": "2026-10-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-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}