Estimate Transfer Coin/Native

API Documentation: Estimate Transfer Coin/Native

Overview

This API endpoint allows you to retrieve estimate gas used, suggest gas price and suggest gas fee for a transaction.

• HTTP Method: POST
• Endpoint: /api/v1/wallet/eth/send/coin/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 EVM address that will receive the coin.
• amount (required): in the wei format.

Example Request Body

{      
    "walletId": "...",        
    "to" : "0xeF236f1b35B2105836540c23d055d1BFb6c5db52",
    "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" : "0xeF236f1b35B2105836540c23d055d1BFb6c5db52",
    "amount": "3000000"
}' <BASE_URL>/api/v1/wallet/eth/send/coin/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.gasEstimation (number): The gas estimation needed to execute a specific transaction based on the current pending state of the backend blockchain.
• data.suggestGasPrice (number): The the currently suggested gas price to allow a timely execution of a transaction.
• data.gasFeeEstimation (number): The multiplication of gasFeeEstimation and suggestGasPrice.

Example Response

{
    "status": 200,
    "message": "Transfer Coin Estimation Successfully",
    "data": {
        "gasEstimation": 21000,
        "suggestGasPrice": 3564020892,
        "gasFeeEstimation": 74844438732000
    }
}