---
sidebar_position: 9
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lium.io/llms.txt
> Use this file to discover all available pages before exploring further.
>
> Lium (lium.io) is a GPU rental marketplace: rent NVIDIA GPUs by the hour, billed per second.

# Provider API

Read your nodes and daily earnings from scripts, with an API key. The full reference is at [provider-api.lium.io/docs](https://provider-api.lium.io/docs).

## Create an API key

1. **Open** [Profile Settings](https://provider.lium.io/settings) and find **API tokens**.
2. **Name the key** and keep only the scopes it needs: `read` is enough for the endpoints below.
3. **Click Create token** (enter your current password if asked) and copy the key, which starts with `lpk_`. It is shown only once and lasts 90 days.

A script can also create one with a signed-in session: `POST /auth/api-tokens` with `name`, `scopes` and `expires_in_days` (1 to 365). See the [reference](https://provider-api.lium.io/docs).

To revoke a key, click **Revoke** next to it under **API tokens**. **Log out everywhere**, a password change or a new e-mail address also ends every key.

## Call the API

Send the key in the `Authorization` header:

```bash
export LIUM_API_KEY=lpk_...
curl -s https://provider-api.lium.io/auth/me -H "Authorization: Bearer $LIUM_API_KEY"
```

## Read endpoints

**Your nodes and why each is or is not listed**

```bash
curl -s https://provider-api.lium.io/executors/listing -H "Authorization: Bearer $LIUM_API_KEY"
```

One entry per node: `listing_state`, `blocking_reasons`, `gpu_count`, `rented_gpu_count` and the idle pay state.

**One node**

```bash
curl -s https://provider-api.lium.io/executors/<node-id> -H "Authorization: Bearer $LIUM_API_KEY"
```

**Daily earnings**

```bash
curl -s "https://provider-api.lium.io/provider-ledger/daily?from=2026-10-01&to=2026-10-24" \
  -H "Authorization: Bearer $LIUM_API_KEY"
```

One row per UTC day and kind, in USD, plus lifetime and month totals. Without dates it returns the last 30 days; a range is at most 90 days.