A stock is one of the key elements of our information site, Apple's stock page can be found here https://stockflare.com/stocks/AAPL.O

We have a number of API endpoints that provide instrument and historical information, we would like you to write a stock page of your own design to display some of the information available from our APIs.

You can:

• Choose any platform, language, framework as long as the entire project can be delivered in a single Github repo.
• Choose to display whatever information you want about the stock as long as you display its name, ticker and price.

Make sure that:

• The page can display any stock using either a ticker, ric or sic as the key in the URL. There is no requirement to support all three.
• All datapoints displayed for a particular stock must be loaded dynamically. There should not be any hard coded stock data.
• We can easily run the project. The build and running instructions must be documented in the README.md file.
• Submit the test as a public or private Github repository.

Note: If private, then please add several of our team as collaborators.

Things of note

• Time limits are pretty ridiculous. Spend as much time completing this test as you have value for the position your applying to.
• Our goal is to determine your coding & work style as well as how you choose to organize a project.

There are three APIs available for use.

The Search API is a convenient method of retrieving stock data and shows the latest data for any stock. The Instrument API provides basic details of a stock, whilst the Historical API provides time series financial data on stocks.

https://api.stockflare.com/search

The Search API aims to abstract and simplify specific calls to the Elasticsearch backend. The API provides a number of endpoints facilitating the requests that are required by the Stockflare software stack. Such endpoints simplify searching for a company by name, for example.

PUT https://api.stockflare.com/search with body

{
  "term": "apple",
  "select": "_all"
}

This will give you a list of stocks with apple in their name.

PUT https://api.stockflare.com/v1/search/filter with body

{
  "conditions": {
      "_id": "6c8227be-6855-11e4-98bf-294717b2347c"
  },
  "select": "_all"
}

This example will return an array as before however it will contain only one element which will be Apple. in this case due to how Elasticsearch works we need to use _id however the value of _id is always the same as the sic (Stockflare Instrument Code) attribute.

Performs a full text search over the fields provided, with results weighted by their associated values.

The conditions hash supports a custom field type that enables the definition of a range of field conditions that are converted into their associated structure before being sent to Elasticsearch.

Filters records based upon the parameters received. Parameters are parsed in a number of ways, providing a greater flexibility of querying.

The conditions hash supports a custom field type that enables the definition of a range of field conditions that are converted into their associated structure before being sent to Elasticsearch.

Note: Any fields can be defined inside the conditions hash.

Performs the desired aggregation over the field specified, using the list of matching records returned and as specified from the fields key.

Note: The provided field determines the data that is used within the aggregation.

The ?type= field supports avg, min, max, sum and cardinality (count unique values).

The values provided for each field within the conditions hash can take on values similar to the examples defined below.

Returns data pertaining to Instruments (Stocks, ETFs, REITs, etc.) and their associated Companies. This API responds with typically static, non-time-series information for specific instruments, such as the company name "Apple Inc", when the RIC AAPL.O is requested.

Instruments can be requested using an isin code, a ric or repo_no parameter. The last two being specific to Reuters. This API supports requesting multiple or single ISIN codes in one call. However, when using a ric or repo_no parameter, only a single instrument can be requested at once.

PUT https://api.stockflare.com/instruments with body

{
    "sic": "6c8227be-6855-11e4-98bf-294717b2347c"
}

This will return the details of Apple

Note: All parameters are mutually exclusive.

Returns time-series based historical information for all Instruments tracked by Stockflare (Equities, ETFs, REITs, etc.). This API offers flexible querying for a large tableset of data, but is limited to returning specific fields as determined by the select key.

Historical data can only be requested using a sic (Stockflare Instrument Code) parameter.

PUT https://api.stockflare.com/historical with body

{
    "sic": "6c8227be-6855-11e4-98bf-294717b2347c",
    "after": 0,
    "select": ["price", "market_value_usd"]
}

This will return an array of the stock price and market_value_usd over time. The updated_at is a UNIX timestamp of the pricing date.

Below is an example response:

[
  ...,
  {
    "price": "110.45",
    "updated_at": 1444144597
  },
  ...
]

Below is a full map of the fields currently tracked and available to the select parameter along with example values:

{
  "high_growth": true,
  "cheaper": true,
  "upside": true,
  "profitable": true,
  "updated_at": 1444144597,
  "dividends": true,
  "growing": true,
  "rating": 5,
  "price": 110.77,
  "fifty_two_week_high": 134.53,
  "fifty_two_week_low": 92,
  "ten_day_average_volume": 55.84,
  "pe_ratio": 12.79,
  "eps": 8.65,
  "book_value": 22.02,
  "cash_flow_per_share": 10.37,
  "dps": 1.92,
  "recommendation": 1.9375,
  "target_price": 147.19,
  "eps_next_quarter": 1.87,
  "forecast_pe": 12.13,
  "forecast_eps": 9.12,
  "forecast_dps": 1.98,
  "forecast_dividend_yield": 0.01,
  "price_to_book_value": 5.02,
  "shares_outstanding": 5702722048,
  "long_term_gain": 0.20,
  "peer_average_long_term_growth": 13.62,
  "peer_average_forecast_pe": 17.49,
  "recommendation_text": "buy",
  "momentum": 0.35,
  "price_change": 0.36,
  "one_month_forecast_eps_change": 0.00,
  "three_month_forecast_eps_change": 0.00,
  "one_month_price_change": -0.01,
  "three_month_price_change": -0.11,
  "free_cash_flow_yield": 0.1076,
  "seven_year_gain": 1.6177,
  "per_year_gain": 0
  "net_cash": false,
  "enterprise_value": 651462.625,
  "market_value": 631747.625,
  "long_term_growth": 14.23
  "forecast_sales": 233233.21875,
  "sales_next_quarter": 51060.9765625,
  "forecast_net_profit": null,
  "return_on_equity": 41.14
  "latest_sales": 224337,
  "operating_profit": 77879,
  "net_profit": 50737,
  "gross_margin": 39.71
  "enterprise_value_to_sales": 2.90
  "market_value_usd": 631747.625,
  "enterprise_value_to_operating_profit": 8.36
}