Vulcan Forge
  1. Loans
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
      • Fetch Account Details
      • Fetch Account Balance
      • Fetch Account Private Key
      • Fetch Accounts
      • Update Account
      • Inactivate Account
    • 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
        POST
      • Fetch Loan Details
        POST
      • Fetch Loans
        POST
      • Swap Collateral
        PATCH
      • Repay Loan
        PATCH
      • Close Loan
        PATCH
      • Refinance Loan
        PATCH
    • 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. Loans

Fetch Loan Details

Testing
Development
https://vf-solana-api.dev.alphaledger.com
Development
https://vf-solana-api.dev.alphaledger.com
POST
/api/v1/loans/single
Creates Solana Transaction:No
OperationId:fetchLoanDetails
Gets details associated with a single onchain loan.

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/loans/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": {
        "escrow": {
            "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
        },
        "computeEstimatedInterestUntil": "2022-09-27T18:00:00.000Z"
    },
    "tenancyConfig": {
        "overrideOrganizationExternalId": "ALIM"
    }
}'
Response Response Example
200 - Example 1
{
    "status": "OPEN",
    "origination": "string",
    "escrow": {
        "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"
    },
    "borrower": {
        "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"
    },
    "lender": {
        "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"
    },
    "pledgedItems": [
        {
            "pledgedAmount": 0,
            "accountDetails": {
                "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"
            }
        }
    ],
    "borrowedItems": [
        {
            "apy": 0,
            "loanToValueRatio": 0,
            "liquidationRatio": 0,
            "duration": {
                "code": "DAYS",
                "unit": 1
            },
            "principalDue": 0,
            "principalRepaid": 0,
            "interestPerSecond": 0,
            "lastInterestUpdateTime": "string",
            "interestOutstanding": 0,
            "estimatedInterest": 0,
            "accountDetails": {
                "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"
            }
        }
    ],
    "marketData": [
        {
            "financialInstrument": {
                "onchain": {
                    "id": "6YaAdbMCV5GPRZ6AYbyEnGgggAHfEJjXTXYGrDVasQHK",
                    "lastTransactionId": "5vnjT6E19V4uQwHMojaR73XFoPjt9Y2nFn74xdDJZTK1MYScNWHpf876JFnSVzSqLxzEMLyzH355WWoiFN5ceMa9",
                    "lastTransactionAt": "2025-09-11T20:22:54.531 +0200"
                },
                "offchain": {
                    "id": "b3e30f57-b404-4bd5-9e31-cec3298fa0bf",
                    "type": "WALLET",
                    "code": "BCDA",
                    "alId": "ALFNDPF000153786",
                    "organizationExternalId": "ALT",
                    "accountNumber": "ALT355566",
                    "lastTransactionId": "63e1c252-a23c-42af-a7f2-f48a2893c940"
                },
                "managed": true
            },
            "oracle": {
                "onchain": {
                    "id": "6YaAdbMCV5GPRZ6AYbyEnGgggAHfEJjXTXYGrDVasQHK",
                    "lastTransactionId": "5vnjT6E19V4uQwHMojaR73XFoPjt9Y2nFn74xdDJZTK1MYScNWHpf876JFnSVzSqLxzEMLyzH355WWoiFN5ceMa9",
                    "lastTransactionAt": "2025-09-11T20:22:54.531 +0200"
                },
                "offchain": {
                    "id": "b3e30f57-b404-4bd5-9e31-cec3298fa0bf",
                    "type": "WALLET",
                    "code": "BCDA",
                    "alId": "ALFNDPF000153786",
                    "organizationExternalId": "ALT",
                    "accountNumber": "ALT355566",
                    "lastTransactionId": "63e1c252-a23c-42af-a7f2-f48a2893c940"
                },
                "managed": true
            }
        }
    ],
    "defiProtocol": "LOOPSCALE"
}
Modified at 2025-12-05 08:59:24
Previous
Create Loan
Next
Fetch Loans
Built with