---
title: "Get market supply"
method: GET
path: "/api/v1/markets/supply"
tags: ["Market"]
---

# Get market supply

`GET /api/v1/markets/supply`

## Query parameters

- `with_text` boolean — Include text variation fields

## Response `200`

Success response

- MarketSupplyOverviewObjResponse
  - `data` MarketSupplyOverview, required
    - `borrow_collateral` 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
          - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`.
            - `shares` string, required
            - `balance` string, 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
          - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`.
            - `shares` string, required
            - `balance` string, 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
          - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`.
            - `shares` string, required
            - `balance` string, required
    - `borrow_debt` 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`.
          - `shares` string, required
          - `balance` string, required
    - `lend` 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
    - `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` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/cryptechdev/apis/neptune-api-v2/changes/api/v1/markets/supply/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)