GEgemini
Fund Management

Get Gas Fee Estimation

<div class="p-4 text-sm section-icon section-info rounded-sm" role="alert"> <div class="flex"> <svg view-box="0 0 24 24" > <path fill-rule="evenodd" clip-rule="evenodd" d="M4 12C4 7.58172 7.58172 4 12 4C16.4183 4 20 7.58172 20 12C20 16.4183 16.4183 20 12 20C7.58172 20 4 16.4183 4 12ZM12 2C6.47715 2 2 6.47715 2 12C2 17.5228 6.47715 22 12 22C17.5228 22 22 17.5228 22 12C22 6.47715 17.5228 2 12 2ZM11 17V11H13V17H11ZM11 9V7H13V9H11Z" /> </svg> The v1 fee estimation endpoint is being retired. This v2 endpoint is the recommended replacement, offering explicit blockchain network selection for multi-network tokens. Please migrate to this endpoint at your earliest convenience. </div> </div>

API users will not be aware of the transfer fees before starting the withdrawal process. This endpoint allows you to find out the estimated gas fees before you start a withdrawal. It requires specifying the blockchain network and ticker, which is useful for tokens that exist on multiple networks (e.g. USDC on Ethereum vs Solana).

Roles

The API key you use to access this endpoint can have the Trader, Fund Manager, Auditor, WealthManager or Administrator role assigned. See Roles for more information.

post/v2/withdraw/{network}/{ticker}/feeEstimate

Request

  • Base URL
    https://api.gemini.com
  • URL
    https://api.gemini.com/v2/withdraw/{network}/{ticker}/feeEstimate
  • Auth
    API key in header X-GEMINI-APIKEY and API key in header X-GEMINI-SIGNATURE and API key in header X-GEMINI-PAYLOAD

Path parameters

networkstring required

The blockchain network for the withdrawal (e.g. ethereum, bitcoin, solana)

tickerstring required

The currency code for the withdrawal (e.g. eth, btc, sol, usdc)

Headers

X-GEMINI-APIKEYstring required

Your API key

X-GEMINI-SIGNATUREstring required

HEX-encoded HMAC-SHA384 of payload signed with API secret

X-GEMINI-PAYLOADstring required

Base64-encoded JSON payload

Content-Typestring
Content-Lengthstring
Cache-Controlstring

Request body

requeststring required

The string /v2/withdraw/{network}/{ticker}/feeEstimate where {network} is the blockchain network (e.g. ethereum, bitcoin, solana) and {ticker} is the currency code (e.g. eth, btc, sol). See Symbols and minimums

addressstring required

Standard string format of the destination cryptocurrency address

amountstring required

Quoted decimal amount to withdraw

accountstring

Required for Master API keys. The name of the account within the subaccount group.

memostring

It would be present if applicable, it will be present for cosmos address.

Example request

{
  "request": "/v2/withdraw/ethereum/eth/feeEstimate",
  "nonce": "1495127793000",
  "address": "0x31c2105b8dea834167f32f7ea7d877812e059230",
  "amount": "0.01",
  "account": "primary"
}

Response

Successful fee estimation response

currencystring

Currency code, see symbols.

feenumber

The estimated withdrawal fee as a decimal amount

isOverrideboolean

Whether an override on the customer's account for free withdrawals exists

monthlyLimitinteger

Total number of allowable fee-free withdrawals

monthlyRemaininginteger

Total number of allowable fee-free withdrawals remaining

Example response

{
  "currency": "ETH",
  "fee": 0.001,
  "monthlyLimit": 1,
  "monthlyRemaining": 1
}

Changes

No recorded changes to this operation across all 1 revision of this API.