{"uid":"cap_f5YoUmtmyFYFi6QZYNuRu","slug":"uniprot-protein-gene-symbol-resolver-33d0cd81","name":"UniProt Protein/Gene Symbol Resolver","description":"Resolve a gene symbol, synonym, entry name or protein name to UniProt accessions.","url":"https://win.oneshotagent.com/v1/tools/resolve/protein?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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`."}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fuYRtJCAzS5ui1DqjaF-Z","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a gene symbol, synonym, entry name, or protein name to UniProt accessions and associated metadata for a given organism.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Gene-to-accession for drug target pipeline","prompt":"I need the UniProt accession for BRCA2 in human — reviewed entries only, give me up to 5 matches so I can pick the right isoform."},{"title":"Cross-species protein ID lookup","prompt":"What's the UniProt accession for Trp53 in mouse (taxon 10090)? Include unreviewed entries and return up to 3 results."},{"title":"Protein name to accession for data annotation","prompt":"Resolve the protein name 'Cellular tumor antigen p53' to its UniProt accession for Homo sapiens — just the top reviewed match."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-26T12:30:17.064Z","isFirstParty":false,"canonicalSlug":"uniprot-protein-gene-symbol-resolver-33d0cd81"}