Fetch Position Balance

Testing

Development

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

POST

/api/v1/positions/single-balance

Creates Solana Transaction:No

OperationId:fetchPositionBalance

Fetches the current (offchain and/or onchain) or past (offchain) token balances (as a amount and amount in lamports - i.e. amount multiplied by 10^token decimals) for an account.

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

🟢200Success

application/json

Body

🟠400Bad Request

🔴500Internal Server Error

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429Too Many Requests

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://vf-solana-api.dev.alphaledger.com/api/v1/positions/single-balance?solanaClusterId=SOLANA_DEVNET' \
--header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "itemData": {
        "position": {
            "position": {
                "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                "offchainReferences": {
                    "alId": "ALFNDPF000153778",
                    "organizationExternalId": "ALT",
                    "accountNumber": "ALT10000233",
                    "code": "some-authority",
                    "type": "WALLET"
                },
                "isOtherTenantSigner": false,
                "otherTenantOrganizationExternalId": "ALIM",
                "offPlatform": false
            },
            "owner": {
                "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                "offchainReferences": {
                    "alId": "ALFNDPF000153778",
                    "organizationExternalId": "ALT",
                    "accountNumber": "ALT10000233",
                    "code": "some-authority",
                    "type": "WALLET"
                },
                "isOtherTenantSigner": false,
                "otherTenantOrganizationExternalId": "ALIM",
                "offPlatform": false
            },
            "financialInstrument": {
                "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                "offchainReferences": {
                    "alId": "ALFNDPF000153778",
                    "organizationExternalId": "ALT",
                    "accountNumber": "ALT10000233",
                    "code": "some-authority",
                    "type": "WALLET"
                },
                "isOtherTenantSigner": false,
                "otherTenantOrganizationExternalId": "ALIM",
                "offPlatform": false
            },
            "mintAuthority": {
                "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                "offchainReferences": {
                    "alId": "ALFNDPF000153778",
                    "organizationExternalId": "ALT",
                    "accountNumber": "ALT10000233",
                    "code": "some-authority",
                    "type": "WALLET"
                },
                "isOtherTenantSigner": false,
                "otherTenantOrganizationExternalId": "ALIM",
                "offPlatform": false
            },
            "freezeAuthority": {
                "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
                "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
                "offchainReferences": {
                    "alId": "ALFNDPF000153778",
                    "organizationExternalId": "ALT",
                    "accountNumber": "ALT10000233",
                    "code": "some-authority",
                    "type": "WALLET"
                },
                "isOtherTenantSigner": false,
                "otherTenantOrganizationExternalId": "ALIM",
                "offPlatform": false
            }
        },
        "asOf": "2024-09-26T07:58:30.996Z",
        "currentBalanceType": "ONCHAIN"
    },
    "tenancyConfig": {
        "overrideOrganizationExternalId": "ALIM"
    }
}'

Response Example

200 - Example 1

{
    "offchainBalance": {
        "amount": 107.2467,
        "amountInLamports": 10724670000
    },
    "onchainBalance": {
        "amount": 107.2467,
        "amountInLamports": 10724670000
    },
    "outOfBalance": true,
    "reconciled": true
}

Modified at 2025-12-05 08:59:24

Fetch Position Details

Loans