Package: worldtradingdata
World Trading Data Python SDKThis is anUNOFFICIALSDK. That means that neither this repo nor the author have any
relationship with World Trading Data. This repo is simply a tool built to make it easier to
integrate with the rest API.This SDK is designed to access financial data. Therefore the author would like to stress that
what you do with any data you may get through this SDK is your problem and yours alone. I take
absolutely zero responsibility for any losses or problems that may arise from using this SDK.
Nor am I responsible for the accuracy of any of the data.In the words of GNU (even though this project is under the MIT license),"This software comes with ABSOLUTELY NO WARRANTY"Getting StartedThis SDK will require you to have an account with World Trading Data (sign uphere)InstallationMake sure you have pip3 or pip installedIn the consolepip3 install worldtradingdata==0.1.1then in python...>>> from WorldTradingData import WorldTradingData>>> my_api_token = get_my_token_from_somewhere_safe()# provide the api_token once when creating the WorldTradingData instance.# you do not need to provide the api_token on each request>>> wtd = WorldTradingData(my_api_token)>>> wtd.stock_search('AAPL')  # will find all your favourite fruity stocksGeneral GuidanceRequired arguments should be given individually, and optional arguments should be
supplied as a dictionary, with the param name as the key, and the param value as the value.e.g.
Perform a basic stock search withwtd.stock_search('AAPL')Anything which is an optional query string param in the official docs can be passed in a dictionary
as a second argument
(see official docs for full argument reference).optional_params = {'output': 'csv', 'currency': 'usd'}wtd.stock_search('AAPL', optional_params)Methods have been named in accordance with the url path suffix for that request in the official docs.
i.e. if the base url of a request ishttps://api.worldtradingdata.com/api/v1and the final url for a Forex History request ishttps://api.worldtradingdata.com/api/v1/forex_historythen the url path suffix of the request is considered to be/forex_history.All the methods in the SDK are named according to their corresponding url path suffix without the/.e.g.wtd.forex_history(args, in, here)Method ReferencePlease be aware that this SDK is designed to be a loose wrapper around the official REST API
provided bywww.worldtradingdata.com.
That means that it does not include pre-flight checks to make sure your provided arguments are correct.
This provides much more flexibility, but it means if you provide poorly formed arguments
to the SDK, they will be ignored and the results you get might not be what you expect.I'm working on stricter type checking for version 2.# note: 'api_token' is supplied automaticallyReal Time Market Datafull reference athttps://www.worldtradingdata.com/documentation#real-time-market-dataStock and Index Real Timewtd.stock(symbol: list [, optional_params: dict])examplemore_params = {'output': 'csv'}wtd.stock(['AAPL', 'GOOG'], more_params)Mutual Fund Real Timewtd.mutual_fund(symbol: list [, optional_params: dict])examplemy_symbol_array = ['AAAAX', 'AAADX', 'AAAGX']wtd.mutual_fund(my_symbol_array)Intraday Market Datafull reference athttps://www.worldtradingdata.com/documentation#intraday-market-dataStock and Index Intradaywtd.intraday(symbol: str, interval: int, range: int [, optional_params: dict])Historical Market Datafull reference athttps://www.worldtradingdata.com/documentation#historical-market-dataFull Historywtd.history(symbol: str [, optional_params: dict])Multi Single Day Historywtd.history_multi_single_day(symbol: str, date: str [, optional_params: dict])# date should be formatted as 'YYYY-MM-DD'Forexfull reference athttps://www.worldtradingdata.com/documentation#forex-dataReal Timewtd.forex(base: str)Historicalwtd.forex_history(base: str, convert_to: str [, optional_params: dict])Single Day Historywtd.forex_single_day(base: str, date: str [, optional_params: dict])Searching Stocksfull reference athttps://www.worldtradingdata.com/documentation#searchingwtd._stock_search(search_term: string [, optional_params: dict])Perform a basic stock search withwtd.stock_search('AAPL')Anything which is a query_string param in the official docs can be passed
in the dictionary of optional params.optional_params = {'output': 'csv', 'currency': 'usd'}wtd.stock_search('AAPL', optional_params)