Vulcan Forge
  1. Onchain Data Sources
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
      • 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
      • Onchain Data Sources
        • Create Onchain Data Source
          POST
        • Update Oracle Data Source Definition
          PATCH
        • Refresh Oracle Data Source
          PATCH
        • Fetch Onchain Data Source Details
          POST
        • Fetch Oracle Data Sources
          POST
  • 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 Onchain Compact
        • Account Response Compact
      • Transactions
        • Solana Transaction Result
        • Solana Entity Result
      • Positions
        • Position Offchain Result
      • Market Data
        • Onchain Data Source Response
    • Positions
      • Position Lookup
      • Transfer SOL Definition
      • Transfer Financial Instrument Definition
      • Burn Definition
      • Mint Definition
      • Position Balance
    • Loans
      • Loan Duration
    • Market Data
      • Onchain Data Source Details
      • Switchboard details
  1. Onchain Data Sources

Fetch Onchain Data Source Details

Testing
Development
https://vf-solana-api.dev.alphaledger.com
Development
https://vf-solana-api.dev.alphaledger.com
POST
/api/v1/market-data/onchain-data-source/single
Creates Solana Transaction:No
OperationId:fetchOnchainDataSourceDetails
Fetches the details for a single onchain data source.

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

🟢200Updated
application/json
Body

🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠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/market-data/onchain-data-source/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": {
        "onchainDataSource": {
            "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
{
    "defiProtocol": "SWITCHBOARD",
    "onchainDataSource": {
        "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,
        "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"
    },
    "financialInstrument": {
        "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,
        "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"
    },
    "onchainDataSourceAuthority": {
        "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,
        "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"
    },
    "dataDetails": {
        "kind": "PRICE",
        "ratingProvider": "string"
    },
    "switchboardDetails": {
        "kind": "QUOTES",
        "jobDefinition": "string"
    }
}
Modified at 2025-12-10 12:32:29
Previous
Refresh Oracle Data Source
Next
Fetch Oracle Data Sources
Built with