# Gene Summary Lookup by NCBI Gene ID or Symbol

> Gene Summary Lookup by NCBI Gene ID or Symbol is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-20).

Returns structured gene information (name, aliases, organism, genomic position, and functional summary) given an NCBI Gene ID or official gene symbol.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/gene-summary?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gene-summary-lookup-by-ncbi-gene-id-or-symbol-304f6dea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZeT6HgrNXjGJB9M1ANIpo

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-summary-lookup-by-ncbi-gene-id-or-symbol-304f6dea -d '<json body>'
```

Example prompt: Can you look up the TP53 gene (human, taxon ID 9606) and give me its official name, aliases, chromosomal position, and a summary of what it does?

## When to prefer this

Use this endpoint when an agent needs authoritative gene metadata (name, position, function) from NCBI for a known gene symbol or Gene ID. Prefer over manual NCBI web searches when structured, machine-readable gene data is required. Particularly useful when integrating gene annotations into bioinformatics pipelines, research summaries, or when cross-referencing gene identities across organisms.

## Known failure modes

- Gene symbol not found for given taxon ID — returns not-found or empty result
- Invalid or non-existent NCBI Gene ID — returns error or empty response
- Ambiguous gene symbol matching multiple genes — may return unexpected record
- Invalid taxon ID format — returns validation error
- Gene ID contains non-digit characters — schema validation failure

## How this service works

Describe a gene from its NCBI Gene ID or official symbol: name, aliases, organism, position on the genome and a summary of its function.

## Output

Returns structured gene metadata including the official gene name, known aliases, the organism it belongs to, its chromosomal/genomic position, and a text summary of its biological function — sourced from the NCBI Gene database.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "symbol": {
   "type": "string",
   "description": "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."
  },
  "gene_id": {
   "type": "string",
   "description": "An NCBI Gene ID, digits only, for example 7157. Digits only, 1 to 12."
  },
  "taxon_id": {
   "type": "integer",
   "description": "The organism as an NCBI Taxonomy ID, used with `symbol`; 9606 (human) unless set, 10090 is mouse. From 1 to 999999999. Defaults to `9606`."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gene-summary-lookup-by-ncbi-gene-id-or-symbol-304f6dea/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)
