# Sommelier Cross-Chain Vault-Governance On-Chain API
> Live on-chain data from Sommelier (sommelier-3), the Cosmos-SDK layer-1 that governs automated Ethereum DeFi "cellar" strategy vaults via its cork module. Read the list of governed cellar vault IDs (the Ethereum strategy-vault addresses Sommelier votes on); the cork governance parameters (vote threshold, corks per validator); the reward-token auctions (id, tokens for sale, unit price in SOMM, price-decrease schedule, status); plus the staking pool with bonded ratio and validator set, the total SOMM supply and the latest block. The Sommelier / cross-chain-vault / DeFi-automation layer for explorers, vault dashboards and governance tooling.

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

## Pricing
- **Free** (Free) — 2,700 calls/Mo, 2 req/s
- **Basic** ($15/Mo) — 65,000 calls/Mo, 5 req/s
- **Pro** ($42/Mo) — 245,000 calls/Mo, 15 req/s
- **Business** ($91/Mo) — 945,000 calls/Mo, 40 req/s

## Endpoints

### Vaults

#### `GET /v1/auctions` — Reward-token auctions

**Parameters:**
- `status` (query, optional, string) — active or ended Example: `ended`
- `limit` (query, optional, string) — Number of auctions (1-100) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sommelier-api/v1/auctions?status=ended&limit=20"
```

**Response:**
```json
{
    "data": {
        "chain": "sommelier-3",
        "count": 4,
        "status": "ended",
        "auctions": [
            {
                "id": 2,
                "end_block": 13171910,
                "start_block": 13125000,
                "sale_token_denom": "gravity0x853d955aCEf822Db058eb8505911ED77F175b99e",
                "current_unit_price_somm": 2.8570000000000003e-21,
                "initial_unit_price_somm": 1.2634079e-17,
                "starting_tokens_for_sale": 2.0067438481113948e+21,
                "remaining_tokens_for_sale": null,
                "price_decrease_block_interval": 10
            },
            {
                "id": 3,
                "end_block": 13172490,
                "start_block": 13125000,
                "sale_token_denom": "gravity0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
                "current_unit_price_somm": 1.85076158271682e-10,
                "initial_unit_price_somm": 1.263407916514005e-5,
                "starting_tokens_for_sale": 14301280023,
                "remaining_tokens_for_sale": null,
                "price_decrease_block_interval": 10
            },
            {
                "id": 9,
                "end_block": 15122494,
                "start_block": 15120000,
                "sale_token_denom": "gravity0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
                "current_unit_price_somm": 0.010022556986615463,
                "initial_unit_price_somm": 0.010209129166666667,
             
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/cellars` — Governed Ethereum cellar vault IDs

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

**Response:**
```json
{
    "data": {
        "chain": "sommelier-3",
        "count": 36,
        "governs": "Ethereum cellar strategy vaults",
        "cellar_ids": [
            "0x0274a704a6D9129F90A62dDC6f6024b33EcDad36",
            "0x03df2A53Cbed19B824347D6a45d09016C2D1676a",
            "0x05641a27C82799AaF22b436F20A3110410f29652",
            "0x0C190DEd9Be5f512Bd72827bdaD4003e9Cc7975C",
            "0x18ea937aba6053bC232d9Ae2C42abE7a8a2Be440",
            "0x19B8D8FC682fC56FbB42653F68c7d48Dd3fe597E",
            "0x3F07A84eCdf494310D397d24c1C78B041D2fa622",
            "0x4068BDD217a45F8F668EF19F1E3A1f043e4c4934",
            "0x4986fD36b6b16f49b43282Ee2e24C5cF90ed166d",
            "0x5195222f69c5821f8095ec565E71e18aB6A2298f",
            "0x6A6AF5393DC23D7e3dB28D28Ef422DB7c40932B6",
            "0x6E2dAc3b9E9ADc0CbbaE2D0B9Fd81952a8D33872",
            "0x6F069F711281618467dAe7873541EcC082761B33",
            "0x6a6731f1754e3088ea35c8ddfd55cFF4d0FA5052",
            "0x6b7f87279982d919Bbf85182DDeAB179B366D8f2",
            "0x6c1edce139291Af5b84fB1e496c9747F83E876c9",
            "0x6c51041A91C91C86f3F08a72cB4D3F67f1208897",
            "0x7bAD5DF5E11151Dc5Ee1a648800057C5c934c0d5",
            "0x97e6E0a40a3D02F12d1cEC30ebfbAE04e37C119E",
            "0x991Fc0B9f027A80E2d642Eb260a41FfC14b2f450",
            "0x9a7b4980C6F0FCaa50CD5f288Ad7038f434c692e",
            "0xC7b69E15D86C5c1581dacce3caCaF5b68cd6596F",
            "0xDBe19d1c3F21b1bB250ca7BDaE0687A97B5f77e6",
            "0xb5b2
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/cork-params` — Cork governance parameters

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

**Response:**
```json
{
    "data": {
        "chain": "sommelier-3",
        "vote_threshold": 0.67,
        "max_corks_per_validator": 1000
    },
    "meta": {
        "timestamp": "2026-06-15T11:16:10.223Z",
        "request_id": "da655691-84de-422d-878b-44f639b7d6e9"
    },
    "status": "ok",
    "message": "Cork params retrieved successfully",
    "success": true
}
```

### Staking

#### `GET /v1/staking` — Staking pool, bonded ratio & params

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

**Response:**
```json
{
    "data": {
        "chain": "sommelier-3",
        "denom": "SOMM",
        "params": {
            "bond_denom": "usomm",
            "max_validators": 50,
            "unbonding_time": "2419200s",
            "min_commission_rate": "0.000000000000000000"
        },
        "bonded_ratio": 0.511632,
        "bonded_tokens": 76305983.743891,
        "not_bonded_tokens": 72836319.269314
    },
    "meta": {
        "timestamp": "2026-06-15T11:16:10.407Z",
        "request_id": "4a10bca0-960e-4276-9d20-c6a23f82ee6d"
    },
    "status": "ok",
    "message": "Staking retrieved successfully",
    "success": true
}
```

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

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

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

**Response:**
```json
{
    "data": {
        "chain": "sommelier-3",
        "count": 8,
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Sommelier Foundation",
                "website": null,
                "voting_power": 52336612.628359,
                "commission_rate": 0,
                "operator_address": "sommvaloper1rtt69afx4dtj4t3urgm93qq7kxypzzeew4w8t0"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "polkachu.com",
                "website": "https://polkachu.com",
                "voting_power": 14294485.626561,
                "commission_rate": 0.04,
                "operator_address": "sommvaloper1gp957czryfgyvxwn3tfnyy2f0t9g2p4pu0vlu3"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Chill Validation",
                "website": "www.chillvalidation.com",
                "voting_power": 3831671.335829,
                "commission_rate": 0.05,
                "operator_address": "sommvaloper1l38kl5u0rmqj2rr4336jjxpmap9gl7amkf9yff"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "Golden Ratio Staking",
                "website": "https://www.goldenstaking.com",
                "voting_power": 2876487.980401,
            
…(truncated, see openapi.json for full schema)
```

### Chain

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

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

**Response:**
```json
{
    "data": {
        "time": "2026-06-15T11:16:05.461539031Z",
        "chain": "sommelier-3",
        "height": 26228222,
        "num_txs": 0,
        "proposer_address": "3Z1LIKzNsVNfRuyY8QwQyVcdNs4="
    },
    "meta": {
        "timestamp": "2026-06-15T11:16:10.661Z",
        "request_id": "f1b989dd-cb5a-43ba-9a59-2ba865032cc5"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

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

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

**Response:**
```json
{
    "data": {
        "chain": "sommelier-3",
        "denom": "SOMM",
        "micro_denom": "usomm",
        "total_supply": 499999978.9,
        "total_supply_micro": "499999978900000"
    },
    "meta": {
        "timestamp": "2026-06-15T11:16:10.778Z",
        "request_id": "2f5d973d-0f83-4cb5-9c05-8678fd2eaed4"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Chain metadata & endpoint guide

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

**Response:**
```json
{
    "data": {
        "chain": "sommelier-3",
        "token": "SOMM",
        "source": "Sommelier public Cosmos REST/LCD, keyless (3-mirror)",
        "network": "Sommelier",
        "decimals": 6,
        "examples": {
            "cellars": "/v1/cellars",
            "auctions": "/v1/auctions?status=ended&limit=10",
            "validators": "/v1/validators?limit=20"
        },
        "endpoints": {
            "/v1/block": "latest block (height, time, chain_id)",
            "/v1/supply": "total SOMM supply",
            "/v1/cellars": "governed Ethereum cellar strategy-vault IDs (addresses)",
            "/v1/staking": "staking pool, bonded ratio and params",
            "/v1/auctions": "reward-token auctions (status=active|ended, limit)",
            "/v1/validators": "bonded validator set ranked by voting power (limit)",
            "/v1/cork-params": "cork governance params (vote threshold, corks per validator)"
        },
        "micro_denom": "usomm",
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T11:16:10.859Z",
        "request_id": "0af6710e-1aac-4fc8-928c-685e147338d8"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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