{"openapi":"3.1.0","info":{"title":"Osmosis DEX On-Chain API","version":"1.0.0","description":"Live on-chain data for Osmosis (the leading Cosmos DEX / AMM L1, chain osmosis-1) with no key: the DEX liquidity pools (GAMM AMM pools with their assets, reserves, swap fee and total count), a single pool full detail, the Osmosis chain staking economics, the total OSMO supply, and the latest block.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/osmosischain-api","description":"oanor gateway"}],"tags":[{"name":"DEX"},{"name":"Staking"},{"name":"Supply"},{"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/pool":{"get":{"operationId":"get_v1_pool","tags":["DEX"],"summary":"Single liquidity pool full detail","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Numeric pool id","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Full detail for a single Osmosis liquidity pool — its assets with on-chain reserves, weights, swap/exit fee and total shares. Pass id (the numeric pool id, e.g. 1).","pool":{"id":"1","type":"Pool","assets":[{"denom":"ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2","amount":"236184699856","weight":"536870912000000"},{"denom":"uosmo","amount":"10011061539026","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.002,"total_shares":"35489126249509848615403363"},"source":"Osmosis (osmosis-1) LCD"},"meta":{"timestamp":"2026-06-15T02:10:32.815Z","request_id":"dbd2a01f-5e64-49d5-97ef-35b271141f28"},"status":"ok","message":"Pool 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/pools":{"get":{"operationId":"get_v1_pools","tags":["DEX"],"summary":"DEX liquidity pools + chain-wide pool count","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Results 1-100","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The Osmosis DEX liquidity pools (GAMM automated-market-maker pools) — each pool's id, type, swap/exit fee, total shares and its assets with on-chain reserves. Pass limit (1-100, default 20). total_pools is the chain-wide pool count.","count":20,"pools":[{"id":"1","type":"Pool","assets":[{"denom":"ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2","amount":"236184699856","weight":"536870912000000"},{"denom":"uosmo","amount":"10011061539026","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.002,"total_shares":"35489126249509848615403363"},{"id":"2","type":"Pool","assets":[{"denom":"uion","amount":"311380830","weight":"858993459200000"},{"denom":"uosmo","amount":"38526471770","weight":"214748364800000"}],"exit_fee":0,"swap_fee":0.005,"total_shares":"100016142858767589108746342"},{"id":"3","type":"Pool","assets":[{"denom":"ibc/1480B8FD20AD5FCAE81EA87584D269547DD4D436843C1D20F15E00EB64743EF4","amount":"30087268426","weight":"536870912000000"},{"denom":"uosmo","amount":"537569374915","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.002,"total_shares":"5424469356714862526615368"},{"id":"4","type":"Pool","assets":[{"denom":"ibc/1480B8FD20AD5FCAE81EA87584D269547DD4D436843C1D20F15E00EB64743EF4","amount":"194134403957","weight":"708669603840000"},{"denom":"ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2","amount":"42076600216","weight":"365072220160000"}],"exit_fee":0,"swap_fee":0.003,"total_shares":"2862775462482147116132492"},{"id":"5","type":"Pool","assets":[{"denom":"ibc/9712DBB13B9631EDFA9BF61B55F1B2D290B2ADB67E3A4EB3A875F3B6081B3B84","amount":"129463024048866","weight":"536870912000000"},{"denom":"uosmo","amount":"184866796389","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.002,"total_shares":"3372355274435980542832847917"},{"id":"6","type":"Pool","assets":[{"denom":"ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2","amount":"4196037971","weight":"322122547200000"},{"denom":"ibc/9712DBB13B9631EDFA9BF61B55F1B2D290B2ADB67E3A4EB3A875F3B6081B3B84","amount":"288901241549102","weight":"751619276800000"}],"exit_fee":0,"swap_fee":0.003,"total_shares":"4116681204540729358339769843"},{"id":"7","type":"Pool","assets":[{"denom":"ibc/7C4D60AA95E5A7558B0A364860979CA34B7FF8AAF255B87AF9E879374470CEC0","amount":"3530483224445","weight":"536870912000000"},{"denom":"uosmo","amount":"26853069191","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.002,"total_shares":"73432314333768452903429347"},{"id":"8","type":"Pool","assets":[{"denom":"ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2","amount":"3986549756","weight":"644245094400000"},{"denom":"ibc/7C4D60AA95E5A7558B0A364860979CA34B7FF8AAF255B87AF9E879374470CEC0","amount":"14829174249908","weight":"429496729600000"}],"exit_fee":0,"swap_fee":0.003,"total_shares":"31799085503459470216651048"},{"id":"9","type":"Pool","assets":[{"denom":"ibc/E6931F78057F7CC5DA0FD6CEF82FF39373A6E0452BF1FD76910B93292CF356C1","amount":"56788151424092","weight":"536870912000000"},{"denom":"uosmo","amount":"748779812420","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.002,"total_shares":"162435545910009237365962238"},{"id":"10","type":"Pool","assets":[{"denom":"ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2","amount":"9318262397","weight":"536870912000000"},{"denom":"ibc/E6931F78057F7CC5DA0FD6CEF82FF39373A6E0452BF1FD76910B93292CF356C1","amount":"29911934882214","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.003,"total_shares":"41793633434065330099880137"},{"id":"11","type":"Pool","assets":[{"denom":"uion","amount":"5257","weight":"536870912000000"},{"denom":"uosmo","amount":"2902666","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.005,"total_shares":"17249645360434800527"},{"id":"12","type":"Pool","assets":[{"denom":"ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2","amount":"464","weight":"536870912000000"},{"denom":"ibc/A0CC0CF735BFB30E730C70019D4218A1244FF383503FF7579C9201AB93CA9293","amount":"86298","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.003,"total_shares":"690428475018949295"},{"id":"13","type":"Pool","assets":[{"denom":"ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2","amount":"1030130012","weight":"536870912000000"},{"denom":"ibc/A0CC0CF735BFB30E730C70019D4218A1244FF383503FF7579C9201AB93CA9293","amount":"601130811374","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.003,"total_shares":"165162028428462621082"},{"id":"14","type":"Pool","assets":[{"denom":"ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2","amount":"653820","weight":"536870912000000"},{"denom":"uion","amount":"54884","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0,"total_shares":"5932569595219933564"},{"id":"15","type":"Pool","assets":[{"denom":"ibc/A0CC0CF735BFB30E730C70019D4218A1244FF383503FF7579C9201AB93CA9293","amount":"247399177597","weight":"536870912000000"},{"denom":"uosmo","amount":"17942898401","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.002,"total_shares":"7110839429760806267173669"},{"id":"16","type":"Pool","assets":[{"denom":"ibc/1DCC8A6CB5689018431323953344A9F6CC4D0BFB261E88C9F7777372C10CD076","amount":"98","weight":"1073741824"},{"denom":"ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2","amount":"11","weight":"9663676416"}],"exit_fee":0,"swap_fee":0.005,"total_shares":"100000000000000"},{"id":"17","type":"Pool","assets":[{"denom":"ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2","amount":"2058","weight":"536870912000000"},{"denom":"ibc/9712DBB13B9631EDFA9BF61B55F1B2D290B2ADB67E3A4EB3A875F3B6081B3B84","amount":"66024230","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.003,"total_shares":"100000000000000000000"},{"id":"18","type":"Pool","assets":[{"denom":"ibc/9712DBB13B9631EDFA9BF61B55F1B2D290B2ADB67E3A4EB3A875F3B6081B3B84","amount":"3202804","weight":"536870912000000"},{"denom":"uion","amount":"5","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.003,"total_shares":"200000000000000000"},{"id":"19","type":"Pool","assets":[{"denom":"ibc/1480B8FD20AD5FCAE81EA87584D269547DD4D436843C1D20F15E00EB64743EF4","amount":"19245","weight":"536870912000000"},{"denom":"uion","amount":"368","weight":"536870912000000"}],"exit_fee":0,"swap_fee":0.003,"total_shares":"220161401685494759"},{"id":"20","type":"Pool","assets":[{"denom":"ibc/1DCC8A6CB5689018431323953344A9F6CC4D0BFB261E88C9F7777372C10CD076","amount":"32","weight":"429496729600000"},{"denom":"ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2","amount":"2","weight":"644245094400000"}],"exit_fee":0,"swap_fee":0.0003,"total_shares":"1883611202938209"}],"source":"Osmosis (osmosis-1) LCD","total_pools":3469},"meta":{"timestamp":"2026-06-15T02:10:32.976Z","request_id":"77bdc35c-57a9-4f87-a229-3cbbb9525a6f"},"status":"ok","message":"Pools 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":"Osmosis chain staking economics & parameters","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The Osmosis chain staking economics — bonded vs unbonded OSMO, the bonded ratio, and the staking parameters (unbonding period, max validators, minimum commission). No parameters.","params":{"bond_denom":"uosmo","max_validators":70,"min_commission_rate":0.05,"unbonding_time_seconds":1209600},"source":"Osmosis (osmosis-1) LCD","bonded_osmo":201693822.06,"not_bonded_osmo":44419512.31,"bonded_ratio_percent":81.95},"meta":{"timestamp":"2026-06-15T02:10:33.097Z","request_id":"f7676961-49a1-4d62-9758-69875c5441eb"},"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/supply":{"get":{"operationId":"get_v1_supply","tags":["Supply"],"summary":"Total OSMO supply","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The total supply of OSMO (the native token of Osmosis), in both OSMO and the uosmo micro-denomination. No parameters.","denom":"OSMO","source":"Osmosis (osmosis-1) LCD","micro_denom":"uosmo","total_supply_osmo":777488140.8,"total_supply_uosmo":"777488140801773"},"meta":{"timestamp":"2026-06-15T02:10:33.199Z","request_id":"7431e19f-46a3-4362-ad3e-2dcb93796bfd"},"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/block":{"get":{"operationId":"get_v1_block","tags":["Chain"],"summary":"Latest block","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The latest finalized Osmosis block — height, timestamp, chain id, proposer and transaction count. No parameters.","time":"2026-06-15T02:10:31.047218980Z","height":64098084,"source":"Osmosis (osmosis-1) LCD","num_txs":1,"chain_id":"osmosis-1","proposer_address":"xx7zwESZhHO0zsyumXcZdvGY1KU="},"meta":{"timestamp":"2026-06-15T02:10:33.324Z","request_id":"5172a146-dce6-4fe5-98ac-f086e9189222"},"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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata & endpoint catalog","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"total_pools":3469},"source":"Osmosis public Cosmos REST / LCD nodes (osmosis-api.polkachu.com and mirrors), keyless","service":"osmosischain-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/pool":"Single pool full detail (id).","GET /v1/block":"Latest block.","GET /v1/pools":"DEX liquidity pools (limit) + chain-wide pool count.","GET /v1/supply":"Total OSMO supply.","GET /v1/staking":"Osmosis chain staking economics & parameters."},"description":"Live on-chain data for Osmosis (the leading Cosmos DEX / AMM L1, chain osmosis-1) with no key: the DEX liquidity pools (GAMM AMM pools with their assets, reserves, swap fee and total count), a single pool's full detail, the Osmosis chain staking economics, the total OSMO supply, and the latest block. The Osmosis-DEX / on-chain / staking layer for DeFi dashboards, liquidity analytics and research. Distinct from other chain readers — Osmosis and its AMM liquidity pools. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-15T02:10:33.448Z","request_id":"d353c419-ff1a-4a3e-9191-3ef72e7d40b2"},"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":8100,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":2960,"monthly_call_quota":197000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":8470,"monthly_call_quota":1120000,"rps_limit":20,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":15370,"monthly_call_quota":6110000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/osmosischain-api"}