# Regen Network Carbon-Credit On-Chain API
> Live on-chain data for Regen Network (the ecological-asset & carbon-credit Cosmos L1, chain regen-1) with no key: the on-chain ecocredit registry (credit classes, registered ecological projects, and issued credit batches with vintage dates), the Regen chain staking economics, the total REGEN supply, and the latest block.

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

## Pricing
- **Free** (Free) — 6,500 calls/Mo, 2 req/s
- **Basic** ($37/Mo) — 161,000 calls/Mo, 10 req/s
- **Pro** ($96/Mo) — 930,000 calls/Mo, 20 req/s
- **Scale** ($168/Mo) — 5,110,000 calls/Mo, 50 req/s

## Endpoints

### EcoCredit

#### `GET /v1/credit-batches` — Issued credit batches with vintage dates

**Parameters:**
- `limit` (query, optional, string) — Results 1-100 Example: `25`

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

**Response:**
```json
{
    "data": {
        "note": "The Regen issued credit batches (most recent first) — each batch is a tranche of credits with its denom, project, issuer and vintage period (start/end). Pass limit (1-100, default 25). total is the chain-wide batch count.",
        "count": 25,
        "total": 80,
        "source": "Regen Network (regen-1) LCD",
        "batches": [
            {
                "open": false,
                "denom": "MBS01-003-20240101-20340101-001",
                "issuer": "regen1tkkdcmq3r8al600hg5m95z62rxvdz27s9trxjnvte6z9ffvlf0ssjax9w9",
                "project_id": "MBS01-003",
                "vintage_end": "2034-01-01T05:00:00Z",
                "issuance_date": "2026-06-01T15:19:00.767631554Z",
                "vintage_start": "2024-01-01T05:00:00Z"
            },
            {
                "open": false,
                "denom": "MBS01-002-20251201-20301231-001",
                "issuer": "regen1tkkdcmq3r8al600hg5m95z62rxvdz27s9trxjnvte6z9ffvlf0ssjax9w9",
                "project_id": "MBS01-002",
                "vintage_end": "2030-12-31T00:00:00Z",
                "issuance_date": "2026-05-13T23:02:45.210066537Z",
                "vintage_start": "2025-12-01T00:00:00Z"
            },
            {
                "open": false,
                "denom": "C08-001-20170101-20221231-001",
                "issuer": "regen1v2ncquer9r2ytlkxh2djmmsq3e8we6rjc9snfn",
                "project_id": "C08-001",
                "vintage_end": "2022-12-3
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/credit-classes` — On-chain carbon-credit classes

**Parameters:**
- `limit` (query, optional, string) — Results 1-100 Example: `25`

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

**Response:**
```json
{
    "data": {
        "note": "The Regen on-chain credit classes — each class is a category of ecological credit (e.g. carbon 'C', biodiversity) with its admin and credit type. Pass limit (1-100, default 25). total is the chain-wide class count.",
        "count": 13,
        "total": 13,
        "source": "Regen Network (regen-1) LCD",
        "classes": [
            {
                "id": "C01",
                "admin": "regen123a7e9gvgm53zvswc6daq7c85xtzt8263lgasm",
                "metadata": "regen:13toVgkhsDeQTJA1DJ1diGYTb3Cmy1rZV24auNXxNPTcVTySoiFtiFq.rdf",
                "credit_type": "C"
            },
            {
                "id": "C02",
                "admin": "regen123a7e9gvgm53zvswc6daq7c85xtzt8263lgasm",
                "metadata": "regen:13toVgasFvVdGFg5VeijGetEbGHSJZwBc4jUVei2euKFgE6wqNp2Hgz.rdf",
                "credit_type": "C"
            },
            {
                "id": "C03",
                "admin": "regen1dlszg2sst9r69my4f84l3mj66zxcf3umcgujys30t84srg95dgvs8rn9rj",
                "metadata": "regen:13toVgLqqFAjByA2kZkDFq7PZB2HUyD3u8qFDiBidYjpdYBLeJvAzxB.rdf",
                "credit_type": "C"
            },
            {
                "id": "C04",
                "admin": "regen1c799jddmlz7segvg6jrw6w2k6svwafganjdznard3tc74n7td7rq39fqdp",
                "metadata": "regen:13toVgBisQqEmauHntQsW6mwpz71RSTwsjzhn9gxCQ16tdRjHPHTRoK.rdf",
                "credit_type": "C"
            },
            {
                "id": "KSH01",
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/credit-projects` — Registered ecological projects

**Parameters:**
- `limit` (query, optional, string) — Results 1-100 Example: `25`

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

**Response:**
```json
{
    "data": {
        "note": "The Regen registered ecological projects — each project (e.g. a reforestation or soil-carbon project) with its credit class and jurisdiction. Pass limit (1-100, default 25). total is the chain-wide project count.",
        "count": 25,
        "total": 60,
        "source": "Regen Network (regen-1) LCD",
        "projects": [
            {
                "id": "BT01-001",
                "admin": "regen1lwnyn04vqlq607yzq0y6y6xw7ty9zpntmzu44w75cc2v8g84srgsa725x5",
                "class_id": "BT01",
                "jurisdiction": "CO-ANT",
                "reference_id": null
            },
            {
                "id": "BT01-002",
                "admin": "regen1sqgszglq4660gh0mf4fc9j4twy458qvwzstn406f6zz6tmqrlfrsmujcky",
                "class_id": "BT01",
                "jurisdiction": "CO-CUN",
                "reference_id": null
            },
            {
                "id": "C01-001",
                "admin": "regen1v2ncquer9r2ytlkxh2djmmsq3e8we6rjc9snfn",
                "class_id": "C01",
                "jurisdiction": "CD-MN",
                "reference_id": "VCS-934"
            },
            {
                "id": "C01-002",
                "admin": "regen1v2ncquer9r2ytlkxh2djmmsq3e8we6rjc9snfn",
                "class_id": "C01",
                "jurisdiction": "KE",
                "reference_id": "VCS-612"
            },
            {
                "id": "C01-003",
                "admin": "regen1v2ncquer9r2yt
…(truncated, see openapi.json for full schema)
```

### Staking

#### `GET /v1/staking` — Regen chain staking economics & parameters

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

**Response:**
```json
{
    "data": {
        "note": "The Regen chain staking economics — bonded vs unbonded REGEN, the bonded ratio, and the staking parameters (unbonding period, max validators, minimum commission). No parameters.",
        "params": {
            "bond_denom": "uregen",
            "max_validators": 21,
            "min_commission_rate": 0,
            "unbonding_time_seconds": 1814400
        },
        "source": "Regen Network (regen-1) LCD",
        "bonded_regen": 94013038.55,
        "not_bonded_regen": 28608617.33,
        "bonded_ratio_percent": 76.67
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:22.599Z",
        "request_id": "fe4e4303-c6e0-4d02-91ab-636fd7b82737"
    },
    "status": "ok",
    "message": "Staking retrieved successfully",
    "success": true
}
```

### Supply

#### `GET /v1/supply` — Total REGEN supply

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

**Response:**
```json
{
    "data": {
        "note": "The total supply of REGEN (the native token of Regen Network), in both REGEN and the uregen micro-denomination. No parameters.",
        "denom": "REGEN",
        "source": "Regen Network (regen-1) LCD",
        "micro_denom": "uregen",
        "total_supply_regen": 235235068.43,
        "total_supply_uregen": "235235068431518"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:22.740Z",
        "request_id": "782866be-e874-4e39-943a-923cfaab1c44"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Chain

#### `GET /v1/block` — Latest block

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

**Response:**
```json
{
    "data": {
        "note": "The latest finalized Regen block — height, timestamp, chain id, proposer and transaction count. No parameters.",
        "time": "2026-06-15T02:10:15.727369216Z",
        "height": 27409303,
        "source": "Regen Network (regen-1) LCD",
        "num_txs": 0,
        "chain_id": "regen-1",
        "proposer_address": "zPrbxbRYvTQqLf5WThTVdtIwiGg="
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:22.858Z",
        "request_id": "b9262faf-afa1-4182-8239-5d9bb045b5b7"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "sample": {
            "credit_classes": 13
        },
        "source": "Regen public Cosmos REST / LCD nodes (regen-api.polkachu.com and mirrors), keyless",
        "service": "regen-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/block": "Latest block.",
            "GET /v1/supply": "Total REGEN supply.",
            "GET /v1/staking": "Regen chain staking economics & parameters.",
            "GET /v1/credit-batches": "Issued credit batches with vintage dates (limit).",
            "GET /v1/credit-classes": "Carbon-credit classes (limit) + chain-wide count.",
            "GET /v1/credit-projects": "Registered ecological projects (limit)."
        },
        "description": "Live on-chain data for Regen Network (the ecological-asset & carbon-credit Cosmos L1, chain regen-1) with no key: the on-chain ecocredit registry (credit classes, registered ecological projects, and issued credit batches with vintage dates), the Regen chain staking economics, the total REGEN supply, and the latest block. The Regen-on-chain / carbon-credits / staking layer for ESG dashboards, carbon registries and research. Distinct from other chain readers — Regen and its on-chain carbon-credit registry. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:22.977Z",
        "request_id": "67d5b2b6-eb9c-4c55-aabc-0f40131f4e8e"
    },
    "status": "ok",
    "message
…(truncated, see openapi.json for full schema)
```


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