# Gene Symbol & ID Resolver

> Gene Symbol & ID Resolver 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).

Resolves a gene symbol, alias, or Ensembl gene ID to NCBI Gene IDs with official symbol, name, aliases, and organism information

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/resolve/gene?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-symbol-id-resolver-a3eb7959
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4fpKyDR5BGphsMkSC92NY

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-symbol-id-resolver-a3eb7959 -d '<json body>'
```

Example prompt: Can you resolve the gene symbol BRCA1 in humans (taxon ID 9606) to its NCBI Gene ID and give me the official name and any aliases — return the top 3 matches?

## When to prefer this

Use this endpoint when you need to resolve an ambiguous gene symbol, alias, or Ensembl ID to a canonical NCBI Gene record — especially useful when standardizing gene identifiers across datasets, disambiguating aliases like HER2/ERBB2, or mapping Ensembl IDs to NCBI Gene IDs for downstream bioinformatics workflows. Prefer this over manual NCBI searches when operating within an automated agent pipeline that needs structured gene metadata programmatically.

## Known failure modes

- Query contains invalid characters or exceeds 40 characters — validation error returned
- Gene symbol not found in NCBI Gene database — empty results list
- Invalid taxon_id provided — error or no results
- Ensembl ID version suffix causes lookup failure if not stripped properly
- Limit out of range (less than 1 or greater than 10) — validation error

## How this service works

Resolve a gene symbol, an alias or an Ensembl gene ID to NCBI Gene IDs, with official symbol, name, aliases and organism.

## Output

Returns up to the requested number of matching gene records, each containing the NCBI Gene ID, official gene symbol, full gene name, known aliases, and the organism (taxonomy ID and name). Results are ranked by relevance to the query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "The most matching genes to return. From 1 to 10. Defaults to `5`."
  },
  "query": {
   "type": "string",
   "description": "An official gene symbol (TP53), an alias (P53, HER2) or an Ensembl gene ID (ENSG00000141510, a version suffix is dropped). 1 to 40 characters. Letters, digits, dots, dashes and `_` only, starting with a letter or digit."
  },
  "taxon_id": {
   "type": "integer",
   "description": "The organism as an NCBI Taxonomy ID; 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-symbol-id-resolver-a3eb7959/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)