--- title: "Get market overview" method: GET path: "/api/v1/markets" tags: ["Market"] --- # Get market overview `GET /api/v1/markets` ## Query parameters - `with_text` boolean — Include text variation fields - `with_value` boolean — Calculate and include USD values for amounts, where applicable ## Response `200` Success response - MarketOverviewObjResponse - `data` MarketOverview, required - `borrow` BorrowMarketOverview, required - `collaterals` BorrowCollateralOverview, required — Borrowing market collaterals overview - `supply` BorrowCollateralMarketSupply, required - `non_receipt` MarketSupplyPool, required - `balance` string, required — Sum USD value of market balance - `shares` string, required — Sum USD value of market shares - `extra` object, required - … - `receipt` MarketSupplyPool, required - `balance` string, required — Sum USD value of market balance - `shares` string, required — Sum USD value of market shares - `extra` object, required - … - `total` MarketSupplyPool, required - `balance` string, required — Sum USD value of market balance - `shares` string, required — Sum USD value of market shares - `extra` object, required - … - `contents` BorrowCollateralMarket[], required — Borrowing collateral markets - `asset_info` AssetInfo, required — Asset identifiers with associated metadata - `asset` AssetSpec, required — Provides a unique identifier for an asset for use throughout the Neptune API. IDs are unique across asset domains (contract tokens, native denoms, etc) - … - `metadata` AssetMetadata, required — Additional metadata for assets - … - `classification` union, required — The asset's classification metadata. Assets are classfied to provide context on their usage throughout the Neptune API (e.g. regular assets, neptune receipt tokens, LSTs, etc.) Each asset belongs to only a single classification type. This object contains metadata pertaining to the given classification. While some fields may be common among the distinct classifcations, each classification is distinct and subject to independent change. - … - `config` BorrowCollateralConfig, required - `enabled` boolean, required — Collateral enabled state - `collateral_cap` string, nullable, required — The optional, global/shared maximum deposit limit for this collateral. - `allowable_ltv` string, required — The loan to value ratio at which we allow collateral withdrawals or borrows. - `liquidation_ltv` string, required — The loan to value ratio at which the collateral can be liquidated. - `min_discount` string, required — The minimum dynamic discount. - `max_discount` string, required — The maximum dynamic discount - `extra` object, required - … - `state` BorrowCollateralState, required - `shares` string, required — Total amount of this asset which is actively collateralized - `balance` string, required - `extra` object, required - … - `debts` BorrowDebtOverview, required — Borrowing market debts overview - `supply` MarketSupplyPool, required - `balance` string, required — Sum USD value of market balance - `shares` string, required — Sum USD value of market shares - `extra` object, required - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`. - … - `contents` BorrowDebtMarket[], required — Borrowing debt markets - `asset_info` AssetInfo, required — Asset identifiers with associated metadata - `asset` AssetSpec, required — Provides a unique identifier for an asset for use throughout the Neptune API. IDs are unique across asset domains (contract tokens, native denoms, etc) - … - `metadata` AssetMetadata, required — Additional metadata for assets - … - `classification` union, required — The asset's classification metadata. Assets are classfied to provide context on their usage throughout the Neptune API (e.g. regular assets, neptune receipt tokens, LSTs, etc.) Each asset belongs to only a single classification type. This object contains metadata pertaining to the given classification. While some fields may be common among the distinct classifcations, each classification is distinct and subject to independent change. - … - `rate` MarketRate, required - `apr` string, required — Market rate in APR standard as a decimal percentage - `apy` string, required — Market rate in APY standard as a decimal percentage - `extra` object, required - … - `config` BorrowDebtConfig, required - `enabled` boolean, required — Market enabled state - `borrow_cap` string, nullable, required — The global max amount which can be borrowed - `interest_fee` string, required — The protocol (base) interest rate that is charged to borrowers. - `borrow_halt_utilization` string, required — The maximum utilization ratio at which new borrow positions can be opened. - `extra` object, required - … - `state` BorrowDebtState, required - `shares` string, required - `balance` string, required - `utilization_accumulator` string, required — Asset utilization tracker. - `time_last_distributed_interest` string, date-time, required — Timestamp used to keep track of the last time interest was distributed. - `extra` object, required - … - `lend` LendOverview, required — Lending markets overview - `supply` LendMarketSupply, required - `principal` string, required — Sum USD value of lending principal - `extra` object, required - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`. - `principal` string, required - `contents` LendMarket[], required — Lending markets - `asset_info` AssetInfo, required — Asset identifiers with associated metadata - `asset` AssetSpec, required — Provides a unique identifier for an asset for use throughout the Neptune API. IDs are unique across asset domains (contract tokens, native denoms, etc) - `id` string, required - `group` union, required - … - `group_key` string, required - `metadata` AssetMetadata, required — Additional metadata for assets - `name` string, required — Full name of the asset - `symbol` string, required — Symbol of the asset, e.g.: `NEPT` `INJ` - `symbol_denom` string, required — Denom symbol for the asset (e.g. `inj` for `INJ`, `sat` for `BTC`) - `decimals_denom` integer, required — Denom exponent, or num. of decimal places that shift between denom/standard amounts (e.g. `18` for `INJ`) - `decimals_display` integer, required — Number of decimals used when displaying amounts of this asset (this is subjective and used for generating text representations) - `classification` union, required — The asset's classification metadata. Assets are classfied to provide context on their usage throughout the Neptune API (e.g. regular assets, neptune receipt tokens, LSTs, etc.) Each asset belongs to only a single classification type. This object contains metadata pertaining to the given classification. While some fields may be common among the distinct classifcations, each classification is distinct and subject to independent change. - object - … - object - … - object - … - `rate` MarketRate, required - `apr` string, required — Market rate in APR standard as a decimal percentage - `apy` string, required — Market rate in APY standard as a decimal percentage - `extra` object, required - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`. - … - `state` LendMarketState, required - `principal` string, required — The total amount of the asset deposited for lending in the market. - `receipt_total_supply` string, required - `redemption_ratio` string, required - `extra` object, required - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`. - … - `value` object, nullable, required — USD values for the corresponding amounts above. Will not be null when query param `with_value` is `true`. ### Note This variant group contains an additional `price` field (set to the number used in value calculation). The embedded text group will contain the text variant if `with_text` was specified as well. - … - `global_config` GlobalMarketConfig, required - `time_window_nanos` integer, required — Number of nanoseconds that an oracle price is valid for. - `partial_liquidation_threshold` string, required — Minimum account value to avoid complete liquidation. - `target_liquidation_health` string, required — The account health target for a liquidation. should be ~= 1.02 must be >= 1.0 - `liquidation_fee` string, required — The coefficient use to calculate the liquidation protocol fee. should be ~= 0.01 must be <= 1.0 - `flash_loans_enabled` boolean, required — Whether flash loans are enabled or not - `flash_loan_fee` string, required — The coefficient used to calculate the flash loan fee. should be ~= 0.01 must be <= 1.0 - `staking_health_modifier` string, required — The maximum health increase provided by staking. should be ~= 0.05 and must be <= 1.0 - `stake_collateral_ratio` string, required — The required ratio of weighted staked NEPT to collateral value to obtain the maximum staking health modifier. should be ~= 0.1 must be <= 1.0 - `stake_flash_loan_ratio` string, required — The required ratio of weighted staked NEPT to flash loan value should be ~= 0.05 must be <= 1.0 - `dynamic_discount_width` string, required — The required change in account health below 1.0 to achieve the maximum discount. should be ~= 0.02 must be <= 1.0 - `hinj` AssetSpec, required — Provides a unique identifier for an asset for use throughout the Neptune API. IDs are unique across asset domains (contract tokens, native denoms, etc) - `id` string, required - `group` union, required - 'native' - 'token' - `group_key` string, required - `nept` AssetSpec, required — Provides a unique identifier for an asset for use throughout the Neptune API. IDs are unique across asset domains (contract tokens, native denoms, etc) - `id` string, required - `group` union, required - 'native' - 'token' - `group_key` string, required - `extra` object, required - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`. - `flash_loan_fee` string, required - `liquidation_fee` string, required - `time_window_nanos` string, required - `stake_collateral_ratio` string, required - `stake_flash_loan_ratio` string, required - `staking_health_modifier` string, required - `tvl` MarketTvl, required - `tvl` string, required — Market TVL in USD (equivalent to `borrow.collaterals.supply.non_receipt.balance + lend.supply.principal`) - `net_tvl` string, required — Market net TVL in USD (equivalent to `tvl - borrow.debts.supply.balance`) - `extra` object, required - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`. - `net_tvl` string, required - `tvl` string, required - `error` unknown, required - `status` integer, required — HTTP status. Successful responses are guaranteed to be < `400`. Conversely, error responses are guaranteed to be >= `400`. - `status_text` string, required — HTTP status text ## Other responses - `500` — Server error response - `default` ## Changes - **2026-04-17** `05e0ec4b9b94` — 9 breaking, 7 info - the `data/borrow/allOf[#/components/schemas/BorrowMarketOverview]/collaterals` response's property type/format changed from `array`/`` to ``/`` for status `200` - the `data/borrow/allOf[#/components/schemas/BorrowMarketOverview]/debts` response's property type/format changed from `array`/`` to ``/`` for status `200` - the `data/lend` response's property type/format changed from `array`/`` to ``/`` for status `200` - removed the required property `data/tvl/allOf[#/components/schemas/MarketTvl]/collateral_value` from the response with the `200` status - …12 more - **2026-04-17** `40d8045cda41` — 4 info - added the required property `data/borrow/allOf[#/components/schemas/BorrowMarketOverview]/collaterals/items/state/allOf[#/components/schemas/BorrowCollateralState]/extra/text/balance` to the response with the `200` status - added the required property `data/borrow/allOf[#/components/schemas/BorrowMarketOverview]/collaterals/items/state/allOf[#/components/schemas/BorrowCollateralState]/extra/value/balance` to the response with the `200` status - added the required property `data/borrow/allOf[#/components/schemas/BorrowMarketOverview]/collaterals/items/state/allOf[#/components/schemas/BorrowCollateralState]/extra/value/extra/text/balance` to the response with the `200` status - added the required property `data/tvl` to the response with the `200` status - …earlier changes not shown [Full history](https://skmtc.dev/cryptechdev/apis/neptune-api-v2/changes/api/v1/markets/get.md) --- [API](https://skmtc.dev/cryptechdev/apis/neptune-api-v2.md) · [All operations](https://skmtc.dev/cryptechdev/apis/neptune-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cryptechdev/neptune-api-v2/revisions/05e0ec4b9b94/schema)