Transfer Network Currency

Transfer the specified amount of network currency (e.g. SOL). The source account needs to have a sufficient balance to support the transfer.

Signers

itemData.source

fee payer (in transactionConfig or global fee payer)

IMPORTANT NOTE: takeSourceBalanceToMinimumRent=true should be used if the API client wants to reclaim all the network currency from an account and leave the account active only with a balance to cover the minimum rent fee. The account will be completly drawn down up to the minimum amount required to cover the rent fee, based on the current account data size. The transfer amount = current onchain balance - minimum rent fee.

We use this as a convenience feature, mostly with our DEFI_SETTLEMENT_WALLETs. These wallets are passthrough wallets and when they are dormant we want to keep only the minimum rent in them. With this flag we can easily drawn them down to minimum rent and transfer out unused balances - typically back to a global fee payer wallet. Other use cases can apply.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://vf-solana-api.dev.alphaledger.com/api/v1/positions/transfer-network-currency?svmCluster=SOLANA_DEVNET' \ --header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '// offchainReferences -> onchainId (on-platform) { "itemData": { // if you know the amount in lamports, use the lamports field and remmove the network currency field // "lamports": 170000, "amount": 0.00017, // uncomment the memo field if you want a memo added to the txn // "memo": "Transfer some network currency for testing", "source": { "offchainReferences": { "code": "xyz-global-fee-payer", "type": "WALLET", "organizationExternalId": "XYZ" } }, "destination": { "onchainId": "DELkrQ6gZg8eHMzNtwB8YAcswVvzGMQ3QoFkUYBriWYJ" } } }'

{ "success": false, "offchainId": "ee36c656-aa74-4d6a-b23c-332c204cb202", "status": "SIGNED", "onchainId": "5nwo7XvhiVRpJasEzH5r3hGKJqaTxd7qVit3cedFJgESdAPrmawebMJu6fUKRfjXEaivuey7vBsW56xPxX76T1bm", "confirmationsCount": 2, "serializedMessage": "string", "errorMessage": "string", "txnTimestamp": "2025-10-21T16:17:45.035372Z" }

Request

Responses