# Kava DeFi & USDX Money Market API > 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. ## 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/kava-api/..." ``` ## Pricing - **Free** (Free) — 1,000 calls/Mo, 3 req/s - **Starter** ($12/Mo) — 38,000 calls/Mo, 12 req/s - **Pro** ($30/Mo) — 190,000 calls/Mo, 30 req/s - **Business** ($72/Mo) — 950,000 calls/Mo, 58 req/s ## Endpoints ### Network #### `GET /v1/network` — Chain head — chain id, block height and time **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/kava-api/v1/network" ``` **Response:** ```json { "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 } ``` ### CDP #### `GET /v1/cdp` — Collateral types with liquidation ratio, debt limit and USDX minted **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/kava-api/v1/cdp" ``` **Response:** ```json { "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, …(truncated, see openapi.json for full schema) ``` ### Prices #### `GET /v1/prices` — On-chain pricefeed oracle prices **Parameters:** - `market` (query, optional, string) — Market id (e.g. btc:usd); omit for all spot prices Example: `btc:usd` - `twap` (query, optional, string) — Include TWAP prices (true/false) Example: `false` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/kava-api/v1/prices?market=btc%3Ausd&twap=false" ``` **Response:** ```json { "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 } ``` ### Supply #### `GET /v1/supply` — Circulating USDX (minted) and KAVA supply **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/kava-api/v1/supply" ``` **Response:** ```json { "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 } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/kava-api/v1/meta" ``` **Response:** ```json { "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 ow …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/kava-api OpenAPI spec: https://www.oanor.com/api/kava-api/openapi.json