> For the complete documentation index, see [llms.txt](https://docs.getblock.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getblock.io/api-reference/cosmos/cosmos-rest-api/staking-pool-cosmos.md).

# staking pool - Cosmos

Example code for the staking pool REST method. Complete guide on how to use the staking pool REST method in GetBlock Web3 documentation.

Returns the staking pool: the total bonded and not-bonded token amounts.

## Endpoint

```
GET /cosmos/staking/v1beta1/pool
```

## Example

{% code overflow="wrap" %}

```bash
export COSMOS_REST=https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/

curl "${COSMOS_REST}cosmos/staking/v1beta1/pool"
```

{% endcode %}

## Response

```json
{
    "pool": {
        "not_bonded_tokens": "20000000000000",
        "bonded_tokens": "280000000000000"
    }
}
```

## Response Fields

| Field                    | Type   | Description                           |
| ------------------------ | ------ | ------------------------------------- |
| pool.bonded\_tokens      | string | Total bonded (staked) tokens in uatom |
| pool.not\_bonded\_tokens | string | Total not-bonded tokens in uatom      |

## Use Cases

* **Staking ratio**: Compute bonded vs. total supply
* **Network health**: Track staking participation

## Error Handling

| Error                     | Message       | Description                                                  |
| ------------------------- | ------------- | ------------------------------------------------------------ |
| 400 / Bad request         | Bad request   | A path, query, or body parameter was invalid                 |
| 404 / Not found           | Not found     | The account, validator, proposal, or resource does not exist |
| 403 / RBAC: access denied | Access denied | The GetBlock access token is missing or incorrect            |
