GET

/Investment/Price

When to Use

  • Retrieve current NAV and unit prices for processing deposits, redemptions, and transfers
  • Access current and historical pricing data for portfolio valuations and statements
  • Extract historical price series for performance calculations and return analysis
  • Obtain ex-distribution pricing (ExPrice, ExNAV) for distribution calculations

Prerequisites

  • InvestmentID or ExternalInvestmentId with ProductID/ExternalProductId

Considerations

  • Price data availability depends on market schedules and fund valuation cycles
  • Date range queries should use narrow ranges for performance
  • NAV vs Price distinction is critical for accurate transaction processing
  • ExPrice and ExRedemptionPrice reflect distribution adjustments and may differ significantly during distribution periods

Description

Retrieves investment pricing data with comprehensive filtering options. Returns NAV, unit prices, redemption prices, management fees, and related pricing components used for transaction processing and valuations.

Price Types

  • Price - Standard unit price for purchases
  • RedemptionPrice - Price for redemptions/withdrawals
  • NAV - Net Asset Value per unit
  • ExPrice - Ex-distribution price
  • ExNAV - Ex-distribution Net Asset Value
  • Cost - Total cost including fees

Required Headers - See Authentication

HeaderValueDescription
Authorization{accessToken}Bearer token for API access
Version2.0API version identifier

Query Parameters

Parameter Type Required Description
InvestmentID
integer
Optional
Native investment identifier (returns all price records unless filtered by date).
ExternalInvestmentId
string
Optional
External investment identifier (requires ProductID or ExternalProductId).
PriceDate
date
Optional
Specific date to retrieve pricing (YYYY-MM-DD format).
FromPriceDate
date
Optional
Start date for price history range (YYYY-MM-DD format, use with ToPriceDate).
ToPriceDate
date
Optional
End date for price history range (YYYY-MM-DD format).
ProductID
integer
Optional
Native product identifier (required when using ExternalInvestmentId).
ExternalProductId
string
Optional
External product identifier (alternative to ProductID, use with ExternalInvestmentId).
InvestmentID
integer
Optional
Native investment identifier (returns all price records unless filtered by date).
ExternalInvestmentId
string
Optional
External investment identifier (requires ProductID or ExternalProductId).
PriceDate
date
Optional
Specific date to retrieve pricing (YYYY-MM-DD format).
FromPriceDate
date
Optional
Start date for price history range (YYYY-MM-DD format, use with ToPriceDate).
ToPriceDate
date
Optional
End date for price history range (YYYY-MM-DD format).
ProductID
integer
Optional
Native product identifier (required when using ExternalInvestmentId).
ExternalProductId
string
Optional
External product identifier (alternative to ProductID, use with ExternalInvestmentId).

Parameter Options

Investment identification (choose one):

  • Option 1: investmentID only
  • Option 2: externalInvestmentId + productID
  • Option 3: externalInvestmentId + externalProductID

Date filtering (optional):

  • Specific Date: priceDate only
  • Date Range: fromPriceDate + toPriceDate
  • All Historical: No date parameters

Example Requests

bash
# Get current price for investment
curl -X GET https://api.7g.com.au/Investment/Price?InvestmentID=12345 \
  -H "Authorization: {accessToken}" \
  -H "Version: 2.0"

# Get specific date pricing
curl -X GET "https://api.7g.com.au/Investment/Price?InvestmentID=12345&PriceDate=2025-08-16" \
  -H "Authorization: {accessToken}" \
  -H "Version: 2.0"

# Get price history range
curl -X GET "https://api.7g.com.au/Investment/Price?ExternalInvestmentId=INV-001&ExternalProductId=FUND-001&FromPriceDate=2025-01-01&ToPriceDate=2025-08-16" \
  -H "Authorization: {accessToken}" \
  -H "Version: 2.0"

# Get price using external investment ID and product ID
curl -X GET "https://api.7g.com.au/Investment/Price?ExternalInvestmentId=INV-001&ProductID=100" \
  -H "Authorization: {accessToken}" \
  -H "Version: 2.0"

Response Examples

json
{
  "result": true,
  "message": null,
  "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"
    }
  ]
}