Transfer SOL

Testing

Development

https://vf-solana-api.dev.alphaledger.com

POST

/api/v1/positions/transfer-sol

Creates Solana Transaction:Always

OperationId:transferSol

Transfer the specified amount of SOL or lamports. 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 SOL 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.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢201Created

application/json

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

offchainReferences -> onchainId (on-platform)offchainReferences -> offchainId (on-platform)offchainReferences -> offchainReferences (on-platform)onchainId -> onchainId (off-platform)offchainId -> onchainId (on-platform)

curl --location --request POST 'https://vf-solana-api.dev.alphaledger.com/api/v1/positions/transfer-sol?solanaClusterId=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 sol field
        // "lamports": 170000,
        "sol": 0.00017,
        // uncomment the memo field if you want a memo added to the txn
        // "memo": "Transfer some SOL for testing",
        "source": {
            "offchainReferences": {
                "code": "xyz-global-fee-payer",
                "type": "WALLET",
                "organizationExternalId": "XYZ"
            }
        },
        "destination": {
            "onchainId": "DELkrQ6gZg8eHMzNtwB8YAcswVvzGMQ3QoFkUYBriWYJ"
        }
    }
}'

Response Example

201 - Example 1

{
    "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"
}

Modified at 2025-12-05 10:10:20

Transfer Financial Instrument

Trades