Please enable JavaScript in order to get the most from this website.

You can use our data services from the website through dowloadable links or in your own application by means of API requests. Logged-in users can browse to dedicated pages, use our data-visualization tools and download data. For example you can visit the Instruments page, choose an instrument and explore End-Of-Day, Intraday, Indicators or Options Chains data. On the other hand you can build your own application and interact with our data services through API requests. When the request succeeds, a response message is returned with data in the content and additional information in the header. The data formats include CSV, JSON, XML, BSON and DTOs (Data Transfer Objects) that can be serialized. Set the desired content type when issuing requests. Failed requests return error messages with specific details.
This documentation will help you explore our exposed endpoints and give you specific details about their usage. We strive to make it as simple and legible as possible. Feel free to contact us should you experience any issue using it.

Authentication

You use our APIs by submitting requests to our exposed endpoints. Most API requests need to be identified by supplying a security token. Registered users are assigned an API key they can use to generate these tokens. Explore the Tokens section to see how you can generate them and authenticate your requests.

Authorization

Access to our different data services is granted depending on your account profile. See the different user profiles for information about data access levels.

Availability

Data availability highly depends on the instrument and the type of data you are searching for. You can obtain extensive information from the instrument's details page or by sending a request for information about the instrument.

Restrictions

In order to provide our users with quality services, we take action to prevent abuses of any kind. As such, restrictions about the number of requests allowed within a period of time may apply.

You use security tokens to send requests to endpoints that require identification. Tokens are generated with your API key. By default they expire 2 minutes after they've been generated. So generate them when you are all set and ready to hit the endpoint that requires the token. For obvious security reasons, keep your API key secret and only use it with requests that are submitted server-side. Change your API key if you feel that it's secrecy is compromised.

Endpoint

Send a GET request to the following endpoint:

/api/tokens/generate/{apiKey}

Parameters

Parameter Type Format Description
apiKey GUID GUID User's API key. Can be found in your account settings.

Response

Returns a response message containing a JSON object with the following properties:

Property Type Format Description
Key GUID GUID The generated token.
Issued DateTime ISO The token's creation time.
Expiry DateTime ISO The token's expiry time.

Example

Request

You generate a temporary token using your API key. The token can be used before it's expiry time in order to authenticate subsequent requests.

https://www.tallacoptions.com/api/tokens/generate/7e7e6703-d9f1-4f14-936b-1184781d8003

Response

A JSON object with the aforementioned properties is returned.

                                
                                    {
                                    "Key":"848199a4-6ff9-4387-906e-3a2ba34a7a3a",
                                    "Issued":"2019-06-29T01:34:19.0294764Z",
                                    "Expiry":"2019-06-29T01:36:19.0294764Z"
                                    }
                                
                            
Under Construction...

End-Of-Day data can be obtained for available instruments over a period defined by a start date and an end date. The authorized period range is restricted with regard to the user's access level. Requests for data beyond the authorized period range will be declined with an error message response.

Endpoint

Send a GET request to the following endpoint:

/api/eod/quotes/{ticker}/{start}/{end}/{token}

Parameters

Parameter Type Format Description
ticker String String Instrument's ticker symbol.
start DateTime yyyy-MM-dd Period's start date.
end DateTime yyyy-MM-dd Period's end date.
token GUID GUID Valid user-generated token.

Response

Headers

The following additionnal http headers are included in the reponse:

Name Value
Ticker Instrument's ticker symbol.
Description Instrument's description.
Caption Description of the response.
Access-Level User's access level.
Access-Right User's access right.
Content

A collection of EodQuoteDTO objects with the following properties:

Property Type Format Description
Date DateTime ISO Quotation date.
Open Decimal Decimal Opening price.
High Decimal Decimal Highest price.
Low Decimal Decimal Lowest price.
Close Decimal Decimal Closing price.
Volume Integer Integer Traded volume.
NetChange Decimal Decimal Net price change.
PercentChange Decimal Decimal Percent price change.
Remarks String String Any remarks about the trading session.

EodQuoteDTO objects can be serialized into CSV, XML, JSON and BSON formats.

Example

Request

You send a GET request for AAPL EOD data from September 28th 2018 to July 12th 2019 using a temporary token.
We assume that a JSON content type is specified in the request header.

https://www.tallacoptions.com/api/eod/quotes/aapl/2018-09-28/2019-07-12/848199a4-6ff9-4387-906e-3a2ba34a7a3a

Response

Headers
Name Value
Ticker AAPL
Description Apple Inc.
Caption AAPL Daily Quotes From 2018-09-28 To 2019-07-12 - www.TallacOptions.com
Content

A collection of JSON objects with the aforementioned properties.

                                
                                    [
                                    {
                                    "Date":"2019-07-12T00:00:00",
                                    "Open":202.45000,
                                    "High":204.00000,
                                    "Low":202.20000,
                                    "Close":203.30000,
                                    "Volume":17397728,
                                    "NetChange":1.55000,
                                    "PercentChange":0.0076827757125154894671623296,
                                    "Remarks":""                                    
                                    },
                                    ...
                                    ,{
                                    "Date":"2018-09-28T00:00:00",
                                    "Open":224.79000,
                                    "High":225.84000,
                                    "Low":224.02000,
                                    "Close":225.74000,
                                    "Volume":22888201,
                                    "NetChange":0.79000,
                                    "PercentChange":0.0035118915314514336519226495,
                                    "Remarks":""
                                    }
                                    ]
                                
                            
Under Construction...
Under Construction...