POST

/Investment/Price

When to Use

  • Daily NAV Upload: Create daily pricing snapshots from fund administrator systems for managed fund NAV and unit price updates
  • Market Data Integration: Load pricing from external data providers (Bloomberg, Reuters, IRESS) for direct investment holdings
  • Historical Price Loading: Create backdated price records for transaction processing, portfolio valuations, or data migration scenarios
  • Product Launch Pricing: Set initial pricing for newly launched investment products before first investor transactions
  • Distribution Processing: Record ex-distribution pricing (ExPrice, ExNAV) for distribution payment workflows and unit price adjustments
  • Term Deposit Pricing: Create pricing records with interest rates for term deposit products and fixed-income instruments

Common Scenarios

  • End-of-Day NAV Processing: Upload daily NAV and unit prices from fund administrator after market close and valuation calculations
  • External Data Feed Integration: Create pricing records from automated feeds for listed securities, term deposits, or bond holdings
  • Ex-Distribution Price Recording: Set ExPrice and ExNAV for distribution payment dates to reflect distribution impact on unit prices
  • Backdated Transaction Support: Load historical pricing to enable processing of backdated deposits or redemptions with accurate valuations

Prerequisites

  • Valid Bearer token with investment price creation permissions and pricing data management access
  • Investment product must exist in 7G system - create via POST /Investment first before creating price records
  • Understanding of investment's NoOfDecimalPlaces setting for pricing precision requirements and validation rules
  • Knowledge of price types and their specific transaction processing impacts (Price for deposits, RedemptionPrice for withdrawals)
  • Pricing committee approval for manual price entries or adjustments outside automated data feeds
  • Awareness of date constraints - pricing dates cannot be in the future and must be unique per investment

Important Considerations

⚠️ Pricing Data Accuracy and Compliance

  • Date Constraints: PriceDate cannot be in the future - system rejects future-dated pricing. Must be unique per investment (use PUT to update existing date pricing)
  • Decimal Precision Compliance: Price values must match investment's NoOfDecimalPlaces configuration - mismatches cause transaction calculation errors
  • Mandatory Fields: Price, RedemptionPrice, and PriceDate are required - missing values cause validation failures
  • Portfolio Impact: Price creation immediately affects BizEntity Account Holdings displays and portfolio valuations for all investors
  • Transaction Dependencies: Transactions require pricing for effective date - missing pricing causes transaction validation failures
  • Audit Trail Permanence: Price records become part of regulatory audit trail - ensure accuracy before creation as changes require PUT operations

Description

Creates new investment price records within the 7G platform. Price records are used for transaction processing, portfolio valuations, and regulatory reporting. Each record must specify a unique combination of investment and price date.

Price Record Components

  • Price: Standard unit price for purchases (mandatory)
  • RedemptionPrice: Price for redemptions (mandatory)
  • NAV: Net Asset Value per unit
  • Cost: Total cost including direct expenses
  • Management Fees: Per-unit management fee component

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 linking price record to product hierarchy (system validates match with Investment's parent product).
ExternalProductId
 string
Optional
External product identifier for cross-system correlation (must match product's ExternalProductId if provided).
InvestmentID >
integer
Native investment identifier specifying which investment this pricing applies to (all BizTransaction operations on PriceDate use this pricing).
ExternalInvestmentId
 string
Optional
External investment identifier for cross-system correlation (must match investment's ExternalInvestmentId if provided).
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).
PriceDate >
date
Effective date for this pricing record (YYYY-MM-DD format, cannot be future-dated, must be unique per investment).
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 linking price record to product hierarchy (system validates match with Investment's parent product).
ExternalProductId
string
Optional
External product identifier for cross-system correlation (must match product's ExternalProductId if provided).
InvestmentID
integer
Native investment identifier specifying which investment this pricing applies to (all BizTransaction operations on PriceDate use this pricing).
ExternalInvestmentId
string
Optional
External investment identifier for cross-system correlation (must match investment's ExternalInvestmentId if provided).
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).
PriceDate
date
Effective date for this pricing record (YYYY-MM-DD format, cannot be future-dated, must be unique per investment).
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).

Price Accuracy

Ensure price precision matches investment configuration:

  • Decimal Places: Use investment's NoOfDecimalPlaces setting
  • Rounding: Apply investment's RoundingMethodID consistently
  • Validation: Cross-check NAV calculations
Important: Incorrect pricing affects all transactions and holdings.

Example Requests

json
{
  "ProductID": 100,
  "ExternalProductId": "FUND-001",
  "InvestmentID": 12345,
  "ExternalInvestmentId": "INV-001",
  "Cost": 1.0125,
  "IndirectCost": 0.0025,
  "IndirectFee": 0.0050,
  "ExNAV": 0.9875,
  "ExPrice": 0.9900,
  "ExRedemptionPrice": 0.9850,
  "InterestRate": 5.25,
  "ManagementFeePerUnit": 0.0075,
  "NAV": 1.0000,
  "NetGainLossPerUnitExcelManagementFee": 0.0450,
  "Price": 1.0025,
  "PriceDate": "2025-08-16",
  "RedemptionPrice": 0.9975,
  "UpdatedDate": "2025-08-16T09:30:00Z"
}

Response Examples

json
{
  "result": true,
  "message": "Investment price created successfully",
  "recordCount": 1,
  "data": {
    "productID": 100,
    "externalProductId": "FUND-001",
    "investmentID": 12345,
    "externalInvestmentId": "INV-001",
    "cost": 1.0125,
    "indirectCost": 0.0025,
    "indirectFee": 0.0050,
    "exNAV": 0.9875,
    "exPrice": 0.9900,
    "exRedemptionPrice": 0.9850,
    "interestRate": 5.25,
    "managementFeePerUnit": 0.0075,
    "nav": 1.0000,
    "netGainLossPerUnitExcelManagementFee": 0.0450,
    "price": 1.0025,
    "priceDate": "2025-08-16",
    "redemptionPrice": 0.9975,
    "updatedDate": "2025-08-16T09:30:00Z"
  }
}
GET Get investment prices PUT Update investment prices GET Get investments