Wallet
Private

Transfer funds between two subaccounts or between a subaccount and the main account.

📖 Related Article: Managing Transfers

Scope: wallets:read_write

Try in API console

get/private/submit_transfer_between_subaccounts

Request

  • Base URL
    https://test.deribit.com/api/v2
  • URL
    https://test.deribit.com/api/v2/private/submit_transfer_between_subaccounts
  • Auth
    none declared

Query parameters

currency'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR' required

Currency, i.e "BTC", "ETH", "USDC"

The currency symbol.

📖 Related Article: Using the currency Parameter

amountnumber required

Amount of funds to be transferred

destinationinteger required
Example:1

Id of destination subaccount. Can be found in My Account >> Subaccounts tab

sourceinteger
Example:1

Source account id, defaulting to the caller. With main-account authorization, either the main account or one of its subaccounts may be the source; a subaccount caller can transfer only from itself to its main account.

noncestring

Nonce

Example:bF1_gfgcsd

Optional idempotency nonce. If provided, subsequent requests with the same nonce will return the previously created transaction instead of creating a new one. Must be 8-128 characters. The nonce is persisted on the resulting transaction and returned in the response.

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

Example response

{
  "result": {
    "id": 12,
    "created_timestamp": 1536569522277,
    "amount": 1,
    "other_side": "Smith",
    "updated_timestamp": 1536569522277
  }
}

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status