# Carbon API
> Live on-chain data for Carbon (chain id carbon-1) — the Switcheo-built Cosmos-SDK Layer-1 for decentralised derivatives and spot trading, whose native token is SWTH — served directly from public LCD/REST nodes with multi-node failover. The status endpoint returns the latest block height and time, chain id, the staking bond denom and the current minting inflation rate. The validators endpoint lists the active bonded validator set ranked by stake, each with its moniker, operator address, self-plus-delegated SWTH, commission rate and jailed flag. The supply endpoint returns the total SWTH supply, the amount bonded in staking and the resulting bonded ratio. The governance endpoint returns the most recent on-chain proposals with their id, title, status and voting window. SWTH uses an 8-decimal base denomination which is converted to whole SWTH with exact big-integer scaling, and every figure is read live from the chain — nothing bundled or modelled — behind a short server-side cache with keep-warm so the feed stays fast and fresh. Ideal for staking dashboards, validator and delegator tooling, explorers, governance trackers and portfolio or analytics apps across the Cosmos and DeFi ecosystem. Live keyless upstream. 5 endpoints.

## 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/carbon-api/..."
```

## Pricing
- **Free** (Free) — 280 calls/Mo, 2 req/s
- **Starter** ($13/Mo) — 14,900 calls/Mo, 8 req/s
- **Pro** ($37/Mo) — 76,000 calls/Mo, 16 req/s
- **Mega** ($90/Mo) — 300,000 calls/Mo, 40 req/s

## Endpoints

### Carbon

#### `GET /v1/governance` — Recent governance proposals

**Parameters:**
- `limit` (query, optional, string) — Max proposals to return (1-50) Example: `15`

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

**Response:**
```json
{
    "data": {
        "chain": "Carbon",
        "count": 15,
        "symbol": "SWTH",
        "proposals": [
            {
                "id": "425",
                "title": "V2.81.0 Software Upgrade Proposal",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2026-05-18T11:22:51.220753085Z",
                "voting_end_time": "2026-05-18T23:22:51.220753085Z"
            },
            {
                "id": "424",
                "title": "V2.80.0 Software Upgrade Proposal",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2026-05-08T06:18:47.305998974Z",
                "voting_end_time": "2026-05-09T06:18:47.305998974Z"
            },
            {
                "id": "423",
                "title": "Cancel V2.79.0 Software Upgrade Proposal",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2026-05-01T08:59:53.381881406Z",
                "voting_end_time": "2026-05-02T08:59:53.381881406Z"
            },
            {
                "id": "422",
                "title": "V2.79.0 Software Upgrade Proposal",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2026-04-30T03:24:01.872841193Z",
                "voting_end_time": "2026-05-01T03:24:01.872841193Z"
            },
            {
                "id": "421",
                "title": "Recover Injective -> Demex IBC client",
                "status": "PROPOSAL_STATUS_PASSED",
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/status` — Chain status

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

**Response:**
```json
{
    "data": {
        "chain": "Carbon",
        "source": "Carbon (Switcheo) LCD",
        "symbol": "SWTH",
        "chain_id": "carbon-1",
        "bond_denom": "swth",
        "inflation_pct": 0,
        "latest_block_time": "2026-06-15T20:39:57.527089314Z",
        "latest_block_height": 94869259
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:27.173Z",
        "request_id": "b1651d57-8064-4b21-bbb8-3e9db8ad825b"
    },
    "status": "ok",
    "message": "Carbon status retrieved",
    "success": true
}
```

#### `GET /v1/supply` — SWTH supply & bonded ratio

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

**Response:**
```json
{
    "data": {
        "chain": "Carbon",
        "denom": "swth",
        "bonded": 477009583.959402,
        "symbol": "SWTH",
        "decimals": 8,
        "total_supply": 1903707576.187886,
        "bonded_ratio_pct": 25.06
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:27.245Z",
        "request_id": "c6c7a98b-77fc-4cfb-a199-451380de3a3a"
    },
    "status": "ok",
    "message": "Carbon supply retrieved",
    "success": true
}
```

#### `GET /v1/validators` — Active validator set

**Parameters:**
- `limit` (query, optional, string) — Max validators to return (1-300) Example: `100`

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

**Response:**
```json
{
    "data": {
        "chain": "Carbon",
        "count": 5,
        "symbol": "SWTH",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 207481317.863914,
                "moniker": "Switcheo Staking",
                "commission_pct": 5,
                "operator_address": "swthvaloper1hexzxh3apqpqzzchhgynks2xr8ar8qvd58d2u7"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 89398396.447156,
                "moniker": "Intsol Community Staking 🚀",
                "commission_pct": 5.5,
                "operator_address": "swthvaloper1yyepjpjsrve6vy6l77nk88dtts8la9r3thj7kj"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 84263896.661455,
                "moniker": "BlockHunters 🎯",
                "commission_pct": 5,
                "operator_address": "swthvaloper1fdqkq5gc5x8h6a0j9hamc30stlvea6zlsh4y7s"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 60467201.109123,
                "moniker": "Born2Stake ↗️",
                "commission_pct": 5,
                "operator_address": "swthvaloper1z2jz4uhz8zgt4lq9mq5slz3ukyp3grhlr9xv3k"
            },
            {
                "jailed": false,
                "s
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

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

**Response:**
```json
{
    "data": {
        "api": "Carbon API",
        "chain": "Carbon",
        "denom": "swth",
        "source": "Carbon public LCD/REST nodes (Cosmos SDK)",
        "symbol": "SWTH",
        "chain_id": "carbon-1",
        "decimals": 8,
        "endpoints": [
            "/v1/status",
            "/v1/validators",
            "/v1/supply",
            "/v1/governance",
            "/v1/meta"
        ],
        "description": "Live on-chain data for Carbon — the Switcheo-built Cosmos-SDK Layer-1 for decentralised derivatives trading (SWTH).",
        "documentation": "https://carbon-api.oanor.dev"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:27.401Z",
        "request_id": "ae7754d4-73c3-4c28-83bf-694a55019bd4"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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