---
title: "List addresses"
method: GET
path: "/address"
tags: ["address"]
---

# List addresses

`GET /address`

Returns a paginated list of Celestia addresses with their balances. Supports sorting by balance fields, delegation amounts, and block activity.

## Query parameters

- `limit` integer
- `offset` integer
- `sort` 'asc' | 'desc'
- `sort_by` 'id' | 'delegated' | 'spendable' | 'unbonding' | 'first_height' | 'last_height'

## Response `200`

OK

- ResponsesAddress[]
  - `balance` ResponsesBalance — Balance of address information
    - `currency` string
    - `delegated` string
    - `spendable` string
    - `unbonding` string
  - `celestials` ResponsesCelestial — Linked celestial id
    - `image_url` string
    - `name` string
    - `primary` boolean
    - `status` string
  - `first_height` integer
  - `hash` string
  - `id` integer
  - `is_forwarding` boolean
  - `last_height` integer
  - `name` string

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/celenium-io/apis/celenium-api.md) · [All operations](https://skmtc.net/celenium-io/apis/celenium-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/celenium-io/celenium-api/versions/df8fa3d17ac3/schema)