{"uid":"cap_4fpKyDR5BGphsMkSC92NY","slug":"gene-symbol-id-resolver-a3eb7959","name":"Gene Symbol & ID Resolver","description":"Resolve a gene symbol, an alias or an Ensembl gene ID to NCBI Gene IDs, with official symbol, name, aliases and organism.","url":"https://win.oneshotagent.com/v1/tools/resolve/gene?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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`."}}},"responseSchema":null,"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_0OuLHQGlzruV0A_2Zm4Ih","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, alias, or Ensembl gene ID to NCBI Gene IDs with official symbol, name, aliases, and organism information","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Canonical gene ID for analysis pipeline","prompt":"I need to look up the official NCBI Gene ID and full gene name for TP53 in humans — can you resolve that symbol and return the top result?"},{"title":"Alias disambiguation for literature review","prompt":"I keep seeing HER2 and ERBB2 used interchangeably — can you resolve 'HER2' to its official NCBI gene record for humans so I know the canonical symbol and ID?"},{"title":"Cross-species gene ID mapping","prompt":"What is the NCBI Gene ID for the mouse equivalent of Trp53? Use taxon ID 10090 and return up to 5 matches with their official symbols and aliases."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:36:10.835Z","isFirstParty":false,"canonicalSlug":"gene-symbol-id-resolver-a3eb7959"}