The <Fundamentals> Element

Description

Defines a query for <Fundamentals> data. The Fundamentals Service is restricted to licensed users, and one needs a special account to gain access to the data.

The Fundamentals Service knows several subscriptions, of which the Standard Package is the most complete version, and other subscriptions like the Minimal Package are mere subsets. The documentation explicitly indicates which data is restricted.

<Fundamentals
    organisation = integer
    collection = string
    exchange = exchange
    ticker = ticker
    ticker-type = ticker type
    date-start = datetime
    show-nulls = boolean />

Attributes

Attribute nameData typeDescription
organisation Optionalinteger Requests data for a single organisation. The id used here is the id attribute of the <Organisation> (root) attribute.
collection Optionalstring

Request data for all organisations that have an issue within the specified collection. For example, Euronext.Amsterdam.Shares.AEX. See also Known Collections.

You can not specify "<collection>#<series>", to make a sub-selection within the specified collection; use an organisation request in this case.

exchange Optionalexchange Tells the TBXDS engine to return fundamental data from organisations on this exchange; cannot be used in combination with collection or organisation, but must be used in combination with ticker.
ticker Optionalticker Tells the TBXDS engine to return fundamental data from the organisation which uses this ticker; cannot be used in combination with collection or organisation.
ticker-type Optionalticker type Which type of ticker classification you wish to use for your request. If this value is omitted, the value of ticker-type will be used.
date-start Optionaldatetime From which date you wish to recieve updated data. When left out, all data is returned. The date implicitly indicates a time range from the value of the attribute until now. Consecutive changes are ignored: only the current data is returned.
show-nulls Optionalboolean

Indicates that database nulls should be explicitly returned. Normally, attributes containing no data are left out of the <Fundamentals> data structure (DOM selections would return a null reference for such missing attributes), but it might be needed to receive these missing figures explicitly, which is exactly what show-nulls does.

When show-nulls is set to "yes", null values are reported als "#null#". For numeric data this should not pose as a problem, but for string data, you should explicitly check against "#null#".

Number of occurences

Unlimited

Occurs within

<TBMDataRequest>

Can contain

None (element is closed).

See also

<Fundamentals>