Fetch Loans
Designing
Development
https://vf-solana-api.dev.alphaledger.com
Development
https://vf-solana-api.dev.alphaledger.com
POST
/api/v1/loans/bulk
Creates Solana Transaction:No
OperationId:fetchLoans
Filter & Sort Options
| fieldName | dataType | description | filter | sort |
|---|---|---|---|---|
| status | TEXT | Indicates if the loan is ACTIVE or CLOSED | (ASC)** | |
| escrowOnchainId | ONCHAIN_ADDRESS_ID | The onchain id for the escrow account | ||
| escrowOffchainId | OFFCHAIN_ID | The offchain id for the escrow account | ||
| borrowerOnchainId | ONCHAIN_ADDRESS_ID | The onchain id for the borrower account | ||
| borrowerOffchainId | OFFCHAIN_ID | The offchain id for the borrower account | ||
| lenderOnchainId | ONCHAIN_ADDRESS_ID | The onchain id for the lender account | ||
| lenderOffchainId | OFFCHAIN_ID | The offchain id for the lender account | ||
| pledgedItemOnchainId | ONCHAIN_ADDRESS_ID | The onchain id for one of the pledged items accounts | ||
| pledgedItemOffchainId | OFFCHAIN_ID | The offchain id for one of the pledged items accounts | ||
| pledgedItemAmount | NUMBER | The amount ot tokens pledged | ||
| borrowedItemOnchainId | ONCHAIN_ADDRESS_ID | The onchain id for one of the pledged items accounts | ||
| borrowedItemOffchainId | OFFCHAIN_ID | The offchain id for one of the pledged items accounts | ||
| borrowedItemDueAmount | NUMBER | The due amount of tokens borrowed | ||
| loanDurationCode | TEXT | The loan duration code | ||
| loanDurationUnit | NUMBER | The loan duration unit |
* - indicates columns that are nullable and can use the IS_NULL or IS_NOT_NULL type
Request
Query Params
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://vf-solana-api.dev.alphaledger.com/api/v1/loans/bulk?solanaClusterId=SOLANA_DEVNET' \
--header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"itemQuery": {
"limit": 10,
"skip": 0,
"filter": [
{
"fieldName": "See the endpoint description for allowed values",
"operator": "AND",
"filterValues": [
{
"dataType": "TEXT",
"filterType": "EQUALS",
"valueString": "string",
"valueNumber": 0,
"valueBoolean": true,
"valuesString": [
"string"
],
"valueFromString": "string",
"valueToString": "string",
"valueFromNumber": 0,
"valueToNumber": 0
}
]
}
],
"sort": [
{
"fieldName": "See the endpoint description for allowed values",
"sortDirection": "ASC"
}
]
},
"tenancyConfig": {
"overrideOrganizationExternalId": "ALIM"
}
}'Response Response Example
200 - Example 1
{
"count": 17,
"items": [
{
"status": "OPEN",
"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"
},
"managed": true,
"status": "ACTIVE",
"privateKeyLocation": [
"SECRETS"
],
"isDerived": true,
"comments": "Some comments attached to the account",
"subscribeToNetworkEvents": true,
"sharedAcrossTenants": true,
"wasOnchainAlready": true,
"canPayFees": true,
"globalFeePayerForOrgs": [
"string"
],
"solDebitApiKeys": [
"string"
],
"tokenDebitApiKeys": [
"string"
],
"domain": "string",
"tenantOrganizationId": "ALG"
},
"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"
},
"managed": true,
"status": "ACTIVE",
"privateKeyLocation": [
"SECRETS"
],
"isDerived": true,
"comments": "Some comments attached to the account",
"subscribeToNetworkEvents": true,
"sharedAcrossTenants": true,
"wasOnchainAlready": true,
"canPayFees": true,
"globalFeePayerForOrgs": [
"string"
],
"solDebitApiKeys": [
"string"
],
"tokenDebitApiKeys": [
"string"
],
"domain": "string",
"tenantOrganizationId": "ALG"
},
"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"
},
"managed": true,
"status": "ACTIVE",
"privateKeyLocation": [
"SECRETS"
],
"isDerived": true,
"comments": "Some comments attached to the account",
"subscribeToNetworkEvents": true,
"sharedAcrossTenants": true,
"wasOnchainAlready": true,
"canPayFees": true,
"globalFeePayerForOrgs": [
"string"
],
"solDebitApiKeys": [
"string"
],
"tokenDebitApiKeys": [
"string"
],
"domain": "string",
"tenantOrganizationId": "ALG"
},
"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"
},
"managed": true,
"status": "ACTIVE",
"privateKeyLocation": [
"SECRETS"
],
"isDerived": true,
"comments": "Some comments attached to the account",
"subscribeToNetworkEvents": true,
"sharedAcrossTenants": true,
"wasOnchainAlready": true,
"canPayFees": true,
"globalFeePayerForOrgs": [
"string"
],
"solDebitApiKeys": [
"string"
],
"tokenDebitApiKeys": [
"string"
],
"domain": "string",
"tenantOrganizationId": "ALG"
}
}
],
"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"
},
"managed": true,
"status": "ACTIVE",
"privateKeyLocation": [
"SECRETS"
],
"isDerived": true,
"comments": "Some comments attached to the account",
"subscribeToNetworkEvents": true,
"sharedAcrossTenants": true,
"wasOnchainAlready": true,
"canPayFees": true,
"globalFeePayerForOrgs": [
"string"
],
"solDebitApiKeys": [
"string"
],
"tokenDebitApiKeys": [
"string"
],
"domain": "string",
"tenantOrganizationId": "ALG"
}
}
],
"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,
"status": "ACTIVE",
"tenantOrganizationId": "ALG"
},
"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,
"status": "ACTIVE",
"tenantOrganizationId": "ALG"
}
}
],
"defiProtocol": "LOOPSCALE"
}
]
}Modified at 2026-01-05 06:55:24