Update Position

Testing

Development

https://vf-solana-api.dev.alphaledger.com

PATCH

/api/v1/positions

Creates Solana Transaction:No

OperationId:udpatePosition

Endpoint to be used for changing offchain attributes associated with the position. If an attribute is specified in the request body, the value of that field will be changed. Atribtues that are not specified will have the same values they had before.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Body Params application/xml

Examples

Responses

🟢200Success

application/json

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://vf-solana-api.dev.alphaledger.com/api/v1/positions?solanaClusterId=SOLANA_DEVNET' \
--header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/xml' \
--data-raw '<?xml version="1.0" encoding="UTF-8"?>
<root>
  <itemData>
    <position>
      <position>
        <onchainId>GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton</onchainId>
        <offchainId>1b03ae9a-348c-4c18-8727-20c7c4ae7a0a</offchainId>
        <offchainReferences>
          <alId>ALFNDPF000153778</alId>
          <organizationExternalId>ALT</organizationExternalId>
          <accountNumber>ALT10000233</accountNumber>
          <code>some-authority</code>
          <type>WALLET</type>
        </offchainReferences>
        <autoSign>true</autoSign>
        <otherTenantOrganizationExternalId>ALIM</otherTenantOrganizationExternalId>
        <offPlatform>false</offPlatform>
      </position>
      <owner>
        <onchainId>GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton</onchainId>
        <offchainId>1b03ae9a-348c-4c18-8727-20c7c4ae7a0a</offchainId>
        <offchainReferences>
          <alId>ALFNDPF000153778</alId>
          <organizationExternalId>ALT</organizationExternalId>
          <accountNumber>ALT10000233</accountNumber>
          <code>some-authority</code>
          <type>WALLET</type>
        </offchainReferences>
        <autoSign>true</autoSign>
        <otherTenantOrganizationExternalId>ALIM</otherTenantOrganizationExternalId>
        <offPlatform>false</offPlatform>
      </owner>
      <financialInstrument>
        <onchainId>GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton</onchainId>
        <offchainId>1b03ae9a-348c-4c18-8727-20c7c4ae7a0a</offchainId>
        <offchainReferences>
          <alId>ALFNDPF000153778</alId>
          <organizationExternalId>ALT</organizationExternalId>
          <accountNumber>ALT10000233</accountNumber>
          <code>some-authority</code>
          <type>WALLET</type>
        </offchainReferences>
        <autoSign>true</autoSign>
        <otherTenantOrganizationExternalId>ALIM</otherTenantOrganizationExternalId>
        <offPlatform>false</offPlatform>
      </financialInstrument>
      <mintAuthority>
        <onchainId>GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton</onchainId>
        <offchainId>1b03ae9a-348c-4c18-8727-20c7c4ae7a0a</offchainId>
        <offchainReferences>
          <alId>ALFNDPF000153778</alId>
          <organizationExternalId>ALT</organizationExternalId>
          <accountNumber>ALT10000233</accountNumber>
          <code>some-authority</code>
          <type>WALLET</type>
        </offchainReferences>
        <autoSign>true</autoSign>
        <otherTenantOrganizationExternalId>ALIM</otherTenantOrganizationExternalId>
        <offPlatform>false</offPlatform>
      </mintAuthority>
      <freezeAuthority>
        <onchainId>GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton</onchainId>
        <offchainId>1b03ae9a-348c-4c18-8727-20c7c4ae7a0a</offchainId>
        <offchainReferences>
          <alId>ALFNDPF000153778</alId>
          <organizationExternalId>ALT</organizationExternalId>
          <accountNumber>ALT10000233</accountNumber>
          <code>some-authority</code>
          <type>WALLET</type>
        </offchainReferences>
        <autoSign>true</autoSign>
        <otherTenantOrganizationExternalId>ALIM</otherTenantOrganizationExternalId>
        <offPlatform>false</offPlatform>
      </freezeAuthority>
    </position>
    <debitApiKeys>
      <debitApiKeys>string</debitApiKeys>
    </debitApiKeys>
    <debitLimits>
      <debitLimits>
        <applicableTo>TOKEN</applicableTo>
        <operationType>ANY</operationType>
        <destination>ANY</destination>
        <mintAuthority>ANY</mintAuthority>
        <maxAllowedDebit>
          <limitType>PER_OPERATION</limitType>
          <limitAmount>100</limitAmount>
          <duration>
            <code>DAYS</code>
            <unit>1</unit>
          </duration>
          <approversForOverride>
            <approversForOverride>string</approversForOverride>
          </approversForOverride>
          <requiredApproversCount>2</requiredApproversCount>
        </maxAllowedDebit>
      </debitLimits>
    </debitLimits>
  </itemData>
  <solanaTransactionConfig>
    <feePayer>
      <onchainId>GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton</onchainId>
      <offchainId>1b03ae9a-348c-4c18-8727-20c7c4ae7a0a</offchainId>
      <offchainReferences>
        <alId>ALFNDPF000153778</alId>
        <organizationExternalId>ALT</organizationExternalId>
        <accountNumber>ALT10000233</accountNumber>
        <code>some-authority</code>
        <type>WALLET</type>
      </offchainReferences>
      <autoSign>true</autoSign>
      <otherTenantOrganizationExternalId>ALIM</otherTenantOrganizationExternalId>
      <offPlatform>false</offPlatform>
    </feePayer>
    <computeUnitConfig>
      <enable>true</enable>
      <limit>1400000</limit>
      <price>35000</price>
      <priceEstimate>
        <provider>HELIUS</provider>
        <calculationStrategy>DEFAULT</calculationStrategy>
        <priorityLevel>RECOMMENDED</priorityLevel>
      </priceEstimate>
    </computeUnitConfig>
    <commitmentConfig>
      <commitmentLevel>processed</commitmentLevel>
    </commitmentConfig>
    <messageLifetimeStrategy>RECENT_BLOCKHASH</messageLifetimeStrategy>
    <transactionVersion>V0</transactionVersion>
  </solanaTransactionConfig>
  <tenancyConfig>
    <overrideOrganizationExternalId>ALIM</overrideOrganizationExternalId>
  </tenancyConfig>
</root>'

Response Example

200 - Example 1

{
    "onchainId": "ndA7eTfoWqrczXYUq53gNRRjQgEmufqErXbgXUFFUAA",
    "offchainId": "1a1e904d-0d95-4e66-85e1-88a57774e910"
}

Modified at 2026-01-23 11:25:07

Initialize Position

Close Position