# UniProt Protein/Gene Symbol Resolver

> UniProt Protein/Gene Symbol 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-26).

Resolves a gene symbol, synonym, entry name, or protein name to UniProt accessions and associated metadata for a given organism.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/resolve/protein?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-26
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uniprot-protein-gene-symbol-resolver-33d0cd81
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f5YoUmtmyFYFi6QZYNuRu

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 uniprot-protein-gene-symbol-resolver-33d0cd81 -d '<json body>'
```

Example prompt: Can you resolve the gene symbol EGFR in humans to its UniProt accession? I only want reviewed Swiss-Prot entries and the top 3 results.

## When to prefer this

Use this endpoint when you need to translate a human-readable gene symbol, protein name, or entry name into a canonical UniProt accession — particularly when building bioinformatics pipelines, annotating datasets, or resolving identifiers before downstream database queries. It is preferable to manual UniProt search when automation or agent orchestration is required, and supports filtering by organism and review status for precision.

## Known failure modes

- Query with disallowed characters or out-of-range length returns validation error
- taxon_id outside 1–999999999 range is rejected
- limit outside 1–10 range is rejected
- Gene symbol not found for the specified taxon returns empty matches array
- Ambiguous query may return multiple unrelated proteins (ambiguous: true)
- Payment failure via x402 prevents endpoint access

## How this service works

Resolve a gene symbol, synonym, entry name or protein name to UniProt accessions.

## Output

A JSON object containing: total match count, an ambiguous flag, and a list of matches each with UniProt accession, entry name, protein name, gene name and synonyms, organism (taxon ID and scientific name), annotation score (0–5), reviewed status, matched field, and a direct UniProt entry page URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "The most matches to return. From 1 to 10. Defaults to `5`."
  },
  "query": {
   "type": "string",
   "description": "A gene symbol or synonym, entry name, or protein name; letters, digits, spaces and the characters . _ / - only. 1 to 60 characters."
  },
  "taxon_id": {
   "type": "integer",
   "description": "The organism taxonomy ID; human (9606) by default. From 1 to 999999999. Defaults to `9606`."
  },
  "reviewed_only": {
   "type": "boolean",
   "description": "Only reviewed entries; false includes unreviewed entries. Defaults to `true`."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 1,
  "matches": [
   {
    "gene": "TP53",
    "organism": {
     "taxon_id": 9606,
     "scientific_name": "Homo sapiens"
    },
    "page_url": "https://www.uniprot.org/uniprotkb/P04637/entry",
    "reviewed": true,
    "accession": "P04637",
    "entry_name": "P53_HUMAN",
    "matched_on": "gene",
    "protein_name": "Cellular tumor antigen p53",
    "gene_synonyms": [
     "P53"
    ],
    "annotation_score": 5
   }
  ],
  "ambiguous": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uniprot-protein-gene-symbol-resolver-33d0cd81/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)