Vulcan Forge
  1. Blockchain Accounts
Vulcan Forge
  • Introduction
  • Getting Started
  • Authentication & Authorization
  • Core Concepts
    • Terminology
    • Regulated Assets
    • Tenants
    • Mapping & Labelling
    • Solana Networks
    • Transaction Processing
    • Key Management
    • Read Layer
  • API Reference
    • Blockchain Accounts
      • Create Account
        POST
      • Fetch Account Details
        POST
      • Fetch Account Balance
        POST
      • Fetch Account Private Key
        POST
      • Fetch Accounts
        POST
      • Update Account
        PATCH
      • Inactivate Account
        PATCH
    • Financial Instruments
      • Create Financial Instrument
      • Update Financial Instrument
      • Fetch Financial Instrument Details
      • Fetch Financial Instruments
      • Token Extensions Calculator
    • Positions
      • State
        • Initialize Position
        • Close Position
        • Freeze Position
        • Unfreeze Position
      • Movements
        • Mint
        • Burn
        • Transfer Financial Instrument
        • Transfer SOL
      • Trades
        • Trade
      • History
        • Fetch Positions
        • Fetch Position Details
        • Fetch Position Balance
    • Loans
      • Create Loan
      • Fetch Loan Details
      • Fetch Loans
      • Swap Collateral
      • Repay Loan
      • Close Loan
      • Refinance Loan
    • Blockchain Transactions
      • Processing
        • Fetch Transaction Status
        • Sign Transaction
        • Submit Transaction
      • Durable Nonces
        • Create Durable Nonce Accounts
        • Fetch Durable Nonce Account Details
        • Fetch Durable Nonce Accounts
      • Address Lookup Tables
        • Create Address Lookup Table
        • Fetch Address Lookup Table Details
        • Fetch Address Lookup Tables
        • Extend Address Lookup Table
        • Update Address Lookup Table
      • History
        • Fetch Transactions
        • Fetch Transaction Details
    • Market Data
      • Update Feed
  • Schemas
    • Accounts
      • DKG
        • DKG Key Setup
      • Offchain References
      • Account Lookup
      • New Account
      • Tenancy Config
      • Account Balance
      • Offchain File
    • Transactions
      • Solana Transaction Config
      • Commitment Config
      • Transaction Lookup
    • Query
      • Query Components
        • Sort Model
        • Field Value Filter
        • Filter Model
      • Items Query
    • Reponses
      • Errors
        • Individual Error
        • Error Response
      • Accounts
        • Private Keys
          • Private Key Details
          • Database Private Key Details
          • Cloud Provider Resource Location
          • DKG Private Key Details
        • Account Response Detailed
        • Account Onchain Detailed
        • Account Offchain Detailed
        • Account Response Identifiers
        • Account Offchain Compact
        • Account Response Compact
        • Account Onchain Compact
      • Transactions
        • Solana Transaction Result
        • Solana Entity Result
      • Positions
        • Position Offchain Result
    • Positions
      • Position Lookup
      • Transfer Financial Instrument Definition
      • Burn Definition
      • Mint Definition
      • Transfer SOL Definition
      • Position Balance
    • Loans
      • Loan Duration
  1. Blockchain Accounts

Fetch Account Details

Testing
Development
https://vf-solana-api.dev.alphaledger.com
Development
https://vf-solana-api.dev.alphaledger.com
POST
/api/v1/accounts/single
Creates Solana Transaction:No
OperationId:fetchAccountDetails
Fetches the details for a single blockchain account.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
🟠429Too Many Requests
🔴500Internal Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://vf-solana-api.dev.alphaledger.com/api/v1/accounts/single?solanaClusterId=SOLANA_DEVNET' \
--header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "itemData": {
        "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
    },
    "tenancyConfig": {
        "overrideOrganizationExternalId": "ALIM"
    }
}'
Response Response Example
200 - Example 1
{
    "onchain": {
        "id": "6YaAdbMCV5GPRZ6AYbyEnGgggAHfEJjXTXYGrDVasQHK",
        "lastTransactionId": "5vnjT6E19V4uQwHMojaR73XFoPjt9Y2nFn74xdDJZTK1MYScNWHpf876JFnSVzSqLxzEMLyzH355WWoiFN5ceMa9",
        "lastTransactionAt": "2024-11-19T14:30:00.000Z",
        "creationTransactionId": "3mTmwiMhwK286USNGGxCormm3srWcR5qmbCUb96jbz79Td53r6Nk2krCPeJ4LUUunwER8icNfGFXD2SQ8RnFPiZL",
        "creationTransactionAt": "2024-11-19T14:30:00.000Z"
    },
    "offchain": {
        "id": "b3e30f57-b404-4bd5-9e31-cec3298fa0bf",
        "type": "WALLET",
        "code": "BCDA",
        "alId": "ALFNDPF000153786",
        "organizationExternalId": "ALT",
        "accountNumber": "ALT355566",
        "name": "Trading Account",
        "lamportsBalance": 4540000,
        "tokenBalance": 2500000000,
        "tokenDecimals": 8,
        "lastTransactionId": "63e1c252-a23c-42af-a7f2-f48a2893c940",
        "creationTransactionId": "f785791f-826b-4fe0-9547-6475518cdc7f",
        "solDebitApiKeys": [
            "string"
        ],
        "tokenDebitApiKeys": [
            "string"
        ]
    },
    "managed": true,
    "privateKeyLocation": [
        "SECRETS"
    ],
    "isDerived": true,
    "comments": "Some comments attached to the account",
    "subscribeToNetworkEvents": true,
    "sharedAcrossTenants": true,
    "wasOnchainAlready": true,
    "canPayFees": true,
    "globalFeePayerForOrgs": [
        "string"
    ],
    "domain": "string"
}
Modified at 2025-12-05 08:59:24
Previous
Create Account
Next
Fetch Account Balance
Built with