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

post

https://api-dev.saturnbtc.iohttps://api.saturnbtc.io

/v0/transaction/boost

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.

Authorizations

bearer

x-api-keystringRequired

Body

application/json

runeAddressstringRequired

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.

paymentAddressstringOptional

The bitcoin address of the user.

runePublicKeystring · min: 64 · max: 66Required

The rune public key of the user.

Pattern: ^[0-9a-fA-F]+$

paymentPublicKeystring · min: 64 · max: 66Optional

The payment public key of the user.

Pattern: ^[0-9a-fA-F]+$

transactionIdsstring[]Required

The transaction ids to boost.

Responses

201Success

application/json

psbtstringRequired

The PSBT of the boosted transaction.

feestringRequired

The fee of the boosted transaction.

newFeeRatenumberRequired

The new fee rate of the boosted transaction.

feeRatenumberRequired

The fee rate of the boosted transaction.

400

Transaction speedup error

application/json

401

Unauthorized

application/json

403

User not found

application/json

post

/v0/transaction/boost

HTTPcURLJavaScriptPython

POST /v0/transaction/boost HTTP/1.1
Host: api-dev.saturnbtc.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 121

{
  "runeAddress": "text",
  "paymentAddress": "text",
  "runePublicKey": "text",
  "paymentPublicKey": "text",
  "transactionIds": [
    "text"
  ]
}

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

Broadcast a signed transaction

post

https://api-dev.saturnbtc.iohttps://api.saturnbtc.io

/v0/transaction/broadcast

Broadcast a signed transaction.

Authorizations

bearer

x-api-keystringRequired

Body

application/json

runeAddressstringRequired

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.

paymentAddressstringOptional

The bitcoin address of the user.

signedPsbtstringRequired

The signed PSBT of the transaction.

txTypeone ofRequired

The type of the transaction.

const: tradeOptional

or

const: prepare_walletOptional

or

const: extractOptional

or

const: purchaseOptional

or

const: vsrCreationOptional

or

const: depositOptional

or

const: withdrawOptional

or

const: mintOptional

or

const: etchOptional

or

const: initialize_poolOptional

or

const: increase_liquidityOptional

or

const: decrease_liquidityOptional

or

const: open_positionOptional

or

const: add_pool_shardsOptional

or

const: swapOptional

Responses

201Success

application/json

stringOptional

400

Transaction speedup error

application/json

401

Unauthorized

application/json

403

User not found

application/json

post

/v0/transaction/broadcast

HTTPcURLJavaScriptPython

POST /v0/transaction/broadcast HTTP/1.1
Host: api-dev.saturnbtc.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 80

{
  "runeAddress": "text",
  "paymentAddress": "text",
  "signedPsbt": "text",
  "txType": null
}

text