---
title: "Get user market portfolio"
method: GET
path: "/api/v1/users/{address}/markets"
tags: ["User"]
---

# Get user market portfolio

`GET /api/v1/users/{address}/markets`

## 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`

- object
  - `data` UserMarket — `UserMarket`
    - `borrow` UserBorrowMarket, required — `UserBorrowMarket`
      - `accounts` UserBorrowMarketAccount[], required — `UserBorrowMarketAccount[]` --- Market sub-accounts for the user
        - `index` integer, required — Account index
        - `collaterals` UserCollateralAssetPool[], required — `UserCollateralAssetPool[]` --- Account collateral allocations
          - `asset_info` AssetInfo, required — `AssetInfo`
            - `asset` AssetSpec, required — `AssetSpec` 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 — `AssetMetadata`
              - …
            - `classification` union, required — `AssetClassification` --- 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.
              - …
          - `amount` string, required — Amount of this asset which is actively collateralized
          - `extra` object, required
            - `text` object, nullable — Human-readable field variants. Must provide `?with-text=true`
              - …
            - `value` object, nullable — USD values for the corresponding amounts above. Must provide `?with-value=true`
              - …
        - `debts` UserDebtAssetPool[], required — `UserDebtAssetPool[]` --- Account debt allocations
          - `asset_info` AssetInfo, required — `AssetInfo`
            - `asset` AssetSpec, required — `AssetSpec` 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 — `AssetMetadata`
              - …
            - `classification` union, required — `AssetClassification` --- 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.
              - …
          - `principal` string, required — Initial amount borrowed (of debts which have not yet been repaid)
          - `interest` string, required — Sum of accrued interest for open debt position
          - `debt` string, required — Sum open debt amount (this is simply the principal + interest)
          - `extra` object, required
            - `text` object, nullable — Human-readable field variants. Must provide `?with-text=true`
              - …
            - `value` object, nullable — USD values for the corresponding amounts above. Must provide `?with-value=true`
              - …
        - `health` UserAccountHealth — `UserAccountHealth`
          - `base` string, required — `UserAccountHealthValue` --- Account health value, before any added health boosts
          - `boost` string, required — `UserAccountHealthBoost` --- Account health boost to be applied
          - `result` string, required — `UserAccountHealthValue` --- Account health, with boost
          - `extra` object, required
            - `text` object, nullable — Human-readable field variants. Must provide `?with-text=true`
              - …
      - `totals` UserBorrowMarketPools, required
        - `collaterals` UserCollateralAssetPool[], required — `UserCollateralAssetPool[]` --- Account collateral allocations
          - `asset_info` AssetInfo, required — `AssetInfo`
            - `asset` AssetSpec, required — `AssetSpec` 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 — `AssetMetadata`
              - …
            - `classification` union, required — `AssetClassification` --- 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.
              - …
          - `amount` string, required — Amount of this asset which is actively collateralized
          - `extra` object, required
            - `text` object, nullable — Human-readable field variants. Must provide `?with-text=true`
              - …
            - `value` object, nullable — USD values for the corresponding amounts above. Must provide `?with-value=true`
              - …
        - `debts` UserDebtAssetPool[], required — `UserDebtAssetPool[]` --- Account debt allocations
          - `asset_info` AssetInfo, required — `AssetInfo`
            - `asset` AssetSpec, required — `AssetSpec` 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 — `AssetMetadata`
              - …
            - `classification` union, required — `AssetClassification` --- 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.
              - …
          - `principal` string, required — Initial amount borrowed (of debts which have not yet been repaid)
          - `interest` string, required — Sum of accrued interest for open debt position
          - `debt` string, required — Sum open debt amount (this is simply the principal + interest)
          - `extra` object, required
            - `text` object, nullable — Human-readable field variants. Must provide `?with-text=true`
              - …
            - `value` object, nullable — USD values for the corresponding amounts above. Must provide `?with-value=true`
              - …
    - `lend` UserLendMarket, required — `UserLendMarket`
      - `asset_pools` UserDebtAssetPool[], required — `UserLendAssetPool[]` --- User lending allocations
        - `asset_info` AssetInfo, required — `AssetInfo`
          - `asset` AssetSpec, required — `AssetSpec` 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` 'native' | 'token', required
            - `group_key` string, required
          - `metadata` AssetMetadata, required — `AssetMetadata`
            - `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 — `AssetClassification` --- 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 — Initial amount borrowed (of debts which have not yet been repaid)
        - `interest` string, required — Sum of accrued interest for open debt position
        - `debt` string, required — Sum open debt amount (this is simply the principal + interest)
        - `extra` object, required
          - `text` object, nullable — Human-readable field variants. Must provide `?with-text=true`
            - `debt` string, required
            - `principal` string, required
            - `interest` string, required
          - `value` object, nullable — USD values for the corresponding amounts above. Must provide `?with-value=true`
            - `debt` string, required
            - `principal` string, required
            - `interest` string, required
            - `extra` object, required
              - …
  - `error` ErrorData
    - `scope` 'user' | 'client' | 'server', required
    - `kind` 'invalid_request' | 'validation' | 'entity_not_found' | 'contract' | 'internal', required
    - `message` string, required — Error message
    - `fields` FieldValidationError[], nullable — List of names and error messages for invalid fields. Always set when `error.kind == 'validation'`. Always NULL/unset for all other cases.
      - `field` string, required
      - `message` string, required
  - `status` integer, required — Request status
  - `status_text` string, required — Request status text

---

[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/4b5b35e288d8/schema)
