{"openapi":"3.1.0","info":{"title":"Kava DeFi & USDX Money Market API","version":"1.0.0","description":"Live on-chain DeFi data from the Kava blockchain — a Cosmos-SDK Layer-1 whose core is a decentralised money market: users lock collateral to mint the USDX stablecoin (collateralised debt positions, CDPs) and lend/borrow through the Hard money market, valued by an on-chain price oracle. Served live from a public Kava REST node as clean JSON. Read the chain head (chain id, block height and time); see every collateral type with its liquidation ratio, stability fee, debt limit and the total USDX currently minted against it — the heart of Kava's lending engine; pull the on-chain pricefeed oracle prices the protocol uses to value collateral; or read the circulating USDX and KAVA supply. Read live from Kava, nothing cached. This is Kava's own CDP, USDX-stablecoin and oracle layer — distinct from the Cosmos Hub, Injective, Celestia and other Cosmos-chain APIs and from price feeds.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/kava-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"CDP"},{"name":"Prices"},{"name":"Supply"},{"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/network":{"get":{"operationId":"get_v1_network","tags":["Network"],"summary":"Chain head — chain id, block height and time","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"Cosmos-SDK DeFi (USDX money market)","chain":"kava","height":21124095,"source":"Kava","chain_id":"kava_2222-10","tx_count":0,"block_time":"2026-06-10T22:58:41.398395775Z","proposer_address":"Kf4n2mjZ85Ilxvhqoa11suPYOhg="},"meta":{"timestamp":"2026-06-10T22:58:48.089Z","request_id":"9624f6bb-effb-48d4-88c8-f0094dc42c54"},"status":"ok","message":"Network state 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/cdp":{"get":{"operationId":"get_v1_cdp","tags":["CDP"],"summary":"Collateral types with liquidation ratio, debt limit and USDX minted","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Kava","debt_param":{"denom":"usdx","reference_asset":"usd"},"stablecoin":"USDX","collaterals":[{"type":"hbtc-a","denom":"hbtc","stability_fee":"1.000000001547125958","debt_limit_usdx":3783000,"liquidation_ratio":1.5,"total_minted_usdx":3625675.141582,"liquidation_penalty":0.025},{"type":"btcb-a","denom":"btcb","stability_fee":"1.000000000782997609","debt_limit_usdx":1940000,"liquidation_ratio":1.5,"total_minted_usdx":1792954.565361,"liquidation_penalty":0.025},{"type":"busd-a","denom":"busd","stability_fee":"1.000000000000000000","debt_limit_usdx":897000,"liquidation_ratio":1.01,"total_minted_usdx":839988.383705,"liquidation_penalty":0.025},{"type":"xrpb-a","denom":"xrpb","stability_fee":"1.000000000782997609","debt_limit_usdx":1068000,"liquidation_ratio":1.5,"total_minted_usdx":753185.287502,"liquidation_penalty":0.025},{"type":"bnb-a","denom":"bnb","stability_fee":"1.000000000158153904","debt_limit_usdx":526000,"liquidation_ratio":1.5,"total_minted_usdx":381592.323495,"liquidation_penalty":0.025},{"type":"usdt-a","denom":"erc20/tether/usdt","stability_fee":"1.000000000000000000","debt_limit_usdx":359000,"liquidation_ratio":1.01,"total_minted_usdx":311205.338565,"liquidation_penalty":0.025},{"type":"ukava-a","denom":"ukava","stability_fee":"1.000000000782997609","debt_limit_usdx":147000,"liquidation_ratio":1.5,"total_minted_usdx":139653.489833,"liquidation_penalty":0.025},{"type":"busd-b","denom":"busd","stability_fee":"1.000000012857214317","debt_limit_usdx":1000,"liquidation_ratio":1.1,"total_minted_usdx":80.555824,"liquidation_penalty":0.025},{"type":"hard-a","denom":"hard","stability_fee":"1.000000000782997609","debt_limit_usdx":1000,"liquidation_ratio":1.5,"total_minted_usdx":5.737381,"liquidation_penalty":0.025},{"type":"swp-a","denom":"swp","stability_fee":"1.000000001547125958","debt_limit_usdx":1000,"liquidation_ratio":1.5,"total_minted_usdx":4.85567,"liquidation_penalty":0.025}],"total_usdx_minted":7844345.678918,"collateral_type_count":10},"meta":{"timestamp":"2026-06-10T22:58:48.703Z","request_id":"c2a7d865-1e19-4fd5-89ef-a362c1677a5a"},"status":"ok","message":"CDP collateral data 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/prices":{"get":{"operationId":"get_v1_prices","tags":["Prices"],"summary":"On-chain pricefeed oracle prices","description":"","parameters":[{"name":"market","in":"query","required":false,"description":"Market id (e.g. btc:usd); omit for all spot prices","schema":{"type":"string"},"example":"btc:usd"},{"name":"twap","in":"query","required":false,"description":"Include TWAP prices (true/false)","schema":{"type":"string"},"example":"false"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"price":61555.99,"source":"Kava pricefeed","market_id":"btc:usd"},"meta":{"timestamp":"2026-06-10T22:58:48.914Z","request_id":"62512cff-ed06-4d2d-bee5-f1e3efdf0f83"},"status":"ok","message":"Oracle prices 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":"Circulating USDX (minted) and KAVA supply","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Kava","stablecoin":"USDX","kava_supply":1082847018.69665,"usdx_minted":7844345.678918,"usdx_supply":10420359.592487},"meta":{"timestamp":"2026-06-10T22:58:49.315Z","request_id":"df842baa-82fd-40e8-81f3-c4fff4fcc670"},"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":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"Cosmos-SDK DeFi money market","height":21124095,"source":"Kava public REST (api.data.kava.io, live)","service":"kava-api","endpoints":{"GET /v1/cdp":"Every collateral type with liquidation ratio, stability fee, debt limit and USDX minted.","GET /v1/meta":"This document.","GET /v1/prices":"On-chain pricefeed oracle prices (optional market=btc:usd, twap=true to include TWAP).","GET /v1/supply":"Circulating USDX (minted) and KAVA supply.","GET /v1/network":"Chain head — chain id, block height and time."},"stablecoin":"USDX","description":"Live on-chain DeFi data from the Kava blockchain, a Cosmos-SDK Layer-1 whose core is a decentralised money market: users lock collateral to mint the USDX stablecoin (collateralised debt positions) and lend/borrow through the Hard money market, with an on-chain price oracle. Via a public Kava REST node. The network endpoint returns the chain head (chain id, height, time); the cdp endpoint returns every collateral type with its liquidation ratio, stability fee, debt limit and the total USDX minted against it; the prices endpoint returns the on-chain pricefeed oracle prices; the supply endpoint returns circulating USDX and KAVA. Live, no key, nothing stored. Distinct from the Cosmos Hub, Injective, Celestia and other Cosmos-chain APIs and from price feeds — this is Kava's own CDP, USDX stablecoin and oracle layer.","native_token":"KAVA","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T22:58:49.525Z","request_id":"be842ea4-463b-41fa-83d5-022667c56ca4"},"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":1000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1150,"monthly_call_quota":38000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3000,"monthly_call_quota":190000,"rps_limit":30,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7200,"monthly_call_quota":950000,"rps_limit":58,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/kava-api"}