# List

**GET /stake-pools**

<p align="right">status: <strong>stable</strong></p>

List all known stake pools ordered by descending `non_myopic_member_rewards`.
The `non_myopic_member_rewards` — and thus the ordering — depends on the `?stake` query
parameter.

Some pools _may_ also have metadata attached to them.



## Servers
- https://localhost:8090/v2: https://localhost:8090/v2 ()



## Parameters


#### Query parameters
- **stake** (integer)
  The stake the user intends to delegate in Lovelace. Required.



## Responses
### 400: Bad Request

#### Body Parameters: application/json (object)
- **message** (string)
  May occur when an endpoint requires the presence of a query parameter that is missing.
- **code** (string)
  

### 200: Ok

#### Body Parameters: application/json (array[object])
- **id** (string(hex|bech32))
  A unique identifier for the pool.
- **metrics** (object)
  
- **cost** (object)
  Estimated cost set by the pool operator when registering his pool.
This fixed cost is taken from each reward earned by the pool before splitting rewards between stakeholders.

May be omitted if the wallet hasn't found the pool's registration cerificate yet.

- **margin** (object)
  Variable margin on the total reward given to an operator before splitting rewards between stakeholders.

May be omitted if the wallet hasn't found the pool's registration cerificate yet.

- **pledge** (object)
  Minimal stake amount that a stake pool is willing to honor.

May be omitted if the wallet hasn't found the pool's registration cerificate yet.

- **metadata** (object)
  Information about the stake pool.

- **retirement** (object)
  The epoch in which a stake pool retires.

May be omitted if the wallet hasn't yet found a retirement certificate
for this stake pool.

- **flags** (array[string])
  Various flags applicable to stake pools. Possible flags:

| flag     | description                                                                                                      |
| ---      | ---                                                                                                              |
| delisted | The pool is marked as delisted on a configured SMASH server; metadata for this pool have therefore been dropped. |



[Powered by Bump.sh](https://bump.sh)