API reference

Funds

ETF and managed fund profiles with fees, NAV and AUM, plus holdings with their weights.

Fund profiles

GET /v1/funds

1 credit per instrument 2 credits with fresh=true Operation ID funds.profiles

Issuer, benchmark, fees, domicile and distribution frequency, with the latest net assets, NAV and units on issue. Fees are yearly percentages of net assets, 0.07 for 0.07%.

Query parameters

  • symbols array of strings Required

    Comma-separated identifiers, up to 100, like ASX:VAS, isin:AU000000VAS1 or ins_...

    Up to 100 items

  • listedOn date

    Resolves tickers as the listing that traded on this day, for tickers that have since been reused. A symbol can carry its own day instead, like ASX:CCL@2021-05-10, which overrides this

  • fresh boolean

    Skip our cache and get the latest data. Items refreshed this way cost double

  • format string

    Response format

    One of jsoncsv

    Defaults to json

Response

  • data array of objects
    ShowHide 18 fields
    • apir string

      The Australian fund code, only on Australian funds that have one

    • asOf timestamp

      The point in time this data describes. For history and events it's the date of the newest record, or the end of your range when there are none. Live values give when they were observed, and reference data gives when we last confirmed it

    • aum number or null

      Net assets

    • aumDate date or null

      The day aum is from. Some issuers only publish it at month end

    • benchmark string or null
    • currency string or null

      Currency of aum and nav

    • distributionFrequency string or null

      One of monthlyquarterlysemi_annualannualnone

    • domicile string or null
    • inception date or null
    • instrument object

      What the symbol resolved to

      ShowHide 8 fields
      • country string
      • currency string
      • id string
      • mic string

        Left out for instruments that don't trade on an exchange, like tokens

      • name string
      • symbol string
      • ticker string or null

        The code it's known by, like a listing's ticker, a token's symbol or an unlisted fund's APIR code. Null when it has none

      • type string

        One of equityetffundindexfxcryptotokenratefuturecommoditybondnftoptionwarrant

    • issuer string or null
    • managementFee number or null

      Yearly percentage of net assets

    • mer number or null

      Management expense ratio as a yearly percentage of net assets

    • nav number or null

      Net asset value per unit

    • navDate date or null

      The day nav is from

    • symbol string

      The symbol as sent

    • unitsOnIssue number or null
    • unitsOnIssueDate date or null

      The day unitsOnIssue is from. Some issuers only publish it at month end

  • errors array of objects
    ShowHide 3 fields
    • code string

      One of invalid_symbolinstrument_not_foundnot_supporteddata_unavailabledata_pendingdata_failed

    • message string
    • symbol string
  • meta object
    ShowHide 2 fields
    • credits integer

      Credits this call cost

    • requestId string

Errors

400 Bad Request401 Unauthorized402 Payment Required403 Forbidden422 Unprocessable Entity429 Too Many Requests500 Internal Server Error503 Service Unavailable

Every error body is problem+json with a stable code. See errors.

Fund holdings

GET /v1/holdings

2 credits per instrument Growth and up 4 credits with fresh=true Operation ID funds.holdings

Every position of a fund with its weight, from the latest snapshot or the one on or before date. An index like INDEX:AXJO returns the holdings of a fund tracking it, named in fund. Shares and value are for the whole portfolio the issuer publishes, which can pool several share classes, so they can add up to more than the fund's net assets in funds.profiles. Weights hold either way.

Query parameters

  • symbols array of strings Required

    Comma-separated identifiers, up to 100, like ASX:VAS, isin:AU000000VAS1 or ins_...

    Up to 100 items

  • listedOn date

    Resolves tickers as the listing that traded on this day, for tickers that have since been reused. A symbol can carry its own day instead, like ASX:CCL@2021-05-10, which overrides this

  • fresh boolean

    Skip our cache and get the latest data. Items refreshed this way cost double

  • format string

    Response format

    One of jsoncsv

    Defaults to json

  • date date

    Return the snapshot on or before this day

Response

  • data array of objects
    ShowHide 8 fields
    • asOf timestamp

      The point in time this data describes. For history and events it's the date of the newest record, or the end of your range when there are none. Live values give when they were observed, and reference data gives when we last confirmed it

    • currency string or null

      Currency of every position's value

    • date date

      The day of this snapshot

    • fund object

      The fund these positions belong to

      ShowHide 8 fields
      • country string
      • currency string
      • id string
      • mic string

        Left out for instruments that don't trade on an exchange, like tokens

      • name string
      • symbol string
      • ticker string or null

        The code it's known by, like a listing's ticker, a token's symbol or an unlisted fund's APIR code. Null when it has none

      • type string

        One of equityetffundindexfxcryptotokenratefuturecommoditybondnftoptionwarrant

    • instrument object

      What the symbol resolved to

      ShowHide 8 fields
      • country string
      • currency string
      • id string
      • mic string

        Left out for instruments that don't trade on an exchange, like tokens

      • name string
      • symbol string
      • ticker string or null

        The code it's known by, like a listing's ticker, a token's symbol or an unlisted fund's APIR code. Null when it has none

      • type string

        One of equityetffundindexfxcryptotokenratefuturecommoditybondnftoptionwarrant

    • positions array of objects
      ShowHide 15 fields
      • assetClass string or null

        One of equityfixed_incomecashderivativefundreal_estatecommodityother

      • country string or null
      • currency string or null

        The constituent's own trading currency

      • industry string or null

        Industry id from /v1/sectors, null until the constituent resolves and is classified

      • instrumentId string or null

        Our id for the constituent, null until it resolves to an instrument

      • isin string or null
      • mic string or null
      • name string
      • position integer

        Order in the fund's holdings list, from 1

      • sector string or null

        Sector id from /v1/sectors, null until the constituent resolves and is classified

      • shares number

        Shares or units held, left out for positions held by face value

      • symbol string or null

        The constituent's symbol, null until it resolves to an instrument

      • ticker string or null
      • value number or null
      • weight number or null

        Percentage of net assets, 4.5 for 4.5%

    • symbol string

      The symbol as sent

    • totalValue number or null

      What the positions' value adds up to, null when any position has none

  • errors array of objects
    ShowHide 3 fields
    • code string

      One of invalid_symbolinstrument_not_foundnot_supporteddata_unavailabledata_pendingdata_failed

    • message string
    • symbol string
  • meta object
    ShowHide 2 fields
    • credits integer

      Credits this call cost

    • requestId string

Errors

400 Bad Request401 Unauthorized402 Payment Required403 Forbidden422 Unprocessable Entity429 Too Many Requests500 Internal Server Error503 Service Unavailable

Every error body is problem+json with a stable code. See errors.