Increase Liquidity
Generates a PSBT for increasing liquidity in an existing position by sending funds to the pool.
The pool's identifier.
^[0-9a-fA-F]+$The amount of the first token to deposit.
^[1-9][0-9]*$The amount of the second token to deposit.
^[1-9][0-9]*$A boolean indicating whether to initialize the account UTXO.
If you're creating a new position, you should set this to true.
The fee rate for the transaction (in sats per byte).
The public key of the rune address of the user initiating the request.
^[0-9a-fA-F]+$The public key of the bitcoin address of the user initiating the request. If the user doesn't have a bitcoin address, the runePubkey will be used
^[0-9a-fA-F]+$The rune address of the user. It must be a taproot address. (P2TR). If no bitcoin address is provided, the rune address will be used for bitcoin too.
The bitcoin address of the user.
An object containing the PSBT (in base64 format), the fee, and the list of UTXOs to sign.
Pool error
Unauthorized
User not found
Internal Server Error
POST /v0/pool/increase-liquidity/psbt HTTP/1.1
Host: api-dev.saturnbtc.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 180
{
"poolId": "text",
"amount0": "text",
"amount1": "text",
"initializeAccountUtxo": true,
"feeRate": 1,
"runePubkey": "text",
"paymentPubkey": "text",
"runeAddress": "text",
"paymentAddress": "text"
}{
"mergeUtxoPsbt": {
"psbt": "text",
"fee": 1,
"utxosToSign": [
{
"address": "text",
"signingIndexes": [
1
],
"sigHash": 1,
"utxo": "text"
}
]
},
"psbt": "text",
"fee": 1,
"utxosToSign": [
{
"address": "text",
"signingIndexes": [
1
],
"sigHash": 1,
"utxo": "text"
}
]
}Generates a message hash for increasing liquidity in an existing position, which the user should sign.
The pubkey of the position.
^[0-9a-fA-F]+$The pubkey of the pool.
^[0-9a-fA-F]+$The fee rate for the transaction (in sats per byte).
The signed PSBT in base64 format.
^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{4}|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{2}={2})$The public key of the rune address of the user initiating the request.
^[0-9a-fA-F]+$The public key of the bitcoin address of the user initiating the request. If the user doesn't have a bitcoin address, the runePubkey will be used
^[0-9a-fA-F]+$The merge UTXO PSBT in base64 format.
^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{4}|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{2}={2})$The amount of the first token to deposit.
^[1-9][0-9]*$The amount of the second token to deposit.
^[1-9][0-9]*$The rune address of the user. It must be a taproot address. (P2TR). If no bitcoin address is provided, the rune address will be used for bitcoin too.
The bitcoin address of the user.
A hexadecimal string representing the hash of the message to be signed by the user.
Pool error
Unauthorized
User not found
Internal Server Error
POST /v0/pool/increase-liquidity/message HTTP/1.1
Host: api-dev.saturnbtc.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 218
{
"positionPubKey": "text",
"poolId": "text",
"feeRate": 1,
"signedPsbt": "text",
"runePubkey": "text",
"paymentPubkey": "text",
"mergeUtxoPsbt": "text",
"amount0": "text",
"amount1": "text",
"runeAddress": "text",
"paymentAddress": "text"
}textFinalizes the increase of liquidity in an existing position by submitting the signed message and executing the transaction on the network.
The user's signature of the increase liquidity message.
^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{4}|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{2}={2})$The pubkey of the position.
^[0-9a-fA-F]+$The pubkey of the pool.
^[0-9a-fA-F]+$The fee rate for the transaction (in sats per byte).
The signed PSBT in base64 format.
^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{4}|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{2}={2})$The public key of the rune address of the user initiating the request.
^[0-9a-fA-F]+$The public key of the bitcoin address of the user initiating the request. If the user doesn't have a bitcoin address, the runePubkey will be used
^[0-9a-fA-F]+$The merge UTXO PSBT in base64 format.
^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{4}|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{2}={2})$The amount of the first token to deposit.
^[1-9][0-9]*$The amount of the second token to deposit.
^[1-9][0-9]*$The rune address of the user. It must be a taproot address. (P2TR). If no bitcoin address is provided, the rune address will be used for bitcoin too.
The bitcoin address of the user.
The Arch Network transaction ID of the liquidity increase.
Pool error
Unauthorized
User not found
Internal Server Error
POST /v0/pool/increase-liquidity HTTP/1.1
Host: api-dev.saturnbtc.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 237
{
"signature": "text",
"positionPubKey": "text",
"poolId": "text",
"feeRate": 1,
"signedPsbt": "text",
"runePubkey": "text",
"paymentPubkey": "text",
"mergeUtxoPsbt": "text",
"amount0": "text",
"amount1": "text",
"runeAddress": "text",
"paymentAddress": "text"
}{
"archTxId": "text",
"bitcoinTxIds": [
"text"
]
}Last updated