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 Oracle Data Sources

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/bulk
Creates Solana Transaction:No
OperationId:fetchOracleDataSources
Fetches a list of onchain data sources based on the provided query.
Usage example can be found here.

Filter & Sort Options#

Allowed values in the fieldName for sortModel and filterModel:
fieldNamedataTypedescriptionfiltersort
defiProtocolTEXTThe oracle defi protocol
dataTypeTEXTThe type of data associated with the data source: PRICE or RATING (ASC)*
ratingAgencyTEXTThe rating agency associated with the data source - applicable only to ratings data sources
onchainDataSourceOffchainIdOFFCHAIN_IDThe offchainId for the Onchain Data Source Account
onchainDataSourceOnchainIdADDRESS_ONCHAIN_IDThe onchainId for the Onchain Data Source Account
financialInstrumentOffchainIdOFFCHAIN_IDThe offchainId for the Financial Instrument associated with the data source
financialInstrumentOnchainIdADDRESS_ONCHAIN_IDThe onchainId for the Financial Instrument associated with the data source
onchainDataSourceAuthorityOffchainIdOFFCHAIN_IDThe offchainId for the Authority associated with the data source
onchainDataSourceAuthorityOnchainIdADDRESS_ONCHAIN_IDThe onchainId for the Authority associated with the data source
(ASC|DESC)* - columns that are part of the default sort if no itemQuery.sortModel is provided.

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
🟠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/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": {
        "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
Fetch Onchain Data Source Details
Next
DKG Key Setup
Built with