{"openapi":"3.1.0","info":{"title":"Sommelier Cross-Chain Vault-Governance On-Chain API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/sommelier-api","description":"oanor gateway"}],"tags":[{"name":"Vaults"},{"name":"Staking"},{"name":"Chain"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/auctions":{"get":{"operationId":"get_v1_auctions","tags":["Vaults"],"summary":"Reward-token auctions","description":"","parameters":[{"name":"status","in":"query","required":false,"description":"active or ended","schema":{"type":"string"},"example":"ended"},{"name":"limit","in":"query","required":false,"description":"Number of auctions (1-100)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"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,"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,"starting_tokens_for_sale":7932249,"price_decrease_block_interval":10},{"id":13,"end_block":16842509,"start_block":16815000,"sale_token_denom":"gravity0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","current_unit_price_somm":2.1105167595e-14,"initial_unit_price_somm":4.09e-13,"starting_tokens_for_sale":1.35e+19,"price_decrease_block_interval":10}]},"meta":{"timestamp":"2026-06-15T11:16:09.951Z","request_id":"c39ef648-3be0-4bff-85d2-74d9e73c046a"},"status":"ok","message":"Auctions retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/cellars":{"get":{"operationId":"get_v1_cellars","tags":["Vaults"],"summary":"Governed Ethereum cellar vault IDs","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","0xb5b29320d2Dde5BA5BAFA1EbcD270052070483ec","0xc7372Ab5dd315606dB799246E8aA112405abAeFf","0xcBf2250F33c4161e18D4A2FA47464520Af5216b5","0xcf4B531b4Cde95BD35d71926e09B2b54c564F5b6","0xd33dAd974b938744dAC81fE00ac67cb5AA13958E","0xdAdC82e26b3739750E036dFd9dEfd3eD459b877A","0xfd6db5011b171B05E1Ea3b92f9EAcaEEb055e971","0x6285e597eCF1398c2a22fB91949486d092e540C8","0xf7E20d67aBd4923b4B48320a22A1E81887291296","0x1dffb366b5c5A37A12af2C127F31e8e0ED86BDbe","0x27500De405a3212D57177A789E30bb88b0AdbeC5","0xC47bB288178Ea40bF520a91826a3DEE9e0DbFA4C","0xF4279E93a06F9d4b5d0625b1F471AA99Ef9B686b"]},"meta":{"timestamp":"2026-06-15T11:16:10.091Z","request_id":"43f7c015-9b50-4cbd-bd95-a3b820673dec"},"status":"ok","message":"Cellars retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/cork-params":{"get":{"operationId":"get_v1_cork_params","tags":["Vaults"],"summary":"Cork governance parameters","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/staking":{"get":{"operationId":"get_v1_staking","tags":["Staking"],"summary":"Staking pool, bonded ratio & params","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/validators":{"get":{"operationId":"get_v1_validators","tags":["Staking"],"summary":"Bonded validator set by voting power","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of validators (1-200)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"sommelier-3","count":8,"validators":[{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Sommelier Foundation","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,"commission_rate":0,"operator_address":"sommvaloper1fpwexrflqq066c80qfgs875qq39ws3t689gj28"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"FreshSTAKING","website":"https://FreshSTAKING.com/","voting_power":948651.199413,"commission_rate":0.03,"operator_address":"sommvaloper17h2x3j7u44qkrq0sk8ul0r2qr440rwgj2latjp"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Validatus","website":"https://www.validatus.com","voting_power":931808.703019,"commission_rate":0.05,"operator_address":"sommvaloper1jgfjrec3u2ev6v89sav06we8jn5tf4cqlpj997"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Encapsulate (fka KingSuper)","website":"https://encapsulate.xyz","voting_power":741208.749353,"commission_rate":0.02,"operator_address":"sommvaloper1s0lankh33kprer2l22nank5rvsuh9ksa8324s2"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Tessellated","website":"https://tessellated.io","voting_power":345057.520956,"commission_rate":0.1,"operator_address":"sommvaloper1n56swda49evz92zhcw2xc8esx6kzt8qm3yd5w3"}],"bonded_validators":8},"meta":{"timestamp":"2026-06-15T11:16:10.529Z","request_id":"5bae6aee-3c79-4f1b-b7b1-ff81882115c0"},"status":"ok","message":"Validators retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/block":{"get":{"operationId":"get_v1_block","tags":["Chain"],"summary":"Latest block","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/supply":{"get":{"operationId":"get_v1_supply","tags":["Chain"],"summary":"Total SOMM supply","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Chain metadata & endpoint guide","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2700,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1470,"monthly_call_quota":65000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4230,"monthly_call_quota":245000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":9090,"monthly_call_quota":945000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/sommelier-api"}