Sign in
Payments

Estimate an outgoing payment fee

Returns the provider-derived expected fee and the hard maximum used during payment execution.

post/v1/payments/fee-estimate

Request

  • The document declares no server URL.
  • Auth: HTTP bearer

Request body

amount_msatinteger nullable

Amount in millisatoshis. Only necessary if the input does not specify an amount (empty Bolt11, LNURL or LN Address)

commentstring nullable

Comment of the payment. Visible by the recipient for LNURL payments

inputstring required

Recipient. Can be a Bolt11 invoice, LNURL or LN Address.

wallet_idstring uuid nullable

Wallet ID to pay from. Required by admin endpoints; derived from the path on wallet-scoped endpoints.

Example request

{
  "input": "hello@numeraire.tech"
}

Response

Fee estimated

amount_msatinteger required

Amount delivered to the recipient, in millisatoshis.

estimated_fee_msatinteger nullable

Provider-derived fee expected at quote time, in millisatoshis.

estimated_total_msatinteger nullable

Expected amount plus fee, in millisatoshis.

ledger'Lightning' | 'Internal' | 'Onchain' required

The ledger a transaction settles on.

maximum_fee_msatinteger required

Lightning execution cap or current prepared on-chain fee, in millisatoshis.

maximum_total_msatinteger required

Amount plus the Lightning cap or current on-chain fee, in millisatoshis.

Changes

No operation changes recorded.