View as Markdown

Time series

Every instrument carries one or more kinds of time-series: end-of-day prices for listed securities, net asset values for funds, interest rates for cash and fixed-income products, and index factors for custom benchmarks. These are the raw numbers the platform reads when it values holdings and computes performance. Each series is addressable two ways: through the parent instrument (/api/v3/instruments/{id}/... for list and create) and directly (/api/v3/{series}/{id} for delete).

The four series kinds

  • Name
    Price
    Type
    equity / ETF / listed
    Description

    End-of-day closing price from the primary exchange. Always the authoritative valuation for listed instruments.

  • Name
    NetAssetValue
    Type
    fund / private
    Description

    Unit NAV for open-ended funds; the latest published valuation for private-market vehicles. Lower-frequency than prices — quarterly for most private funds.

  • Name
    InterestRate
    Type
    cash / bond
    Description

    Rate used to accrue interest on a cash balance or compute bond returns. Indexed to reference rates (SOFR, €STR, CIBOR) where the instrument definition specifies.

  • Name
    IndexFactor
    Type
    benchmark / custom
    Description

    Factor used to compute returns on a custom benchmark — the hedge the client's IPS compares performance against.

Common shape

Each point on every series shares the same attribute set:

  • Name
    date
    Type
    ISO 8601 date
    Description

    Effective date of the observation, not the ingestion timestamp.

  • Name
    value
    Type
    decimal
    Description

    Observed number — price, NAV, rate, factor. Units are implicit per series kind: interest rates as decimal fractions, prices in the instrument's quote currency.

JSON:API resource types: price, net-asset-value, interest-rate, index-factor.

Prices

List prices

End-of-day closing prices in the instrument's quote currency. The authoritative valuation series for listed instruments.

Request

GET/api/v3/instruments/{id}/prices
curl https://platform.aleta.io/api/v3/instruments/{instrument_id}/prices \
  -H "Authorization: Bearer {access_token}"

Create a price

Books a price for the instrument on a given date. Re-posting the same (instrument, date) pair overwrites the prior value.

Request

POST/api/v3/instruments/{id}/prices
curl -X POST https://platform.aleta.io/api/v3/instruments/{instrument_id}/prices \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{
    "data": {
      "type": "price",
      "attributes": { "date": "2026-04-30", "value": 850.50 }
    }
  }'

Delete a price

Removes a single price observation by its identifier.

Request

DELETE/api/v3/prices/{id}
curl -X DELETE https://platform.aleta.io/api/v3/prices/{id} \
  -H "Authorization: Bearer {access_token}"

Net asset values

List NAVs

Unit NAVs for open-ended funds and the latest published valuation for private-market vehicles. Typically lower-frequency than prices — monthly for most liquid funds, quarterly for private ones.

Request

GET/api/v3/instruments/{id}/net-asset-values
curl https://platform.aleta.io/api/v3/instruments/{instrument_id}/net-asset-values \
  -H "Authorization: Bearer {access_token}"

Create a NAV

Books a NAV for the instrument on a given date.

Request

POST/api/v3/instruments/{id}/net-asset-values
curl -X POST https://platform.aleta.io/api/v3/instruments/{instrument_id}/net-asset-values \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{
    "data": {
      "type": "net-asset-value",
      "attributes": { "date": "2026-03-31", "value": 102.45 }
    }
  }'

Delete a NAV

Removes a single NAV observation by its identifier.

Request

DELETE/api/v3/net-asset-values/{id}
curl -X DELETE https://platform.aleta.io/api/v3/net-asset-values/{id} \
  -H "Authorization: Bearer {access_token}"

Interest rates

List rates

Rate used to accrue interest on a cash balance or compute bond returns. Indexed to the reference rate the instrument definition specifies.

Request

GET/api/v3/instruments/{id}/interest-rates
curl https://platform.aleta.io/api/v3/instruments/{instrument_id}/interest-rates \
  -H "Authorization: Bearer {access_token}"

Create a rate

Books an interest rate for the instrument on a given date. The value is a decimal fraction, not a percentage.

Request

POST/api/v3/instruments/{id}/interest-rates
curl -X POST https://platform.aleta.io/api/v3/instruments/{instrument_id}/interest-rates \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{
    "data": {
      "type": "interest-rate",
      "attributes": { "date": "2026-04-30", "value": 0.0325 }
    }
  }'

Delete a rate

Removes a single interest-rate observation by its identifier.

Request

DELETE/api/v3/interest-rates/{id}
curl -X DELETE https://platform.aleta.io/api/v3/interest-rates/{id} \
  -H "Authorization: Bearer {access_token}"

Index factors

List factors

Factors used to compute returns on a custom benchmark.

Request

GET/api/v3/instruments/{id}/index-factors
curl https://platform.aleta.io/api/v3/instruments/{instrument_id}/index-factors \
  -H "Authorization: Bearer {access_token}"

Create a factor

Books an index factor for the instrument on a given date.

Request

POST/api/v3/instruments/{id}/index-factors
curl -X POST https://platform.aleta.io/api/v3/instruments/{instrument_id}/index-factors \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{
    "data": {
      "type": "index-factor",
      "attributes": { "date": "2026-04-30", "value": 1.0234 }
    }
  }'

Delete a factor

Removes a single index-factor observation by its identifier.

Request

DELETE/api/v3/index-factors/{id}
curl -X DELETE https://platform.aleta.io/api/v3/index-factors/{id} \
  -H "Authorization: Bearer {access_token}"
  • Instruments — the parent catalog every series hangs off.
  • Instrument classes — the taxonomy driving which series kinds apply to which instruments.
  • Holdings — valued using these series.