Get started

Materials Project in Duaer

In Duaer: Computed inorganic materials from the Materials Project by formula or by elements they contain, with material id, formula, elements, and site count. One successful search uses 1 credit.

What you get

Duaer Materials Project searches about 150,000 computed materials through the standard OPTIMADE interface. Each row links to the material page with band structure, stability, and more.

Pick Duaer Data → Materials Project in the node creator, or open the data market. Related: JARVIS-DFT, NOMAD, Crystal structures (COD).

When to use it

List known phases of a composition, such as all LiFePO4 entries.
Find materials that contain a set of elements for screening.

When not to use it

Measured structures from papers. Use Crystal structures (COD).
Band gaps in the result rows. Use JARVIS-DFT.

Search on the canvas

Open the node creator and pick Duaer Data → Materials Project.
Fill Formula (such as LiFePO4). Optional: Elements.
Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

GET https://api.duaer.com/v1/data/materials-project?formula=LiFePO4
Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-materials-project
description: >-
  Duaer Materials Project. Computed inorganic materials from the Materials Project by formula or by elements they contain, with material id, formula, elements, and site count.
  One successful search uses 1 Duaer credit.
---

# Duaer Materials Project

Duaer Materials Project searches about 150,000 computed materials through the standard OPTIMADE interface. Each row links to the material page with band structure, stability, and more.

## When to use

- List known phases of a composition, such as all LiFePO4 entries.
- Find materials that contain a set of elements for screening.

## When not to use

- Measured structures from papers. Use https://skills.duaer.com/cod.md.
- Band gaps in the result rows. Use https://skills.duaer.com/jarvis.md.

## Call

`GET https://api.duaer.com/v1/data/materials-project?formula=LiFePO4`

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 `formula` or `elements`.

- `formula` — Formula such as LiFePO4. Matches the reduced formula.
- `elements` — Optional. Materials that contain all of these, such as Li,Fe,O.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/materials-project?formula=LiFePO4` — lithium iron phosphate phases.
- `GET https://api.duaer.com/v1/data/materials-project?elements=Li,Co,O&limit=20` — materials containing lithium, cobalt, and oxygen.

## Result

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

- `materialId` — Materials Project id, such as mp-19017.
- `formula` — reduced formula, elements in alphabetical order.
- `elements`, `elementCount` — elements and their count.
- `sites` — atoms in the cell.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/jarvis.md — Duaer JARVIS-DFT
- https://skills.duaer.com/nomad.md — Duaer NOMAD
- https://skills.duaer.com/cod.md — Duaer Crystal structures (COD)

Questions

How many credits does a Materials Project search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

Why does Duaer show LiFePO4 as FeLiO4P?

Materials Project stores reduced formulas with elements in alphabetical order. Duaer converts your formula the same way before searching.

In this section