Manage Pool (CLMM)

Before submitting any signature-related request, first call /api/nonce to retrieve a fresh nonce for anti-replay.

CLMM - Add Liquidity

post

Body

application/json

service_fee_buy_percentagestringRequired

Buying, service fee rate from a to b, a decimal between 0 and 1, only for new pools

service_fee_sell_percentagestringRequired

Selling, service fee rate from b to a, a decimal between 0 and 1, only for new pools

price_tick_lowerintegerRequired

Lower bound of price tick

price_tick_upperintegerRequired

Upper bound of price tick

priceintegerRequired

Set price

unit_tickstringRequired

Responses

200Success

application/json

codeintegerRequired

msgstringRequired

req_idstringRequired

x-200:Success

application/json

post

/api/pool/clmm/add

HTTPcURLJavaScriptPython

POST /api/pool/clmm/add HTTP/1.1
Host: 127.0.0.1:8090
Content-Type: application/json
Accept: */*
Content-Length: 1175

{
  "tick1": {
    "tick": "BTC",
    "coin_type": "btc",
    "amount": "100000"
  },
  "tick2": {
    "tick": "THIRD•THIRD•TEST•TEO",
    "coin_type": "runes",
    "amount": "577.53179"
  },
  "sig_info": {
    "address": "tb1puyxw3r3tz8f65y2tplmw8g0zcxwmsmgy09ecnu7e7a8l3fhnxmqq5yankx",
    "public_key": "02b08f73e4e80044fb59e109a674bfab916c19140ebbcf5c68dba1226cf5a59536",
    "sign_info": "Address: tb1puyxw3r3tz8f65y2tplmw8g0zcxwmsmgy09ecnu7e7a8l3fhnxmqq5yankx\n\n Add 0.001BTC, 577.53179 THIRD•THIRD•TEST•TEO (estimated, actual amount may vary）into BTC/ THIRD•THIRD•TEST•TEO pool\n      \nTime: 2025-06-24 10:10:20\n\n Timestamp: 1750731020",
    "signature": "AUCqnSb2Ow3hxbpv1Zn2W59QvM6keUDawiln+fOXrZAWSwTBYzRRraXa0UnjHYaLibTaoD7XNWdud1M2YxDSBU1A"
  },
  "payer_address": {
    "address": "tb1puyxw3r3tz8f65y2tplmw8g0zcxwmsmgy09ecnu7e7a8l3fhnxmqq5yankx",
    "public_key": "02b08f73e4e80044fb59e109a674bfab916c19140ebbcf5c68dba1226cf5a59536"
  },
  "payer_asset_address": {
    "address": "tb1puyxw3r3tz8f65y2tplmw8g0zcxwmsmgy09ecnu7e7a8l3fhnxmqq5yankx",
    "public_key": "02b08f73e4e80044fb59e109a674bfab916c19140ebbcf5c68dba1226cf5a59536"
  },
  "unit_tick": "THIRD•THIRD•TEST•TEO",
  "price_tick_lower": 37030,
  "price_tick_upper": 37110,
  "price": 40.816326530612244
}

{
  "code": 0,
  "msg": "",
  "data": {
    "order_id": "liquid-1937332443617931264",
    "delta_x": "577.53179",
    "delta_y": "85187.264698416468455414722830512628367473546665340232286034510734007802914105343285188416365623840686"
  },
  "req_id": "1937332442724544512"
}

CLMM - Remove Liquidity

post

Body

application/json

percentstringRequired

Removal ratio, between 1 - 100

price_tick_lowerintegerRequired

price_tick_upperintegerRequired

Responses

200Success

application/json

codeintegerRequired

msgstringRequired

req_idstringRequired

post

/api/pool/clmm/remove

HTTPcURLJavaScriptPython

POST /api/pool/clmm/remove HTTP/1.1
Host: 127.0.0.1:8090
Content-Type: application/json
Accept: */*
Content-Length: 1317

{
  "tick1": {
    "tick": "BTC",
    "coin_type": "btc",
    "icon": "",
    "divisibility": 0,
    "token_id": ""
  },
  "tick2": {
    "tick": "THIRD•THIRD•TEST•TEO",
    "coin_type": "runes",
    "divisibility": 5,
    "token_id": "74810:134",
    "icon": "T"
  },
  "payer_address": {
    "address": "tb1puyxw3r3tz8f65y2tplmw8g0zcxwmsmgy09ecnu7e7a8l3fhnxmqq5yankx",
    "public_key": "02b08f73e4e80044fb59e109a674bfab916c19140ebbcf5c68dba1226cf5a59536"
  },
  "payer_asset_address": {
    "address": "tb1puyxw3r3tz8f65y2tplmw8g0zcxwmsmgy09ecnu7e7a8l3fhnxmqq5yankx",
    "public_key": "02b08f73e4e80044fb59e109a674bfab916c19140ebbcf5c68dba1226cf5a59536"
  },
  "percent": "10",
  "sig_info": {
    "address": "tb1puyxw3r3tz8f65y2tplmw8g0zcxwmsmgy09ecnu7e7a8l3fhnxmqq5yankx",
    "public_key": "02b08f73e4e80044fb59e109a674bfab916c19140ebbcf5c68dba1226cf5a59536",
    "sign_info": "Address: tb1puyxw3r3tz8f65y2tplmw8g0zcxwmsmgy09ecnu7e7a8l3fhnxmqq5yankx\n\n Remove 10% of BTC/THIRD•THIRD•TEST•TEO liquidity pool share, estimated arrival amount0.00009518BTC, 64.53273451THIRD•THIRD•TEST•TEO(output is estimated, the actual amount will be calculated based on the latest rate after successful submission).\n          \n Operation time: 2025-06-24 10:31:16\n\n Timestamp: 1750732276",
    "signature": "AUCBLX6F7KrpG+EKnwBB3wp/T/R/fWorrZiTXHJWGXB90Q/X7MY6GBQkaR3PhUlmdXSzR4Je81F3a4BcF8SJzWwq"
  },
  "price_tick_lower": 37030,
  "price_tick_upper": 37110
}

200Success

{
  "code": 0,
  "msg": "",
  "data": {
    "order_id": "liquid-1927275549265743872"
  },
  "req_id": "1927275549257355264"
}