Boost Transaction

Overview

• Functionality: Boost and broadcast transactions

• API Key authentication: Access to all endpoints requires the x-api-key header provided by Saturn

• Address parameter: All requests must have the Content-Type header of application/json and provide the address in the body of the wallet that is requesting the broadcast.

Endpoints

Boost an array of transaction ids. User must own some of the outputs of those transactions

Boost an array of transaction ids. User must own some of the outputs of those transactions. The response will contain a PSBT that can be signed by the user. You can then broadcast the PSBT using the /broadcast endpoint.

POSThttps://api-dev.saturnbtc.io/v0/transaction/boost

Authorization

bearer

Body

application/json

address*string

The address of the user. If no secondary address is provided, the primary address must be a taproot address. (P2TR)

secondaryAddressstring

The secondary address of the user. Must be a taproot address. (P2TR)

publicKey*The public key of the user

The public key of the user.

secondaryPublicKeyThe secondary public key of the user

The secondary public key of the user.

transactionIds*The transaction ids to boost

The transaction ids to boost.

Response

201400401403

Body

application/json

psbt*The PSBT of the boosted transaction

The PSBT of the boosted transaction.

fee*The fee of the boosted transaction

The fee of the boosted transaction.

newFeeRate*The new fee rate of the boosted transaction

The new fee rate of the boosted transaction.

feeRate*The fee rate of the boosted transaction

The fee rate of the boosted transaction.

utxosToSign*The inputs to sign for the boosted transaction

The inputs to sign for the boosted transaction.

Request

JavaScriptCurlPython

const response = await fetch('https://api-dev.saturnbtc.io/v0/transaction/boost', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "address": "text",
      "publicKey": "text",
      "transactionIds": [
        "text"
      ]
    }),
});
const data = await response.json();

Response

201400401403

{
  "psbt": "text",
  "fee": "text",
  "newFeeRate": 0,
  "feeRate": 0,
  "utxosToSign": [
    {
      "address": "text",
      "signingIndexes": [
        0
      ],
      "sigHash": 0,
      "utxo": "text"
    }
  ]
}

Broadcast a signed transaction

Broadcast a signed transaction.

POSThttps://api-dev.saturnbtc.io/v0/transaction/broadcast

Authorization

bearer

Body

application/json

address*string

The address of the user. If no secondary address is provided, the primary address must be a taproot address. (P2TR)

secondaryAddressstring

The secondary address of the user. Must be a taproot address. (P2TR)

signedPsbt*The signed PSBT of the transaction

The signed PSBT of the transaction.

txType*The type of the transaction

The type of the transaction.

anyanyanyanyanyanyanyanyanyanyanyanyanyanyany

Response

201400401403

Body

application/json

string

Request

JavaScriptCurlPython

const response = await fetch('https://api-dev.saturnbtc.io/v0/transaction/broadcast', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "address": "text",
      "signedPsbt": "text"
    }),
});
const data = await response.json();

Response

201400401403

text