Duaer

Get started

Search HGNC in Duaer

In Duaer, look up approved gene symbols via HGNC with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.

What you get

HGNC in Duaer data returns approved symbols, locus, and Ensembl/Entrez/UniProt cross-references. One successful search uses 1 credit.

Add the node from the Duaer Data category (HGNC). Related: Genes.

Search on the canvas

  1. Open the node creator, select Duaer Data, then HGNC.
  2. Enter Words (a new node starts with BRCA1), or an HGNC id.
  3. Limit defaults to 10, max 20. Select Execute step.

A successful search uses 1 credit. Production deliverables land in the data pool.

Call the API

  • GET https://api.duaer.com/v1/data/hgnc?...
  • Authorization: Bearer <Duaer key>
  • words or id is required.

For keys, refer to Authentication for the Duaer public API. Below is the English call skill.

Call skill

The skill for calling this data. Keep it English.

---
name: duaer-hgnc
description: >-
  Duaer HGNC. Look up approved gene symbols from HGNC.
  One successful search uses 1 Duaer credit.
---

# Duaer HGNC

Look up approved gene symbols from HGNC. Data comes from HGNC.

## When to use

- Check the approved human gene symbol and HGNC id.
- Resolve a previous or alias symbol.

## When not to use

- Gene ids across species. Use https://skills.duaer.com/genes.md.

## Call

`GET https://api.duaer.com/v1/data/hgnc?words=BRCA1&limit=10`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `words` or `id`. If you send both, Duaer uses `id`.

- `words` — gene symbol or name words, such as BRCA1.
- `id` — Optional. HGNC id such as HGNC:1100 or 1100.
- `limit` — Optional. From 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/hgnc?words=BRCA1&limit=10` — HGNC records for BRCA1.

## Result

The response is `{ "items": [...] }`. Each item has `source` (`HGNC`), `title`, `url`, and `summary`, plus:

- `hgncId`, `symbol`, `name`, `locusGroup`, `locusType`, `location`, `ensemblId`, `entrezId`, `uniprotIds`, `status` — text.

Fields without a value are empty strings.

## Credits

A successful search uses 1 credit, even when it finds nothing.
Wrong input or a missing search field returns 400 with a message and uses 0.
A failed upstream search returns 503 and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/genes.md — Duaer genes
- https://skills.duaer.com/ensembl.md — Duaer Ensembl
- https://skills.duaer.com/proteins.md — Duaer proteins

Questions

How do Duaer HGNC, Genes, and Ensembl differ?

Genes uses MyGene. Ensembl emphasizes genomic coordinates. HGNC is the human gene nomenclature authority for approved symbols and aliases.

In this section