Duaer

Get started

Search ligands in Duaer

In Duaer, look up PDBe chemical component (CCD) ligands with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.

What you get

Ligands in Duaer data returns PDBe chemical component dictionary rows (name, formula, InChIKey). One successful search uses 1 credit.

Add the node from the Duaer Data category (Ligands). Related: Structures and Compounds.

Search on the canvas

  1. Open the node creator, select Duaer Data, then Ligands.
  2. Enter Words or CCD ID (a new node starts with ATP). Comma-separate several ids.
  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/ligands?...
  • Authorization: Bearer <Duaer key>
  • words or id (CCD, 1–3 characters) 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-ligands
description: >-
  Duaer ligands. Look up PDBe chemical component (CCD) ligands.
  One successful search uses 1 Duaer credit.
---

# Duaer ligands

Look up PDBe chemical component (CCD) ligands. Data comes from PDBe.

## When to use

- Look up a PDB chemical component by code or name.
- Get formula and name of a ligand in a structure.

## When not to use

- Structures that bind a ligand. Use https://skills.duaer.com/structures.md.

## Call

`GET https://api.duaer.com/v1/data/ligands?words=ATP&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` as a CCD chemical component id (1–3 characters). Comma-separate several ids.

- `words` — CCD id such as ATP or HEM.
- `id` — Optional. Same as words; combine for a batch.
- `limit` — Optional. From 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/ligands?words=ATP&limit=10` — PDBe components matching ATP.

## Result

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

- `ccdId`, `name`, `formula`, `weight`, `inchiKey`, `inchi`, `compoundType`, `firstObservedIn` — 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/structures.md — Duaer structures
- https://skills.duaer.com/compounds.md — Duaer compounds
- https://skills.duaer.com/crossrefs.md — Duaer crossrefs
- https://skills.duaer.com/metabolites.md — Duaer metabolites

Questions

How do Duaer ligands differ from structures?

Ligands look up CCD chemical component definitions. Structures search PDB entries and can filter by a bound ligand name.

In this section