POST
/Investment/Price
When to Use
- Create daily pricing snapshots from fund administrator systems
- Load pricing from external data providers for direct investments
- Set initial pricing for newly launched investment products
- Record ex-distribution pricing (ExPrice, ExNAV) for distribution workflows
Prerequisites
- Investment product must exist (create via POST /Investment first)
Considerations
- PriceDate cannot be in future and must be unique per investment
- Price values must match investment's NoOfDecimalPlaces configuration
- Price, RedemptionPrice, and PriceDate are required fields
- Price creation immediately affects portfolio valuations for all investors
- Transactions require pricing for effective date to succeed
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
| Header | Value | Description |
|---|---|---|
| Content-Type | application/json | Request content type |
| Authorization | {accessToken} | Bearer token for API access |
| Version | 2.0 | API version identifier |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
ProductID |
integer | Parent product identifier linking price record to product hierarchy. | |
ExternalProductId |
string | Optional |
External product identifier for cross-system correlation. |
InvestmentID |
integer | Native investment identifier for this pricing record. | |
ExternalInvestmentId |
string | Optional |
External investment identifier for cross-system correlation. |
Cost |
decimal | Optional |
Total cost per unit including expenses and fees. |
IndirectCost |
decimal | Optional |
Indirect cost component per unit. |
IndirectFee |
decimal | Optional |
Indirect fee component per unit. |
ExNAV |
decimal | Optional |
Ex-distribution Net Asset Value (required for distribution processing). |
ExPrice |
decimal | Optional |
Ex-distribution unit price for purchases after distribution cutoff. |
ExRedemptionPrice |
decimal | Optional |
Ex-distribution redemption price for withdrawals after distribution cutoff. |
InterestRate |
decimal | Optional |
Interest rate percentage for term deposits and bonds (e.g., 5.25 = 5.25% p.a.). |
ManagementFeePerUnit |
decimal | Optional |
Management fee charged per unit for this pricing period. |
NAV |
decimal | Optional |
Net Asset Value per unit. |
NetGainLossPerUnitExcelManagementFee |
decimal | Optional |
Net gain/loss per unit excluding management fees. |
Price |
decimal | Standard unit price for deposit operations (must match 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 redemption operations (must match investment's NoOfDecimalPlaces precision). | |
UpdatedDate |
datetime | Optional |
Timestamp when price record was last updated (ISO 8601 format). |
ProductID
Parent product identifier linking price record to product hierarchy.
ExternalProductId
External product identifier for cross-system correlation.
InvestmentID
Native investment identifier for this pricing record.
ExternalInvestmentId
External investment identifier for cross-system correlation.
Cost
Total cost per unit including expenses and fees.
IndirectCost
Indirect cost component per unit.
IndirectFee
Indirect fee component per unit.
ExNAV
Ex-distribution Net Asset Value (required for distribution processing).
ExPrice
Ex-distribution unit price for purchases after distribution cutoff.
ExRedemptionPrice
Ex-distribution redemption price for withdrawals after distribution cutoff.
InterestRate
Interest rate percentage for term deposits and bonds (e.g., 5.25 = 5.25% p.a.).
ManagementFeePerUnit
Management fee charged per unit for this pricing period.
NAV
Net Asset Value per unit.
NetGainLossPerUnitExcelManagementFee
Net gain/loss per unit excluding management fees.
Price
Standard unit price for deposit operations (must match investment's NoOfDecimalPlaces precision).
PriceDate
Effective date for this pricing record (YYYY-MM-DD format, cannot be future-dated, must be unique per investment).
RedemptionPrice
Unit price for redemption operations (must match investment's NoOfDecimalPlaces precision).
UpdatedDate
Timestamp when price record was last updated (ISO 8601 format).
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"
}
}