## Asset details

Every asset on the DriveWealth platform has associated fundamental and general information data. These data points can allow investors to make more informed decisions, or help platforms ingest typical asset components such as a company logo.

Data updates

Most fundamental data is updated on a daily basis and should be stored in cache to limit the total number of requests to the instrument's endpoint. General information such as logo and prospectus links that do not update frequently can be stored for longer.

Data is retrieved through the instruments endpoint, requiring an already stored `instrumentID`. Please note `instrumentID`โ€™s are different between DriveWealth environments.

Upon a successful request, the API returns point in time quote information for the requested symbol. A Partner should expect the following data within a successful response:

๏ปฟ

For assets such as mutual funds and ETFs certain data may be unavailable as they do not relate to funds. This could include `earningsPerShare` and `peRatio`.

Logo query parameters

Every logo allows for customization through hosting on [imgix](๐Ÿ”—๏ปฟ). For example, to render a logo and adjust its size, itโ€™s possible to add `/fit=crop&w=300&max-h=300` to the image URL.

## Quotes and prices

DriveWealth offers three different options for retrieving the prices of assets:

Market data optionCoveragePriceTypical use
Referential FeedEquities (listed, core session, includes OTC), CryptoPer customer, per monthDisplay data prior to and on execution for non-US Partners / Customers
Consolidated Exchange FeedEquities (listed, core+extended sessions)Per requestDisplay data prior to a customer submitting a trade, and prior to its execution
15 Minute Delayed FeedEquities (listed, core session)FreeWatchlist and symbol searches

A user must first be successfully created in order for a customer to be shown the market data. This is required because DriveWealth has a reporting requirement to the exchanges for who is accessing the data.

All market data endpoints require that the `userID` of the customer who is being provided the quote is passed as a parameter within the header of the API call being made; as shown below.

๏ปฟ

Upon a successful request, the API returns point in time quote information for the requested symbol.

๏ปฟ

Storing data

DriveWealth does not allow redistribution or non display of market data, meaning: partners may not store any data received for further use within their infrastructure.

Youโ€™ll notice above that there are multiple numbers that can be used to represent the single โ€œpriceโ€ of a security. For most assets, these 3 values are important in different contexts:

  • `bid` โ€” Shown at the time when a sale is being contemplated by customer

  • `ask` โ€” Shown at the time when a buy is being contemplated by the customer

  • `lastTrade` โ€” Displayed as a primary price of the asset elsewhere in the experience

US-regulated firms are required to show additional data points at certain points of the investing experience based on local regulations. Notice that when requesting a quote from the Consolidated Data Feed, additional values like the reporting exchanges and bid/ask volume are returned:

๏ปฟ