## 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.
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 `
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 option||Coverage||Price||Typical use|
|Referential Feed||Equities (listed, core session, includes OTC), Crypto||Per customer, per month||Display data prior to and on execution for non-US Partners / Customers|
|Consolidated Exchange Feed||Equities (listed, core+extended sessions)||Per request||Display data prior to a customer submitting a trade, and prior to its execution|
|15 Minute Delayed Feed||Equities (listed, core session)||Free||Watchlist 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.
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: