Duaer

Get started

Search orthologs in Duaer

In Duaer, search cross-species orthologs with Duaer Data (MyGene HomoloGene). One successful search uses 1 credit. This page includes the full English call skill.

What you get

Orthologs in Duaer data lists cross-species genes in a HomoloGene group. One successful search uses 1 credit.

Add the node from the Duaer Data category (Orthologs). Related: Genes and Organisms.

Search on the canvas

  1. Open the node creator, select Duaer Data, then Orthologs.
  2. Gene is required (a new node starts with INS). Species defaults to 9606; Ortholog species is optional (for example 10090 to keep mouse only).
  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/orthologs?...
  • Authorization: Bearer <Duaer key>
  • gene 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-orthologs
description: >-
  Duaer orthologs. Search cross-species orthologs (MyGene HomoloGene).
  One successful search uses 1 Duaer credit.
---

# Duaer orthologs

Search cross-species orthologs (MyGene HomoloGene). Data comes from MyGene.

## When to use

- Find the matching gene in another species.
- Map a human gene to mouse or zebrafish.

## When not to use

- Ensembl Compara orthologues. Use https://skills.duaer.com/ensembl-homology.md.

## Call

`GET https://api.duaer.com/v1/data/orthologs?gene=INS&species=9606&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

`gene` is required.

- `gene` — gene symbol or NCBI Gene id. Look up symbols with https://skills.duaer.com/genes.md.
- `species` — Optional. NCBI taxonomy id for the query gene. Default `9606` (human). Look up ids with https://skills.duaer.com/organisms.md.
- `orthologSpecies` — Optional. Keep only orthologs for this taxonomy id (for example `10090` for mouse).
- `limit` — Optional. From 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/orthologs?gene=INS&species=9606&limit=10` — orthologs of human INS.

## Result

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

- `gene`, `geneId`, `name` — text.
- `taxId` — number.
- `organism`, `ensemblId` — text.
- `homologeneId` — number.
- `queryGene` — text.
- `queryTaxId` — number.

Reuse `gene` when searching proteins, genes, expression, or targets.

Fields without a value are empty strings.

## Credits

A successful search uses 1 credit, even when it finds nothing.
If you send a `gene` without a HomoloGene group, Duaer returns no items and uses 0.
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/organisms.md — Duaer organisms
- https://skills.duaer.com/proteins.md — Duaer proteins
- https://skills.duaer.com/targets.md — Duaer targets

Questions

What does Ortholog species do in Duaer?

It keeps only members for that taxonomy id; leave it empty to return every species in the HomoloGene group.

In this section