curl -X POST https://win.oneshotagent.com/v1/tools/lookup/gene-expression \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"gene": "TP53",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/gene-expression", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"gene": "TP53",
"limit": 2
}),
});
const result = await agent.tool('lookup/gene-expression', {
gene: 'TP53',
limit: 2
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "gene_expression",
"result": {
"matched": true,
"gene": {
"gencode_id": "ENSG00000141510.19",
"ensembl_id": "ENSG00000141510",
"symbol": "TP53",
"entrez_gene_id": 7157,
"description": "tumor protein p53",
"chromosome": "chr17"
},
"dataset": "gtex_v11",
"unit": "TPM",
"tissues": [
{
"tissue": "Cells_EBV-transformed_lymphocytes",
"ontology_id": "EFO:0000572",
"median_tpm": 54.4686
},
{
"tissue": "Skin_Sun_Exposed_Lower_leg",
"ontology_id": "UBERON:8480050",
"median_tpm": 25.8191
}
]
},
"evidence": {
"source": "Genotype-Tissue Expression (GTEx) project, US National Institutes of Health",
"source_kind": "public",
"retrieved_at": "2026-10-23T18:33:09.767Z",
"calls": [
{
"retrieved_at": "2026-10-23T18:33:09.767Z"
},
{
"retrieved_at": "2026-10-23T18:33:09.767Z"
}
],
"as_of": null
}
}
}
Life sciences
Gene Expression
Look up median expression of a human gene across normal tissues, highest expression first.
POST
/
v1
/
tools
/
lookup
/
gene-expression
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/gene-expression \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"gene": "TP53",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/gene-expression", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"gene": "TP53",
"limit": 2
}),
});
const result = await agent.tool('lookup/gene-expression', {
gene: 'TP53',
limit: 2
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "gene_expression",
"result": {
"matched": true,
"gene": {
"gencode_id": "ENSG00000141510.19",
"ensembl_id": "ENSG00000141510",
"symbol": "TP53",
"entrez_gene_id": 7157,
"description": "tumor protein p53",
"chromosome": "chr17"
},
"dataset": "gtex_v11",
"unit": "TPM",
"tissues": [
{
"tissue": "Cells_EBV-transformed_lymphocytes",
"ontology_id": "EFO:0000572",
"median_tpm": 54.4686
},
{
"tissue": "Skin_Sun_Exposed_Lower_leg",
"ontology_id": "UBERON:8480050",
"median_tpm": 25.8191
}
]
},
"evidence": {
"source": "Genotype-Tissue Expression (GTEx) project, US National Institutes of Health",
"source_kind": "public",
"retrieved_at": "2026-10-23T18:33:09.767Z",
"calls": [
{
"retrieved_at": "2026-10-23T18:33:09.767Z"
},
{
"retrieved_at": "2026-10-23T18:33:09.767Z"
}
],
"as_of": null
}
}
}
Reports median expression across donors of normal (non-diseased) tissue for human genes only. Uses open-access summary data from the Genotype-Tissue Expression (GTEx) project, US National Institutes of Health. Please cite the GTEx Portal (https://gtexportal.org) and dbGaP accession phs000424. Values are transcripts per million (TPM), static between releases; the answer names the dataset. Pass an official human gene symbol or an Ensembl gene ID, with or without a version. Exactly one matching reference row is required; otherwise matched is false and candidates lists the returned rows. Tissues are sorted by highest median first; omit limit for all tissues. The data is for research and is not medical advice.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
Official human gene symbol (TP53) or Ensembl gene ID (ENSG00000141510), with or without a version. 1 to 30 characters. Letters, digits, ”.”, ”_” and ”-” only.
integer
Tissues returned, highest median first; omit for all tissues. From 1 to 60.
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_expressionobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
Genotype-Tissue Expression (GTEx) project, US National Institutes of Health.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 exactly one reference gene matched.
object[]
Reference rows, only when matched is false.
string
Versioned GENCODE gene ID.
string
Gene symbol.
object
Matched gene, or null.
string
Versioned GENCODE gene ID.
string
Ensembl gene ID without version.
string
Gene symbol.
integer
Entrez gene ID, when available.
null when the source gives no value.string
Gene description without the source annotation.
string
Chromosome of the gene.
string
GTEx dataset release.
string
Transcripts per million.
object[]
Normal tissues, highest median expression first.
string
GTEx tissue site detail ID.
string
Source ontology ID, usually UBERON; cultured cells may use EFO.
null when the source gives no value.number
Median expression across donors in TPM.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/gene-expression \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"gene": "TP53",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/gene-expression", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"gene": "TP53",
"limit": 2
}),
});
const result = await agent.tool('lookup/gene-expression', {
gene: 'TP53',
limit: 2
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "gene_expression",
"result": {
"matched": true,
"gene": {
"gencode_id": "ENSG00000141510.19",
"ensembl_id": "ENSG00000141510",
"symbol": "TP53",
"entrez_gene_id": 7157,
"description": "tumor protein p53",
"chromosome": "chr17"
},
"dataset": "gtex_v11",
"unit": "TPM",
"tissues": [
{
"tissue": "Cells_EBV-transformed_lymphocytes",
"ontology_id": "EFO:0000572",
"median_tpm": 54.4686
},
{
"tissue": "Skin_Sun_Exposed_Lower_leg",
"ontology_id": "UBERON:8480050",
"median_tpm": 25.8191
}
]
},
"evidence": {
"source": "Genotype-Tissue Expression (GTEx) project, US National Institutes of Health",
"source_kind": "public",
"retrieved_at": "2026-10-23T18:33:09.767Z",
"calls": [
{
"retrieved_at": "2026-10-23T18:33:09.767Z"
},
{
"retrieved_at": "2026-10-23T18:33:09.767Z"
}
],
"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}