> 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/stable/cosmos-rest.md).

# Cosmos REST

GetBlock provides fast and reliable access to Stable nodes via the Cosmos SDK REST API. Connect to the Stable network without running your own infrastructure.

The Cosmos SDK REST (LCD / gRPC-gateway) interface for Stable: HTTP/JSON module queries for accounts, balances, staking, distribution, governance, and mint, plus the latest block, node info, and transaction broadcast. Addresses use the bech32 `cosmos1…` form; amounts are in the base denomination (ausdt0).

## Endpoint

```bash
https://shared.ap-southeast-1.getblock.io/<ACCESS-TOKEN>/
```

## Available Endpoints

### Accounts

| Endpoint              | Method | Description                                                                                                             |
| --------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------- |
| auth-account          | GET    | Returns an account's details, including its account number and sequence (nonce), as a protobuf-Any wrapped account type |
| bank-balances         | GET    | Returns all token balances held by an address, paginated                                                                |
| bank-balance-by-denom | GET    | Returns the balance of a single denomination for an address                                                             |

### Network

| Endpoint       | Method | Description                                                                                                 |
| -------------- | ------ | ----------------------------------------------------------------------------------------------------------- |
| bank-supply    | GET    | Returns the total supply of all denominations on the chain, paginated                                       |
| mint-inflation | GET    | Returns the current minting inflation rate                                                                  |
| latest-block   | GET    | Returns the latest block via the Cosmos base tendermint service, including its header and transactions      |
| node-info      | GET    | Returns the node's information and the application's version details via the Cosmos base tendermint service |

### Staking

| Endpoint            | Method | Description                                                              |
| ------------------- | ------ | ------------------------------------------------------------------------ |
| staking-validators  | GET    | Returns all staking validators, optionally filtered by status, paginated |
| staking-validator   | GET    | Returns a single validator by its operator address                       |
| staking-delegations | GET    | Returns all delegations made by a delegator, paginated                   |
| staking-pool        | GET    | Returns the staking pool: the total bonded and not-bonded token amounts  |

### Distribution

| Endpoint             | Method | Description                                                                         |
| -------------------- | ------ | ----------------------------------------------------------------------------------- |
| distribution-rewards | GET    | Returns the outstanding staking rewards for a delegator, per validator and in total |

### Governance

| Endpoint      | Method | Description                                                            |
| ------------- | ------ | ---------------------------------------------------------------------- |
| gov-proposals | GET    | Returns governance proposals, optionally filtered by status, paginated |
| gov-proposal  | GET    | Returns a single governance proposal by its numeric identifier         |

### Transactions

| Endpoint     | Method | Description                                       |
| ------------ | ------ | ------------------------------------------------- |
| broadcast-tx | POST   | Broadcasts a signed, protobuf-encoded transaction |

## See Also

* [Cosmos overview](https://docs.getblock.io/api-reference/cosmos.md)
* [Stable REST API Reference](https://docs.cosmos.network/api)
* [Cosmos SDK Module Specifications](https://docs.cosmos.network/main/build/modules)
