# Celestia API
> Live on-chain data from the Celestia network (TIA), the first modular data-availability blockchain, a proof-of-stake chain secured by delegated staking: an address's liquid TIA balance, total delegated (staked) TIA and pending staking rewards; the active validator set ranked by voting power with each validator's staked TIA, commission and status; a block's height, time, proposer and transaction count; and the live network economy — tip height, total TIA supply, bonded TIA and staking ratio.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/celestia-api/..."
```

## Pricing
- **Free** (Free) — 10,000 calls/Mo, 3 req/s
- **Basic** ($8/Mo) — 142,000 calls/Mo, 8 req/s
- **Pro** ($26/Mo) — 900,000 calls/Mo, 15 req/s
- **Scale** ($61/Mo) — 4,800,000 calls/Mo, 30 req/s

## Endpoints

### Network

#### `GET /v1/network` — Live Celestia chain economy: supply, bonded, staking ratio

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/celestia-api/v1/network"
```

**Response:**
```json
{
    "data": {
        "chain": "celestia",
        "source": "Celestia",
        "chain_id": "celestia",
        "tip_time": "2026-06-10T14:01:28.104462034Z",
        "bonded_tia": 506936382.416317,
        "tip_height": 11470462,
        "native_token": "TIA",
        "total_supply_tia": 1170342566.687279,
        "staking_ratio_pct": 43.32
    },
    "meta": {
        "timestamp": "2026-06-10T14:01:35.313Z",
        "request_id": "2cd9fd8d-c841-4b7a-9031-0c3259697fc5"
    },
    "status": "ok",
    "message": "Network state retrieved successfully",
    "success": true
}
```

### Account

#### `GET /v1/account` — An address liquid, staked and reward TIA

**Parameters:**
- `address` (query, required, string) — Celestia address (celestia1...) Example: `celestia19jz67suexyclppfg2wheh97sht69khld242y5e`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/celestia-api/v1/account?address=celestia19jz67suexyclppfg2wheh97sht69khld242y5e"
```

**Response:**
```json
{
    "data": {
        "source": "Celestia",
        "address": "celestia19jz67suexyclppfg2wheh97sht69khld242y5e",
        "liquid_tia": 0.049692,
        "staked_tia": 873.000076,
        "delegation_count": 1,
        "pending_rewards_tia": 0.014398
    },
    "meta": {
        "timestamp": "2026-06-10T14:01:35.510Z",
        "request_id": "65bd3ac3-ae99-4b0a-9132-12ab3d4b7988"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

### Validators

#### `GET /v1/validators` — Active validator set ranked by voting power

**Parameters:**
- `limit` (query, optional, string) — Number of validators (1-150) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/celestia-api/v1/validators?limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "source": "Celestia",
        "validators": [
            {
                "rank": 1,
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Anchorage Digital",
                "staked_tia": 56306544.193393,
                "commission_rate": 0.2,
                "operator_address": "celestiavaloper1llfydg9q5fnfuc0lfrwwqnvpywnw97lmvek8jf"
            },
            {
                "rank": 2,
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "P-OPS Team",
                "staked_tia": 23511024.450465,
                "commission_rate": 0.2,
                "operator_address": "celestiavaloper1ac4mnwg79gyvd0x5trl2fgjv07lgfas02jf378"
            },
            {
                "rank": 3,
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "BinanceNode",
                "staked_tia": 21797072.197019,
                "commission_rate": 0.2,
                "operator_address": "celestiavaloper1mpt4chntuewyktq64fgrszjp6ly7we5a3t4a8l"
            },
            {
                "rank": 4,
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Qubelabs",
                "staked_tia": 21761693.104808,
                "commission_rate": 0.2,
                "operator_address": "celestiavaloper1j2jq259d3rrc24876gwxg0ksp0
…(truncated, see openapi.json for full schema)
```

### Block

#### `GET /v1/block` — A block height, time, proposer and tx count

**Parameters:**
- `height` (query, optional, string) — Block height or latest Example: `latest`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/celestia-api/v1/block?height=latest"
```

**Response:**
```json
{
    "data": {
        "time": "2026-06-10T14:01:28.104462034Z",
        "height": 11470462,
        "source": "Celestia",
        "chain_id": "celestia",
        "tx_count": 5,
        "block_hash": "9QnNJYRmsqoQCVPvl+jUERk+Rn/b+MJQwvaE8sJ//kM=",
        "proposer_address": "OPvFKLiCGi4dkkKk4uJvHUUjx24="
    },
    "meta": {
        "timestamp": "2026-06-10T14:01:35.787Z",
        "request_id": "1c27173c-94c0-41e8-96b9-9cf4b2ebeebc"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata and endpoint catalog

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/celestia-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Celestia Cosmos REST API (celestia-rest.publicnode.com, live)",
        "service": "celestia-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/block": "A block's height, time, proposer and tx count (height=latest|N).",
            "GET /v1/account": "An address's liquid, staked and reward TIA (address=celestia19jz67suexyclppfg2wheh97sht69khld242y5e).",
            "GET /v1/network": "Live tip, total/bonded TIA supply and staking ratio.",
            "GET /v1/validators": "The active validator set ranked by voting power (limit=25)."
        },
        "tip_height": 11470462,
        "description": "Live on-chain data from the Celestia network (TIA), the first modular data-availability blockchain, a proof-of-stake chain secured by delegated staking, via a public Cosmos REST node. The account endpoint returns an address's liquid TIA balance, total delegated (staked) TIA and pending staking rewards; the validators endpoint returns the active validator set ranked by voting power with each validator's staked TIA, commission and status; the block endpoint returns a block's height, time, proposer and transaction count; the network endpoint returns the tip height, total TIA supply, bonded TIA and staking ratio. Live, no key, nothing stored. Distinct from the Cosmos Hub, Bitcoin, Dogecoin, VeChain, Solana and EVM on-chain APIs and from price feeds — this is Celestia's own TIA account state, delegated-sta
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/celestia-api
OpenAPI spec: https://www.oanor.com/api/celestia-api/openapi.json