LIlightsparkdev
Cross-Currency Transfers

Estimate crypto withdrawal fee

Changed on

Estimate the network and application fees for a cryptocurrency withdrawal from a crypto internal account to an external blockchain address. Use this to show fee information to customers before they initiate a withdrawal.

post/crypto/estimate-withdrawal-fee

Request

  • Base URL
    https://api.lightspark.com/grid/2025-10-13
  • URL
    https://api.lightspark.com/grid/2025-10-13/crypto/estimate-withdrawal-fee
  • Auth
    HTTP basic

Request body

internalAccountIdstring required

The ID of the crypto internal account to withdraw from.

currencystring required

The currency code of the asset to withdraw (e.g. USDC).

cryptoNetworkstring required

The blockchain network for the withdrawal. Example values: SOLANA, ETHEREUM, BASE, POLYGON, ARBITRUM, SPARK, LIGHTNING, BITCOIN.

amountinteger required

The amount to withdraw in the smallest unit of the currency.

destinationAddressstring required

The blockchain address to withdraw funds to.

Example request

{
  "internalAccountId": "InternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123",
  "currency": "USDC",
  "cryptoNetwork": "SOLANA",
  "amount": 1000000,
  "destinationAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
}

Response

Fee estimation returned successfully

networkFeeinteger required

The estimated network (gas) fee in the smallest unit of the network fee asset (e.g. lamports for SOL). This is provided for informational purposes to show the raw on-chain cost. Note that this value is denominated in networkFeeAsset, not in the withdrawal currency — it cannot be directly added to applicationFee or compared to totalFee.

networkFeeAssetstring required

The asset used to pay the network fee (e.g. SOL for Solana transactions).

applicationFeeinteger required

The application fee charged by the platform in the smallest unit of the withdrawal currency. Zero if no application fee applies.

totalFeeinteger required

The total cost of the withdrawal in the smallest unit of the withdrawal currency. This equals the network fee converted to the withdrawal currency at current rates plus the application fee. This is the amount deducted from the withdrawal in addition to netAmount.

netAmountinteger required

The net amount the recipient will receive after fees, in the smallest unit of the withdrawal currency.

Example response

{
  "networkFee": 5000,
  "networkFeeAsset": "SOL",
  "totalFee": 5000,
  "netAmount": 995000
}

Changes

  • d996ddfb9d2bRevision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • 715332dcb111Revision changes
    • warning

      added the new EXACT_AMOUNT_UNAVAILABLE enum value to the response property for the response status