Available languages: [Python](https://databento.com/docs/api-historical/metadata/metadata-list-datasets.python.md) · [C++](https://databento.com/docs/api-historical/metadata/metadata-list-datasets.cpp.md) · [Rust](https://databento.com/docs/api-historical/metadata/metadata-list-datasets.rust.md) · [HTTP](https://databento.com/docs/api-historical/metadata/metadata-list-datasets.http.md)

Source: https://databento.com/docs/api-historical/metadata/metadata-list-datasets



### Historical.metadata.list_datasets

List all valid [dataset](https://databento.com/docs/api-historical/basics/datasets.md) IDs on Databento.

Use this method to list the available dataset IDs (string identifiers), so you can use
other methods which take the `dataset` parameter.

#### API method

```python
Historical.metadata.list_datasets(
    start_date: date | str | None = None,
    end_date: date | str | None = None,
) -> list[str]
```

#### Parameters

| Parameter | Type | Required | Description |
| `start_date` | date or str | optional | The inclusive UTC start date of the request range as a [Python date](https://docs.python.org/3/library/datetime.html#date-objects) or [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) date string. If `None` then first date available. |
| `end_date` | date or str | optional | The exclusive UTC end date of the request range as a [Python date](https://docs.python.org/3/library/datetime.html#date-objects) or [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) date string. If `None` then last date available. |

#### Returns

`list[str]`

A list of available dataset IDs.

#### Example usage

```python
import databento as db

client = db.Historical("$YOUR_API_KEY")

datasets = client.metadata.list_datasets()
print(datasets)
```
#### Example response

```json
[
    "ARCX.PILLAR",
    "BATS.PITCH",
    "BATY.PITCH",
    "DBEQ.BASIC",
    "EDGA.PITCH",
    "EDGX.PITCH",
    "EPRL.DOM",
    "EQUS.MINI",
    "EQUS.SUMMARY",
    "GLBX.MDP3",
    "IEXG.TOPS",
    "IFEU.IMPACT",
    "IFLL.IMPACT",
    "IFUS.IMPACT",
    "MEMX.MEMOIR",
    "NDEX.IMPACT",
    "OCEA.MEMOIR",
    "OPRA.PILLAR",
    "XASE.PILLAR",
    "XBOS.ITCH",
    "XCBF.PITCH",
    "XCHI.PILLAR",
    "XCIS.TRADESBBO",
    "XEEE.EOBI",
    "XEUR.EOBI",
    "XNAS.BASIC",
    "XNAS.ITCH",
    "XNYS.PILLAR",
    "XPSX.ITCH"
]
```