---
title: "GET /v1/liquidity/params/{offchainAsset}"
method: GET
path: "/v1/liquidity/params/{offchainAsset}"
tags: ["autoloop"]
---

# GET /v1/liquidity/params/{offchainAsset}

`GET /v1/liquidity/params/{offchainAsset}`

Get the parameters that the daemon's liquidity manager is currently configured with. This may be nil if nothing is configured.

## Path parameters

- `offchainAsset` 'BTC' | 'LTC'

## Response `200`

OK

- LiquidityParameters
  - `rules` LiquidityRule[], required
    - `incoming_threshold_percent` integer — if the incoming liquidity (i.e. other party's share of the channel cap) has become less than this, we will dispatch the loop-out swap
    - `outgoing_threshold_percent` integer — if the outgoing liquidity (i. our share in the channel cap) has become less than this, we will dispatch the loop-in swap
    - `pubkey` string
    - `channel_id` union
      - string — pointer to the funding outpoint. i.e. triplet of 1. block height, 2. tx index number in the block. 3. tx out index Of the funding tx of the channel.
      - integer — uint64 representation used in LND.
      - string — both bolt-style triplet and lnd-compatible style concatenated.
    - `type` 'UNKNOWN' | 'THRESHOLD'
  - `fee_ppm` integer, nullable — The parts per million of swap amount that is allowed to be allocated to swap fees. This valie is applied across swap categories and may not be set in conjunction with sweep fee rate, swap fee ppm, routing fee ppm, prepay routing, max prepay and max miner fee.
  - `sweep_fee_rate_sat_per_kvbyte` integer, nullable — The limit we place on our estimated sweep cost for a swap in sat/kilo-vByte. If the estimated fee for our sweep tx within the specified confirmation target is above this value, we will not suggest any swaps.
  - `max_swap_fee_ppm` integer, nullable — The maximum fee paid to the server for facilitating the swap, expressed as parts-per-million of the swap amount.
  - `max_routing_fee_ppm` integer, nullable
  - `max_prepay_routing_fee_ppm` integer, nullable
  - `max_prepay_sat` integer, nullable
  - `max_miner_fee_sat` integer, nullable
  - `sweep_conf_target` integer, required — The number of blocks from the on-chain HTLC7s confirmation height that it shuold be swept within.
  - `failure_backoff_sec` integer, required — The amount of time we require to pass since a channel was part of a failed swap due to off chain payment failure until it will be considered for swap suggestions again, expressed in seconds.
  - `autoloop` boolean, required — Set to true to enable automatic dispatch of swaps. All swaps will be limited to the fee categories set by these parameters,
  - `auto_max_in_flight` integer, required — The maximum number of of automatically dispatched swaps that we allow to be in flight at any point in time.
  - `min_swap_amount_loopout` integer, nullable — The minimum off-chain amount for loop out, expressed in satoshis, that the autoloop client will dispatch a swap for.
  - `max_swap_amount_loopout` integer, nullable — The maximum off-chain amount for loop out, expressed in satoshis.
  - `min_swap_amount_loopin` integer, nullable — The minimum off-chain amount for loop in, expressed in satoshis, that the autoloop client will dispatch a swap for.
  - `max_swap_amount_loopin` integer, nullable — The maximum off-chain amount for loop in, expressed in satoshis.
  - `onchain_asset` 'BTC' | 'LTC'
  - `htlc_conf_target` integer, nullable — The conf target we use to estimate the fee for swaptx in loop-in.

## Changes

- **2022-01-26** `b52777465fee` — 1 breaking, 1 info
  - added `subschema #3` to the `rules/items/channel_id/oneOf[#/components/schemas/ShortChannelId]/` response property `oneOf` list for the response status `200`
  - the `path` request parameter `offchainAsset` became optional
- **2022-01-26** `2fa641145178` — 5 breaking, 1 info
  - the `rules/items/pubkey` response property's maxLength was unset from `33` for the response status `200`
  - the `rules/items/pubkey` response property's minLength was decreased from `33` to `0` for the response status `200`
  - added `#/components/schemas/PubKey` to the `rules/items/pubkey` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/ShortChannelId` to the `rules/items/channel_id` response property `oneOf` list for the response status `200`
  - …2 more
- **2022-01-24** `2f51ef5daa6d` — 1 breaking, 1 info
  - response property `rules/items/channel_id` list-of-types was widened by adding types `integer` to media type `application/json` of response `200`
  - the `rules/items/channel_id` response's property pattern `(\d{3})x(\d{3})x(\d{2})` was removed for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/bitbankinc/apis/nloop-server-openapi-definition/changes/v1/liquidity/params/:offchainAsset/get.md)

---

[API](https://skmtc.dev/bitbankinc/apis/nloop-server-openapi-definition.md) · [All operations](https://skmtc.dev/bitbankinc/apis/nloop-server-openapi-definition/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitbankinc/nloop-server-openapi-definition/revisions/633782f04ad9/schema)