PUT

/Investment/Price

When to Use

  • Fix NAV calculation errors, data feed issues, or manual entry mistakes
  • Update pricing after fund administrator NAV recalculations or valuation corrections
  • Update ExPrice, ExNAV, and ExRedemptionPrice after distribution calculation refinements
  • Correct term deposit or bond interest rates

Prerequisites

  • Price record must exist for the specified investment and PriceDate

Considerations

  • Price updates affect all transactions using this pricing
  • PUT replaces ALL price components (missing optional fields will be set to null)
  • Price updates immediately flow to portfolio valuations in real-time
  • Updated prices must comply with investment's NoOfDecimalPlaces configuration
  • Some platforms restrict price updates after transactions processed or reporting periods closed

Description

Updates existing investment price records with complete replacement of all pricing components. This endpoint performs comprehensive validation to ensure changes maintain price integrity and comply with business rules.

Required Headers - See Authentication

HeaderValueDescription
Content-Typeapplication/jsonRequest content type
Authorization{accessToken}Bearer token for API access
Version2.0API version identifier

Request Body

Parameter Type Required Description
ProductID >
integer
Parent product identifier for validation (must match existing price record's product, cannot be changed during update).
ExternalProductId
 string
Optional
External product identifier for cross-system correlation (must match existing record if previously set).
InvestmentID >
integer
Native investment identifier specifying which investment's pricing is being updated (together with PriceDate, identifies the price record).
ExternalInvestmentId
 string
Optional
External investment identifier for cross-system correlation (must match existing record if previously set).
Cost
 decimal
Optional
Total cost per unit including transaction expenses and fees (used for cost-basis calculations and tax reporting).
IndirectCost
 decimal
Optional
Indirect cost component per unit for embedded expenses (platform fees, custody costs, used for fee disclosure).
IndirectFee
 decimal
Optional
Indirect fee component per unit for embedded fees (performance fees, platform fees, used for PDS fee disclosure).
ExNAV
 decimal
Optional
Ex-distribution Net Asset Value after distribution deduction (required for Distribution processing workflows).
ExPrice
 decimal
Optional
Ex-distribution unit price for purchases after distribution cutoff (typically Price minus per-unit distribution amount).
ExRedemptionPrice
 decimal
Optional
Ex-distribution redemption price for withdrawals after distribution cutoff (typically RedemptionPrice minus per-unit distribution).
InterestRate
 decimal
Optional
Interest rate percentage for term deposits and bonds (e.g., 5.25 = 5.25% p.a., used for interest calculations).
ManagementFeePerUnit
 decimal
Optional
Management fee charged per unit for this pricing period (used for fee disclosure on investor statements).
NAV
 decimal
Optional
Net Asset Value per unit representing underlying asset value (typically basis for Price and RedemptionPrice calculations).
NetGainLossPerUnitExcelManagementFee
 decimal
Optional
Net gain/loss per unit excluding management fees (used for performance reporting and fee analysis).
Price >
decimal
Standard unit price for BizTransaction deposit operations (must comply with investment's NoOfDecimalPlaces precision, immediately affects new transactions).
PriceDate >
date
Effective date identifying the price record being updated (YYYY-MM-DD format, cannot be changed - use DELETE + POST to change dates).
RedemptionPrice >
decimal
Unit price for BizTransaction redemption operations (must comply with investment's NoOfDecimalPlaces precision).
UpdatedDate
 datetime
Optional
Timestamp when price record was last updated (ISO 8601 format, defaults to current UTC time if not provided).
ProductID
integer
Parent product identifier for validation (must match existing price record's product, cannot be changed during update).
ExternalProductId
string
Optional
External product identifier for cross-system correlation (must match existing record if previously set).
InvestmentID
integer
Native investment identifier specifying which investment's pricing is being updated (together with PriceDate, identifies the price record).
ExternalInvestmentId
string
Optional
External investment identifier for cross-system correlation (must match existing record if previously set).
Cost
decimal
Optional
Total cost per unit including transaction expenses and fees (used for cost-basis calculations and tax reporting).
IndirectCost
decimal
Optional
Indirect cost component per unit for embedded expenses (platform fees, custody costs, used for fee disclosure).
IndirectFee
decimal
Optional
Indirect fee component per unit for embedded fees (performance fees, platform fees, used for PDS fee disclosure).
ExNAV
decimal
Optional
Ex-distribution Net Asset Value after distribution deduction (required for Distribution processing workflows).
ExPrice
decimal
Optional
Ex-distribution unit price for purchases after distribution cutoff (typically Price minus per-unit distribution amount).
ExRedemptionPrice
decimal
Optional
Ex-distribution redemption price for withdrawals after distribution cutoff (typically RedemptionPrice minus per-unit distribution).
InterestRate
decimal
Optional
Interest rate percentage for term deposits and bonds (e.g., 5.25 = 5.25% p.a., used for interest calculations).
ManagementFeePerUnit
decimal
Optional
Management fee charged per unit for this pricing period (used for fee disclosure on investor statements).
NAV
decimal
Optional
Net Asset Value per unit representing underlying asset value (typically basis for Price and RedemptionPrice calculations).
NetGainLossPerUnitExcelManagementFee
decimal
Optional
Net gain/loss per unit excluding management fees (used for performance reporting and fee analysis).
Price
decimal
Standard unit price for BizTransaction deposit operations (must comply with investment's NoOfDecimalPlaces precision, immediately affects new transactions).
PriceDate
date
Effective date identifying the price record being updated (YYYY-MM-DD format, cannot be changed - use DELETE + POST to change dates).
RedemptionPrice
decimal
Unit price for BizTransaction redemption operations (must comply with investment's NoOfDecimalPlaces precision).
UpdatedDate
datetime
Optional
Timestamp when price record was last updated (ISO 8601 format, defaults to current UTC time if not provided).

Complete Replacement Update

PUT operations require all fields to be provided:

  • Investment & Product IDs: Must match the existing price record
  • PriceDate: Must match the record being updated
  • All pricing fields: Will be replaced with provided values
Important: Missing optional fields will be set to null.

Example Requests

json
{
  "ProductID": 100,
  "ExternalProductId": "FUND-001",
  "InvestmentID": 12345,
  "ExternalInvestmentId": "INV-001",
  "Cost": 1.0130,
  "IndirectCost": 0.0025,
  "IndirectFee": 0.0050,
  "ExNAV": 0.9880,
  "ExPrice": 0.9905,
  "ExRedemptionPrice": 0.9855,
  "InterestRate": 5.25,
  "ManagementFeePerUnit": 0.0075,
  "NAV": 1.0005,
  "NetGainLossPerUnitExcelManagementFee": 0.0455,
  "Price": 1.0030,
  "PriceDate": "2025-08-16",
  "RedemptionPrice": 0.9980,
  "UpdatedDate": "2025-08-16T14:30:00Z"
}

Response Examples

json
{
  "result": true,
  "message": "Investment price updated successfully",
  "recordCount": 1,
  "data": {
    "productID": 100,
    "externalProductId": "FUND-001",
    "investmentID": 12345,
    "externalInvestmentId": "INV-001",
    "cost": 1.0130,
    "indirectCost": 0.0025,
    "indirectFee": 0.0050,
    "exNAV": 0.9880,
    "exPrice": 0.9905,
    "exRedemptionPrice": 0.9855,
    "interestRate": 5.25,
    "managementFeePerUnit": 0.0075,
    "nav": 1.0005,
    "netGainLossPerUnitExcelManagementFee": 0.0455,
    "price": 1.0030,
    "priceDate": "2025-08-16",
    "redemptionPrice": 0.9980,
    "updatedDate": "2025-08-16T14:30:00Z"
  }
}
GET Get InvestmentPrice DELETE Delete InvestmentPrice GET Get Investments