GEgemini
Fund Management

List Past Transfers

<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 transfers endpoint is being retired. This v2 endpoint is the recommended replacement, offering full multichain support with accurate status for all supported networks. Please migrate to this endpoint at your earliest convenience. </div> </div>

This endpoint shows deposits and withdrawals in supported currencies with full multichain (multi-network) support. It returns accurate status information for transfers on all supported networks including Solana, Arbitrum, Optimism, Base, Avalanche, and Ethereum.

Each transfer in the response includes a network field identifying the blockchain network, along with network-specific feeAmount, feeCurrency, and txHash values.

This endpoint does not currently show cancelled advances, returned outgoing wires or ACH transactions, or other exceptional transaction circumstances.

Fiat transfers between non-derivative and derivatives accounts are prohibited.

Roles

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

The OAuth scope must have history:read assigned to access this endpoint. See OAuth Scopes for more information.

post/v2/transfers

Request

  • Base URL
    https://api.gemini.com
  • URL
    https://api.gemini.com/v2/transfers
  • Auth
    API key in header X-GEMINI-APIKEY and API key in header X-GEMINI-SIGNATURE and API key in header X-GEMINI-PAYLOAD

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 literal string "/v2/transfers"

currencystring

Currency code, see symbols and minimums

networkstring

Filter transfers by blockchain network (e.g., ethereum, solana, arbitrum, optimism, base, avalanche)

limit_transfersinteger

The maximum number of transfers to return. The default is 10 and the maximum is 50.

accountstring

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

show_completed_deposit_advancesboolean

Whether to display completed deposit advances. True by default.

Example request

{
  "nonce": "1495127793000",
  "timestamp": "1495127793000"
}

Response

Successful operation

type'Deposit' | 'Withdrawal' | 'Reward' | 'AdminDebit' | 'AdminCredit'

The type of the transfer

status'Complete' | 'Pending' | 'Advanced'

The status of the transfer

eidinteger

The transfer event ID

currencystring

The currency transferred

amountstring

The amount transferred

networkstring

The blockchain network the transfer was executed on (e.g., ethereum, solana, arbitrum, optimism, base, avalanche). Not present for fiat or administrative transfers.

feeAmountstring

The fee charged for the transfer

feeCurrencystring

The currency in which the fee was charged

txHashstring

The on-chain transaction hash, if applicable

methodstring

The transfer method (e.g., ACH, CreditCard)

destinationstring

The destination address for withdrawals

withdrawalIdstring

The unique withdrawal identifier

outputIdxinteger

The output index for withdrawals

purposestring

The purpose or reason for administrative transfers

Example response

[
  {
    "timestampms": "1495127793000"
  }
]

Changes

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