> ## Documentation Index
> Fetch the complete documentation index at: https://v3.docs.derive.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Transfer a spot asset to another owner's subaccount

> Submits a signed transfer of a single spot asset to a subaccount belonging to a different owner. Alongside the standard transfer fields (asset, sub_id, amount, nonce, signer, signature, expiry, max USD fee) you give the recipient's wallet address and either an existing destination subaccount or 0 to create a new one under new_subaccount_manager; the max fee must cover both the transfer and any subaccount-creation cost. Requires a session key permitted to transfer to a different owner and returns the operation id and uuid.



## OpenAPI

````yaml /openapi.json post /private/transfer_spot_external
openapi: 3.1.0
info:
  title: Derive v3 API
  version: 0.2.0
  description: JSON-RPC 2.0 methods, served over WebSocket and HTTP POST.
servers:
  - url: https://api.derive.xyz/v3
    description: Production (HTTP POST base)
  - url: https://testnet.api.derive.xyz/v3
    description: Testnet (HTTP POST base)
security: []
tags:
  - name: Subaccounts
    description: >-
      List, inspect, and label subaccounts, portfolios, positions, and
      collateral.
  - name: Session Keys
    description: Register, edit, and list delegated signing keys.
  - name: Account
    description: Wallet-level account information and settings.
  - name: Orderbook
    description: Place, replace, cancel, and query orders, trigger orders, and algos.
  - name: RFQ
    description: 'Request-for-quote: send RFQs, quote, and execute block trades.'
  - name: Vault Shareholders
    description: >-
      Deposit into and withdraw from vaults, and track shares, requests, and
      performance.
  - name: Vault Curators
    description: >-
      Create and operate curated vaults: settle deposit and withdrawal requests,
      and manage vault metadata.
  - name: History
    description: >-
      Per-account historical records: orders, trades, transfers, and
      settlements.
  - name: Market Maker Protection
    description: Configure, read, and reset market-maker protection.
  - name: Transfers & Withdrawals
    description: Move collateral between subaccounts, to other wallets, and on-chain.
  - name: System
    description: Rate limits and transaction lookups.
  - name: Market Data
    description: Instruments, currencies, tickers, and market-wide feeds.
  - name: Referrals
    description: Referral codes and program performance.
  - name: Other
    description: Uncategorized.
paths:
  /private/transfer_spot_external:
    post:
      tags:
        - Transfers & Withdrawals
      summary: Transfer a spot asset to another owner's subaccount
      description: >-
        Submits a signed transfer of a single spot asset to a subaccount
        belonging to a different owner. Alongside the standard transfer fields
        (asset, sub_id, amount, nonce, signer, signature, expiry, max USD fee)
        you give the recipient's wallet address and either an existing
        destination subaccount or 0 to create a new one under
        new_subaccount_manager; the max fee must cover both the transfer and any
        subaccount-creation cost. Requires a session key permitted to transfer
        to a different owner and returns the operation id and uuid.
      operationId: private_transfer_spot_external
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PrivateTransferSpotExternalRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrivateTransferSpotExternalResponse'
        default:
          description: JSON-RPC error (see Error Codes)
components:
  schemas:
    PrivateTransferSpotExternalRequest:
      type: object
      required:
        - amount
        - asset_name
        - max_fee_usd
        - new_subaccount_manager
        - nonce
        - recipient_address
        - signature
        - signature_expiry_sec
        - signer
        - sub_id
        - subaccount_id
        - to_subaccount_id
      properties:
        amount:
          description: >-
            Transfer amount in units of the asset, as a decimal string (e.g.
            `"1.5"`) or JSON number.
          type: string
          format: decimal
        asset_name:
          type: string
        max_fee_usd:
          description: >-
            Maximum sequencer fee the signer authorises, in USD, as a decimal
            string (e.g. `"1.5"`) or a JSON number. Must cover both the transfer
            fee and any subaccount-creation fee.
          type: string
          format: decimal
        new_subaccount_manager:
          description: Manager id for the new subaccount when `to_subaccount_id == 0`.
          type: integer
          format: uint32
          minimum: 0
        nonce:
          type: integer
          format: int64
        recipient_address:
          description: Owner of the destination account/subaccount.
          type: string
        signature:
          type: string
        signature_expiry_sec:
          type: integer
          format: uint64
          minimum: 0
        signer:
          type: string
        sub_id:
          type: integer
          format: uint128
          minimum: 0
        subaccount_id:
          type: integer
          format: uint64
          minimum: 0
        to_subaccount_id:
          description: >-
            Recipient's existing destination subaccount. `0` → create a new
            subaccount for `recipient_address` under `new_subaccount_manager`.
          type: integer
          format: uint64
          minimum: 0
    PrivateTransferSpotExternalResponse:
      type: object
      required:
        - op_uuid
        - operation_id
      properties:
        op_uuid:
          type: string
        operation_id:
          type: integer
          format: uint64
          minimum: 0

````

## Related topics

- [Transfer a spot asset between your subaccounts](/api-reference/transfers-&-withdrawals/transfer-a-spot-asset-between-your-subaccounts.md)
- [Transfers & Withdrawals](/trading/transfers-withdrawals.md)
- [Migration skill for your coding agent](/migrating/breaking-changes.md)