Provider API

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

Create an API key

1. Open Profile 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.

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:

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

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

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

Daily earnings

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.