> For the complete documentation index, see [llms.txt](https://savefee.gitbook.io/savefee/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://savefee.gitbook.io/savefee/api-reference/get-v1-public-system.md).

# GET /v1/public/system

An open endpoint describing energy provider configuration and current pool liquidity. It returns the same response to every caller and exposes nothing account-specific.

## Request

```bash
curl https://api.savefee.io/v1/public/system
```

No authentication, no parameters.

## Response `200`

```json
{
  "provider": {
    "registration": {
      "grantActivePermissionTo": "T…",
      "requiredContractPermissions": [
        "DelegateResourceContract",
        "UnDelegateResourceContract"
      ],
      "registerPath": "/v1/seller/register",
      "auth": "dashboard_session",
      "defaultPaymentFrequencyHours": 24,
      "paymentFrequencyHoursRange": { "min": 1, "max": 720 },
      "defaultEnergyConfig": {
        "minPrice": 400,
        "profitShareBps": 8000,
        "minDelegateAmount": 10000,
        "maintainBuffer": 0,
        "minDurationSec": 3600,
        "maxDurationSec": 2592000
      },
      "instructions": "…"
    }
  },
  "internalPools": {
    "poolCount": 2,
    "activeCount": 2,
    "inactiveCount": 0,
    "totalAvailableUnits": "5699776",
    "totalReservedUnits": "0",
    "totalMatchableUnits": "5699776",
    "resource": "ENERGY",
    "unit": "energy"
  },
  "updatedAt": "2026-08-07T04:15:36.181Z"
}
```

## What it is useful for

| Block                               | Use                                                                                                |
| ----------------------------------- | -------------------------------------------------------------------------------------------------- |
| `internalPools.totalMatchableUnits` | How much energy can be matched right now — a useful liquidity signal before placing a large batch. |
| `internalPools.totalReservedUnits`  | How much is already committed to orders in flight.                                                 |
| `updatedAt`                         | Freshness of the snapshot.                                                                         |
| `provider`                          | Configuration for energy sellers.                                                                  |

The snapshot gains fields over time — read the ones you need and ignore the rest.

{% hint style="info" %}
Because this endpoint needs no credentials, it makes a convenient reachability check for monitoring — no key involved and nothing spent.
{% endhint %}