Estimation Legacy Transaction

API Documentation: Estimation Legacy Transaction

Overview

This API endpoint allows you to retrieve gas fee for a Bitcoin Legacy Transaction.

• HTTP Method: POST
• Endpoint: /api/v1/wallet/btc/send/legacy/estimate

Request Body Parameters

• walletId (required): this will be used to determine which key used to sign. The type is string.
• to (required): the destination Bitcoin address that will receive the coin.
• amount (required): in the satoshi format.

Example Request Body

{      
    "walletId": "...",    
    "to": "19yRaaL4FZRc66LLf1zuGYp2zrngJC55YK",
    "amount": "3000000"
}

Request

Request Headers

• X-CLIENT-ID: (required): Client ID which was generated when register in Xellar TSS API Service Dashboard.
• X-SIGNATURE: (required): Calculated signature, please refer to Authorization section.
• X-TIMESTAMP: (required): Request timestamp in RFC3339 format.

Example Request Syntax

curl -X POST -H "Content-Type: application/json" -H "x-client-id: $YOUR_CLIENT_ID" -H "x-client-secret: $YOUR_CLIENT_SECRET" -d '{
    "walletId": "...",
    "to": "19yRaaL4FZRc66LLf1zuGYp2zrngJC55YK",
    "amount": "3000000"
}' <BASE_URL>/api/v1/wallet/btc/send/legacy/estimate

Response

The response will include a JSON object with the following properties:

• status (number): The HTTP status code of the response (e.g., 200 for success).
• message (string): A message providing additional information about the operation.
• data (object): An object containing the request information.
• data.transactionSize (number): The length/size of unsigned transaction in bytes.
• data.feePerBytes (number): Suggested fee per bytes.
• data.estimateTotalFee (number): Estimation Total fee, multiplication of transactionSize and estimateTotalFee.

Example Response

{
    "status": 200,
    "message": "Transfer bitcoin legacy estimation successfully",
    "data": {
        "transactionSize": 128,
        "feePerBytes": 4,
        "estimateTotalFee": 512
    }
}