# Exchange Transfers

Fordefi supports both depositing into and withdrawing from your connected exchange vaults.

## Decimal precision

It is important to note that for **withdrawals** from an exchange vault, the Fordefi API requires amounts to be specified with 18-decimal precision, regardless of the asset's native decimal places.

This convention exists because assets held on an exchange do not inherently have an associated blockchain, and the same asset can be withdrawn to multiple different chains, each potentially using different decimal standards. To maintain consistency and accuracy across all chains and withdrawal types, Fordefi standardizes on a fixed precision of 18 decimals when representing asset balances on exchanges and during withdrawals.

For example:

- For 1 SOL: `1000000000000000000` (even though SOL has 9 decimal places natively)
- For 1 USDC: `1000000000000000000` (even though USDC has 6 decimal places on Ethereum)


**Deposits** into an exchange vault are regular on-chain transactions. Therefore, when depositing into an exchange vault, use the **native** decimal places of the deposited asset on the source chain. For example:

- For 1 SOL: `1000000000`
- For 1 USDC: `1000000`
- For 1 ETH: `1000000000000000000`


The net_amount parameter 
In withdrawal operations, the `value` object supports an optional `is_net_amount` flag:

- `is_net_amount: true` → fees are added **on top** of the specified transfer amount, so you'll
receive exactly the amount you specify.
- `is_net_amount: false` (or omitted) → fees are deducted **from** the specified amount.


## Examples

### Deposits

This example shows how to deposit SOL on Solana from a regular Fordefi Solana vault to a Binance exchange vault. Note that the `to` field is set to the Binance exchange vault's ID.


```json
{
    "signer_type": "api_signer",
    "type": "solana_transaction",
    "vault_id": "2d16514e-93c6-42b9-b618-00bfa559445a", // your regular Fordefi Solana Vault ID
    "details": {
        "type": "solana_transfer",
        "to": "5a15271f-a320-43cc-9d16-ed5bafd5b4ae", // your Binance Exchange Vault ID
        "asset_identifier": {
            "type": "solana",
            "details": {
                "type": "native",
                "chain": "solana_mainnet"
            }
        },
        "value": {
            "type": "value",
            "value": "10000" // 0.00001 SOL (using its NATIVE 9-decimal precision)
        }
    }
}
```

### Withdrawals

To withdraw from an exchange vault, set the transaction `type` to `exchange_transaction` and the `to` field to:
`{"address": "0x1234...", "type": "address"}` when withdrawing to an external address and to `{"vault_id": "2d16514e-93c6-42b9-b618-00bfa559445a","type": "vault"}` when withdrawing to a regular Fordefi vault or to another exchange vault.

Below are some examples of transaction requests for:

- Withdrawal from Binance to a regular Fordefi vault (SOL on Solana)
- Withdrawal from Coinbase to an external address (USDC on Ethereum)
- Withdrawal from Coinbase to Binance (USDC on Ethereum)


To a Fordefi vault

```json
{
    "signer_type": "api_signer",
    "type": "exchange_transaction",
    "vault_id": "5a15271f-a320-43cc-9d16-ed5bafd5b4ae", // your Binance Exchange Vault ID
    "details": {
        "type": "external_withdraw",
        "chain": "solana_mainnet",
        "to": {
            "address": "EjL8jgiEMwuHT6xsDwm7HmF4uqv2cAjJULfXwUm6ZSSD", // your regular Fordefi Solana Vault address
            "type": "address"
        },
        "asset_identifier": {
            "asset_symbol": "SOL",
            "exchange_type": "binance",
            "type": "exchange"
        },
        "value": {
            "type": "value",
            "value": "1000000000000000000", // 1 SOL (using 18-decimal precision)
            "is_net_amount": true        // Fee charged on top of this amount
        }
    }
}
```

To an external address

```json
{
    "signer_type": "api_signer",
    "type": "exchange_transaction",
    "vault_id": "c149ecfa-111e-446b-b222-249d467a67d2", // your Coinbase Exchange Vault ID
    "details": {
        "type": "external_withdraw",
        "chain": "evm_ethereum_mainnet",
        "to": {
            "address": "0x1234.....", // any external address on Ethereum
            "type": "address"
        },
        "asset_identifier": {
            "asset_symbol": "USDC",
            "exchange_type": "coinbase_international",
            "type": "exchange"
        },
        "value": {
            "type": "value",
            "value": "1000000000000000000", // 1 USDC (using 18-decimal precision)
            "is_net_amount": true        // Fee charged on top of this amount
        }
    }
}
```

To a different exchange

```json
{
    "signer_type": "api_signer",
    "type": "exchange_transaction",
    "vault_id": "c149ecfa-111e-446b-b222-249d467a67d2", // your Coinbase Exchange Vault ID
    "details": {
        "type": "external_withdraw",
        "chain": "evm_ethereum_mainnet",
        "to": {
            "vault_id": "5a15271f-a320-43cc-9d16-ed5bafd5b4ae", // your Binance Exchange Vault ID
            "type": "vault"
        },
        "asset_identifier": {
            "asset_symbol": "USDC",
            "exchange_type": "coinbase_international",
            "type": "exchange"
        },
        "value": {
            "type": "value",
            "value": "1000000000000000000", // 1 USDC (using 18-decimal precision)
            "is_net_amount": true        // Fee charged on top of this amount
        }
    }
}
```

## Additional resources

- [Exchange Transfers API Examples](https://github.com/FordefiHQ/api-examples/tree/main/python/exchange-transfers)
- [Fordefi API Reference](https://docs.fordefi.com/api/openapi/transactions/create_transaction_api_v1_transactions_post)
- [Fordefi Exchange Integration Guide](https://docs.fordefi.com/user-guide/integrate-exchanges)