--- title: "Get user borrow portfolio" method: GET path: "/api/v1/users/{address}/markets/borrow" tags: ["User"] --- # Get user borrow portfolio `GET /api/v1/users/{address}/markets/borrow` ## Path parameters - `address` string, required — The user account address ## 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 - UserBorrowMarketObjResponse - `data` UserBorrowMarket, required - `accounts` UserBorrowMarketAccount[], required — Market sub-accounts for the user - `index` integer, required — Account index - `collaterals` UserCollateralAssetPool[], required — Account collateral allocations - `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 - … - `principal` string, required — Amount of this asset which is actively collateralized - `shares` string, required - `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 - `shares` string, required - `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. - `shares` string, required - `price` string, required — Price used in value calculations - `principal` string, required - `extra` object, required - … - `debts` UserDebtAssetPool[], required — Account debt allocations - `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 - … - `market_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`. - … - `principal` string, required — Initial amount borrowed (of debts which have not yet been repaid) - `shares` string, required - `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 - `shares` string, required - `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. - `shares` string, required - `price` string, required — Price used in value calculations - `principal` string, required - `extra` object, required - … - `debts_net_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`. - `apy` string, required - `apr` string, required - `health` UserAccountHealth, required - `base` string, required — Account health value, before any added health boosts - `boost` string, required — Account health boost to be applied - `result` string, required — Account health, with boost - `extra` object, required - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`. - `boost` string, required - `result` string, required - `base` string, required - `totals` UserBorrowMarketSumPool, required - `collaterals` UserCollateralAssetPool[], required — Account collateral allocations - `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 - … - `principal` string, required — Amount of this asset which is actively collateralized - `shares` string, required - `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 - `shares` string, required - `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. - `shares` string, required - `price` string, required — Price used in value calculations - `principal` string, required - `extra` object, required - … - `debts` UserDebtAssetPool[], required — Account debt allocations - `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 - … - `market_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`. - … - `principal` string, required — Initial amount borrowed (of debts which have not yet been repaid) - `shares` string, required - `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 - `shares` string, required - `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. - `shares` string, required - `price` string, required — Price used in value calculations - `principal` string, required - `extra` object, required - … - `debts_net_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`. - `apy` string, required - `apr` 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` — 4 breaking, 8 info - removed the required property `data/accounts/items/collaterals/items/amount` from the response with the `200` status - removed the required property `data/accounts/items/collaterals/items/extra/text/amount` from the response with the `200` status - removed the required property `data/accounts/items/collaterals/items/extra/value/amount` from the response with the `200` status - removed the required property `data/accounts/items/collaterals/items/extra/value/extra/text/amount` from the response with the `200` status - …8 more - **2026-04-02** `3e68b318eeaa` — 8 breaking, 10 info - removed the required property `data/accounts/items/debts/items/debt` from the response with the `200` status - removed the required property `data/accounts/items/debts/items/extra/text/debt` from the response with the `200` status - removed the required property `data/accounts/items/debts/items/extra/text/interest` from the response with the `200` status - removed the required property `data/accounts/items/debts/items/extra/value/debt` from the response with the `200` status - …14 more - …earlier changes not shown [Full history](https://skmtc.dev/cryptechdev/apis/neptune-api-v2/changes/api/v1/users/:address/markets/borrow/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)