GET

/Investment/Price

When to Use

  • Transaction Pricing: Retrieve current NAV and unit prices for processing investment deposits, redemptions, and transfer transactions
  • Portfolio Valuations: Access current and historical pricing data for calculating portfolio values and investor statement balances
  • Performance Analytics: Extract historical price series for investment performance calculations, benchmark comparisons, and return analysis
  • Distribution Processing: Obtain ex-distribution pricing (ExPrice, ExNAV) for accurate distribution calculations and unit price adjustments
  • Compliance Reporting: Retrieve pricing data for regulatory submissions, audit requirements, and external reporting obligations
  • Client Reporting: Access pricing information for investor statements, tax reporting documents, and performance summaries

Common Scenarios

  • Current Price Lookup: Use InvestmentID=12345 with current date for transaction processing
  • Historical Price Analysis: Use PriceDate filtering for specific date ranges and price trend analysis
  • Ex-Distribution Pricing: Retrieve ExPrice and ExNAV values for distribution processing workflows
  • NAV Reconciliation: Compare CurrentNAV with ExNAV for distribution impact validation
  • Price Series Extraction: Use date-based filtering for performance calculation datasets

Prerequisites

  • Valid Bearer token with investment price read permissions and appropriate data access scope for pricing information
  • Knowledge of investment identifiers (InvestmentID recommended) or external system references (ExternalInvestmentId) for target investments
  • Understanding of price date significance and business day conventions for accurate historical price retrieval
  • Familiarity with Australian managed fund pricing cycles and NAV calculation methodologies for effective data interpretation
  • Knowledge of distribution payment dates and ex-distribution periods for understanding price adjustments and timing
  • Awareness of price types and their specific uses in different transaction and valuation scenarios

Important Considerations

⚠️ Pricing Data Timing and Accuracy

  • Market Schedule Dependencies: Price data availability depends on market schedules and fund valuation cycles - may be delayed during market holidays or fund suspension periods
  • Performance Impact: Date range queries returning multiple records require careful performance consideration - use narrow date ranges for large datasets
  • Price Type Selection: NAV vs Price distinction is critical - use appropriate price type for transaction processing to ensure accurate calculations
  • Ex-Distribution Pricing: ExPrice and ExRedemptionPrice reflect distribution adjustments and may significantly differ from standard pricing during distribution periods
  • Historical Accuracy: Point-in-time pricing queries ensure transaction accuracy for backdated processing and regulatory compliance requirements
  • Currency Considerations: Pricing data reflects base currency settings - ensure currency alignment with transaction requirements and investor expectations

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 for pricing queries (returns all price records unless filtered by date parameters).
ExternalInvestmentId
 string
Optional
External investment identifier for cross-system pricing integration (must be combined with ProductID or ExternalProductId).
PriceDate
 date
Optional
Specific date to retrieve pricing (YYYY-MM-DD format, returns single record for exact date, mutually exclusive with date range queries).
FromPriceDate
 date
Optional
Start date for price history range extraction (YYYY-MM-DD format inclusive, use with ToPriceDate for bounded ranges).
ToPriceDate
 date
Optional
End date for price history range extraction (YYYY-MM-DD format inclusive, typically used with FromPriceDate for reporting periods).
ProductID
 integer
Optional
Native product identifier required when using ExternalInvestmentId for investment scoping.
ExternalProductId
 string
Optional
External product identifier for cross-system integration (alternative to ProductID, must be used with ExternalInvestmentId).
InvestmentID
integer
Optional
Native investment identifier for pricing queries (returns all price records unless filtered by date parameters).
ExternalInvestmentId
string
Optional
External investment identifier for cross-system pricing integration (must be combined with ProductID or ExternalProductId).
PriceDate
date
Optional
Specific date to retrieve pricing (YYYY-MM-DD format, returns single record for exact date, mutually exclusive with date range queries).
FromPriceDate
date
Optional
Start date for price history range extraction (YYYY-MM-DD format inclusive, use with ToPriceDate for bounded ranges).
ToPriceDate
date
Optional
End date for price history range extraction (YYYY-MM-DD format inclusive, typically used with FromPriceDate for reporting periods).
ProductID
integer
Optional
Native product identifier required when using ExternalInvestmentId for investment scoping.
ExternalProductId
string
Optional
External product identifier for cross-system integration (alternative to ProductID, must be used 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"
    }
  ]
}
POST Create investment prices PUT Update investment prices GET Get investments