Liquidity API

Build transactions that interact with THORChain's liquidity

Add asymmetric asset liquidity

Endpoint to get transaction memo for adding asym asset liquidity

GEThttps://dev-api.thorswap.net/aggregator/liquidity/add/asym_asset

Query parameters

Response

200400500

A complete response required to build asset and/or rune transactions.

Body

application/json

assetTxDataAssetTxData (object)

Transaction data for asset.

estimatedSharestring

Estimated share of the pool user will have after transaction

slippageSlippage (object)

Slippage information for transaction

Request

JavaScriptCurlPython

const response = await fetch('https://dev-api.thorswap.net/aggregator/liquidity/add/asym_asset?asset=text&affiliateAddress=text&thorAddress=text&assetAddress=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400500

{
  "assetTxData": {
    "assetAmount": 0,
    "recipient": "text",
    "memo": "text",
    "feeRate": 0,
    "router": "text",
    "estimatedTime": "text"
  },
  "estimatedShare": "text",
  "slippage": {
    "assetAmount": "text",
    "baseAmount": "text",
    "decimal": 0
  }
}

Add symmetrical liquidity

Endpoint to get transaction memo for adding sym liquidity

GEThttps://dev-api.thorswap.net/aggregator/liquidity/add/sym

Query parameters

Response

200400500

A complete response required to build asset and/or rune transactions.

Body

application/json

assetTxDataAssetTxData (object)

Transaction data for asset.

runeTxDataRuneTxData (object)

transaction data for Rune. (one of the response object for add liquidity memo)

estimatedSharestring

Estimated share of the pool user will have after transaction

slippageSlippage (object)

Slippage information for transaction

Request

JavaScriptCurlPython

const response = await fetch('https://dev-api.thorswap.net/aggregator/liquidity/add/sym?asset=text&affiliateAddress=text&thorAddress=text&assetAddress=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400500

{
  "assetTxData": {
    "assetAmount": 0,
    "recipient": "text",
    "memo": "text",
    "feeRate": 0,
    "router": "text",
    "estimatedTime": "text"
  },
  "runeTxData": {
    "assetAmount": 0,
    "recipient": "text",
    "memo": "text",
    "feeRate": 0,
    "estimatedTime": "text"
  },
  "estimatedShare": "text",
  "slippage": {
    "assetAmount": "text",
    "baseAmount": "text",
    "decimal": 0
  }
}

Add symmetrical asset liquidity

Endpoint to get transaction memo for adding symmetrical asset liquidity

GEThttps://dev-api.thorswap.net/aggregator/liquidity/add/sym_asset

Query parameters

Response

200400500

A complete response required to build asset and/or rune transactions.

Body

application/json

assetTxDataAssetTxData (object)

Transaction data for asset.

estimatedSharestring

Estimated share of the pool user will have after transaction

slippageSlippage (object)

Slippage information for transaction

Request

JavaScriptCurlPython

const response = await fetch('https://dev-api.thorswap.net/aggregator/liquidity/add/sym_asset?asset=text&affiliateAddress=text&thorAddress=text&assetAddress=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400500

{
  "assetTxData": {
    "assetAmount": 0,
    "recipient": "text",
    "memo": "text",
    "feeRate": 0,
    "router": "text",
    "estimatedTime": "text"
  },
  "estimatedShare": "text",
  "slippage": {
    "assetAmount": "text",
    "baseAmount": "text",
    "decimal": 0
  }
}

Add symmetrical rune liquidity

Endpoint to get transaction memo for adding symmetrical asset liquidity

GEThttps://dev-api.thorswap.net/aggregator/liquidity/add/sym_rune

Query parameters

Response

200400500

A complete response required to build asset and/or rune transactions.

Body

application/json

runeTxDataRuneTxData (object)

transaction data for Rune. (one of the response object for add liquidity memo)

estimatedSharestring

Estimated share of the pool user will have after transaction

slippageSlippage (object)

Slippage information for transaction

Request

JavaScriptCurlPython

const response = await fetch('https://dev-api.thorswap.net/aggregator/liquidity/add/sym_rune?asset=text&affiliateAddress=text&thorAddress=text&assetAddress=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400500

{
  "runeTxData": {
    "assetAmount": 0,
    "recipient": "text",
    "memo": "text",
    "feeRate": 0,
    "estimatedTime": "text"
  },
  "estimatedShare": "text",
  "slippage": {
    "assetAmount": "text",
    "baseAmount": "text",
    "decimal": 0
  }
}

Add symmetrical single sided asset liquidity

Endpoint to get transaction memo for adding symmetrical asset liquidity

GEThttps://dev-api.thorswap.net/aggregator/liquidity/add/single_sided

Query parameters

Response

200400500

A complete response required to build asset and/or rune transactions.

Body

application/json

runeTxDataAssetTxData (object)

Transaction data for asset.

estimatedSharestring

Estimated share of the pool user will have after transaction

slippageSlippage (object)

Slippage information for transaction

Request

JavaScriptCurlPython

const response = await fetch('https://dev-api.thorswap.net/aggregator/liquidity/add/single_sided?asset=text&affiliateAddress=text&thorAddress=text&assetAddress=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400500

{
  "runeTxData": {
    "assetAmount": 0,
    "recipient": "text",
    "memo": "text",
    "feeRate": 0,
    "router": "text",
    "estimatedTime": "text"
  },
  "estimatedShare": "text",
  "slippage": {
    "assetAmount": "text",
    "baseAmount": "text",
    "decimal": 0
  }
}

Withdraw Liquidity memo

Endpoint to get transaction memo for withdrawing liquidity

GEThttps://dev-api.thorswap.net/aggregator/liquidity/withdraw

Query parameters

Response

200400500

A complete response required to build asset and/or rune transactions.

Body

application/json

txDataAssetTxData (object)

Transaction data for asset.

Request

JavaScriptCurlPython

const response = await fetch('https://dev-api.thorswap.net/aggregator/liquidity/withdraw?asset=text&positionType=sym_rune&withdrawType=asset&percent=0', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400500

{
  "txData": {
    "assetAmount": 0,
    "recipient": "text",
    "memo": "text",
    "feeRate": 0,
    "router": "text",
    "estimatedTime": "text"
  }
}