NAV Navbar
HTTP

Introduction

Our REST API offers a powerful and easy way to access market data from all over the world. Feel free to explore the API and the examples provided. Claim your own API key and get started today by signing up for free. If you have any questions you can contact us and we will get back to you as soon as possible.

You can search through our database of supported stocks and indexes here.

You can search through our database of supported mutual funds here.

Authentication

Each API request is authenticated with your own personal API token which you can obtain for free by signing up

Include your API token in each request by passing it as a query parameter in each request.

Real Time Market Data

Stock and Index Real Time

GET https://api.worldtradingdata.com/api/v1/stock?symbol=SNAP,TWTR,VOD.L&api_token=demo

The above URL returns JSON structured like this:

{
    "symbols_requested": 1,
    "symbols_returned": 1,
    "data": [
        {
            "symbol": "SNAP",
            "name": "Snap Inc.",
            "price": "13.52",
            "currency": "USD",
            "price_open": "14.15",
            "day_high": "14.28",
            "day_low": "13.42",
            "52_week_high": "18.36",
            "52_week_low": "4.82",
            "day_change": "-0.26",
            "change_pct": "-1.89",
            "close_yesterday": "13.78",
            "market_cap": "18647865344",
            "volume": "38568710",
            "volume_avg": "21022662",
            "shares": "1103779968",
            "stock_exchange_long": "New York Stock Exchange",
            "stock_exchange_short": "NYSE",
            "timezone": "EDT",
            "timezone_name": "America/New_York",
            "gmt_offset": "-14400",
            "last_trade_time": "2019-10-18 16:02:11",
            "pe": "N/A",
            "eps": "-0.81"
        }
    ]
}

Our real time data endpoint returns the nearest trading data for stocks and indexes worldwide. The endpoint is extremely easy to use and incredibly powerful. The endpoint allows up to 500 stocks or indexes to be returned with each request in exceptional timing.

You can try it yourself for free by signing up today.

HTTP Request

GET https://api.worldtradingdata.com/api/v1/stock

Query Parameters

The endpoint takes up to 5 query parameters; symbol, api_token, sort_order, sort_by and output. The symbol parameter allows you to request real time data for up to 500 stocks or indexes per request. The output=csv parameter will return the data as a CSV format but by default will return JSON. The api_token is used to verify each request. If you don't yet have an API token you can get one for free by signing up.

Parameter Default Required Description Options Example
symbol null true Comma seperated values of the stocks you wish to return. - symbol=SNAP,TWTR,VOD.L
api_token null true The API token associated with your account for authentication. Get your own free API token here. - api_token=demo
sort_order asc false Change the sort order of values. asc, desc sort_order=desc
sort_by symbol false Sort by a particular data attribute or by the order you entered the list. symbol, name, list_order sort_by=name
output json false Change output to CSV. csv, json output=csv

Mutual Fund Real Time

GET https://api.worldtradingdata.com/api/v1/mutualfund?symbol=AAAAX,AAADX,AAAGX&api_token=demo

The above URL returns JSON structured like this:

{
    "symbols_requested": 1,
    "symbols_returned": 1,
    "data": [
        {
            "symbol": "AAAAX",
            "name": "DWS RREEF Real Assets Fund - Class A",
            "price": "10.41",
            "close_yesterday": "10.41",
            "return_ytd": "-0.69",
            "net_assets": "92654243",
            "change_asset_value": "0.03",
            "change_pct": "0.29",
            "yield_pct": "1.45",
            "return_day": "0.86",
            "return_1week": "0.11",
            "return_4week": "-0.11",
            "return_13week": "-1.67",
            "return_52week": "1.95",
            "return_156week": "5.27",
            "return_260week": "2.17",
            "income_dividend": "0.09",
            "income_dividend_date": "2018-06-22 16:00:00",
            "capital_gain": "0.05",
            "expense_ratio": "1.22"
        }
    ]
}

The endpoint allows up to 500 mutual funds to be returned with each request in exceptional timing. You can try it yourself for free by signing up today.

HTTP Request

GET https://api.worldtradingdata.com/api/v1/mutualfund

Query Parameters

The endpoint takes up to 5 query parameters; symbol, api_token, sort_order, sort_by and output. The symbol parameter allows you to request real time data for up to 500 funds per request. The output=csv parameter will return the data as a CSV format but by default will return JSON. The api_token is used to verify each request. If you don't yet have an API token you can get one for free by signing up.

Parameter Default Required Description Options Example
symbol null true Comma seperated values of the funds you wish to return. - symbol=AAAAX,AAADX,AAAGX
api_token null true The API token associated with your account for authentication. Get your own free API token here. - api_token=demo
sort_order asc false Change the sort order of values. asc, desc sort_order=desc
sort_by symbol false Sort by a particular data attribute or by the order you entered the list. symbol, name, list_order sort_by=name
output json false Change output to CSV. csv, json output=csv

Intraday Market Data

Stock and Index Intraday

GET https://intraday.worldtradingdata.com/api/v1/intraday?symbol=SNAP&range=1&interval=1&api_token=demo

The above URL returns JSON structured like this:

{
    "symbol": "SNAP",
    "stock_exchange_short": "NYSE",
    "timezone_name": "America/New_York",
    "intraday": {
        2019-10-03 15:59:00: {
            "open": "14.30",
            "close": "14.30",
            "high": "14.31",
            "low": "14.28",
            "volume": "478277",
        },
        2019-10-03 15:58:00: {
            "open": "14.30",
            "close": "14.31",
            "high": "14.32",
            "low": "14.30",
            "volume": "251750",
        },
        2019-10-03 15:57:00: {
            "open": "14.31",
            "close": "14.30",
            "high": "14.30",
            "low": "14.30",
            "volume": "144458",
        },
        2019-10-03 15:56:00: {
            "open": "14.32",
            "close": "14.30"",
            "high": "14.34",
            "low": "14.30",
            "volume": "243704",
        },
        ...
    }
}

Our intraday data endpoint returns a stream of the latest data for stocks and indexes worldwide. The endpoint allows data to be returned in different time intervals and ranges.

You can try it yourself for free by signing up today.

HTTP Request

GET https://intraday.worldtradingdata.com/api/v1/intraday

Query Parameters

The symbol parameter allows you to request intraday data for a single stock or index. The interval parameter specifies the interval (in minutes) of time between the data. The range parameter specifies the number of days you want to return data for. The output=csv parameter will return the data as a CSV format but by default will return JSON. The api_token is used to verify each request. If you don't yet have an API token you can get one for free by signing up.

Parameter Default Required Description Options Example
symbol null true Value of the stock, index or mutual fund you wish to return data for. Only one symbol per request. - symbol=SNAP
api_token null true The API token associated with your account for authentication. Get your own free API token here. - api_token=demo
interval null true Number of minutes between the data. 1, 2, 5, 60 interval=1
range null true The number of days data is returned for. 1-30 range=7
sort desc false Change the sort order of values. asc, desc sort=desc
output json false Change output to CSV. csv, json output=csv
formatted true false Alter JSON data format. Does not affect CSV true, false formatted=false

Interval limitations

The supported range is different based on the interval provided. See the table below to see what is currently available.

Interval (minutes) Supported Range (days)
1 1-7
2 1-30
5 1-30
15 1-30
60 1-30

Historical Market Data

Full History

GET https://api.worldtradingdata.com/api/v1/history?symbol=SNAP&sort=newest&api_token=demo

The above URL returns JSON structured like this:

{
    "name": "SNAP",
    "history": {
        2019-10-18: {
            "open": "14.15",
            "close": "13.52",
            "high": "14.28",
            "low": "13.42",
            "volume": "39057300"
        },
        2019-10-17: {
            "open": "13.73",
            "close": "13.78",
            "high": "14.12",
            "low": "13.69",
            "volume": "21096490"
        ...
    }
}

Our historical data endpoint returns the end of day history for every day the stock, index or mutual fund has been traded. The endpoint allows you to enter to and from dates to refine the data that will be returned and you can also sort the data by newest or oldest.

You can try it yourself for free by signing up today.

HTTP Request

GET https://api.worldtradingdata.com/api/v1/history

Query Parameters

The history endpoint allows a maximum of 1 ticker per request. The symbol and api_token parameters are required for each request. If the date_from and date_to parameters are omitted from the request, the endpoint will return the entire set of historical data for that ticker. The order of the returned data can be sorted by newest or oldest data first using the sort parameter. By default the data will be returned with newest first (descending order).

Parameter Default Required Description Options Example
symbol null true Value of the stock, index or mutual fund you wish to return data for. Only one symbol per request, if more than one is entered the first symbol is used. - symbol=SNAP
api_token null true The API token associated with your account for authentication. Get your own free API token here. - api_token=demo
date_from start of dataset false The date you wish to start the data retrieval. - date_from=2018-01-02
date_to end of dataset false The date you wish to end the data retrieval. - date_to=2018-06-01
sort newest false Sort by date. newest, oldest, desc, asc sort=newest
output json false Change output to CSV. csv, json output=csv
formatted true false Alter JSON data format. Does not affect CSV true, false formatted=false

Multi Single Day History

GET https://api.worldtradingdata.com/api/v1/history_multi_single_day?symbol=SNAP,TWTR&date=2018-01-02&api_token=demo

The above URL returns JSON structured like this:

{
    "date": "2018-01-02",
    "data": {
        SNAP: {
            "open": "14.69",
            "close": "14.95",
            "high": "15.01",
            "low": "14.61",
            "volume": "9970989"
        },
        TWTR: {
            "open": "24.07",
            "close": "24.51",
            "high": "24.57",
            "low": "23.85",
            "volume": "15297229"
        }
    }
}

Our historical multi single day data endpoint returns data for multiple stock, index or mutual funds for a single specific day. The endpoint allows you to enter multiple tickers and a date which will return each ticker with the prices for that day.

You can try it yourself for free by signing up today.

HTTP Request

GET https://api.worldtradingdata.com/api/v1/history_multi_single_day

Query Parameters

The historical multi single day allows you to enter multiple tickers for each request. The symbol, date and api_token parameters are required for each request. The order of the returned data can be sorted by ticker name either ascending or descending. By default the data will be returned by ticker in ascending order.

Parameter Default Required Description Options Example
symbol null true Comma seperated values of the tickers you wish to return. - symbol=SNAP,TWTR
api_token null true The API token associated with your account for authentication. Get your own free API token here. - api_token=demo
date null true The date you wish to retrieve data for. - sort_order=desc
sort asc false Sort order by name. desc, asc sort=desc
output json false Change output to CSV. csv, json output=csv
formatted true false Alter JSON data format. Does not affect CSV true, false formatted=false

Forex Data

Real Time

GET https://api.worldtradingdata.com/api/v1/forex?base=USD&api_token=demo

The above URL returns JSON structured like this:

{
    "symbols_returned": 147
    "base": "USD",
    "data": {
        AED: "3.672990",
        AFN: "78.250000",
        ALL: "110.950000",
        AMD: "476.340000",
        ANG: "1.755172",
        AOA: "449.036500",
        ARS: "58.350880",
        AUD: "1.460280",
        AWG: "1.800000",
        AZN: "1.700000",
        ...
    }
}

Our real time currency data endpoint returns data for over 20,000 currency combinations, updated every 5 minutes. The endpoint is extremely easy to use and incredibly powerful which will return all the conversion rates for the base currency in exceptional timing.

You can try it yourself for free by signing up today.

HTTP Request

GET https://api.worldtradingdata.com/api/v1/forex

Query Parameters

This endpoint takes a single base currency and returns the conversion rate for all available currencies. The base and api_token parameters are required for each request.

Parameter Default Required Description Options Example
base null true Value of the currency you wish to return data for. - base=USD
api_token null true The API token associated with your account for authentication. Get your own free API token here. - api_token=demo

Historical

GET https://api.worldtradingdata.com/api/v1/forex_history?base=USD&convert_to=GBP&sort=newest&api_token=demo

The above URL returns JSON structured like this:

{
    "symbol": "USDGBP",
    "history": {
        2019-10-19: "0.770119",
        2019-10-18: "0.770119",
        2019-10-17: "0.776785",
        2019-10-16: "0.779900",
        2019-10-15: "0.783500",
        2019-10-14: "0.793345",
        ...
    }
}

Our historical currency data endpoint contains data for over 20,000 currency combinations with up to 15 years of data.

You can try it yourself for free by signing up today.

HTTP Request

GET https://api.worldtradingdata.com/api/v1/forex_history

Query Parameters

This endpoint takes a base currency and a currency to convert to and returns the end of day conversion rate for each day of data. The base, convert_to and api_token parameters are required for each request.

Parameter Default Required Description Options Example
base null true Base of the currency you wish to return data for. - base=USD
convert_to null true Value of the currency you wish to return conversion data to. - convert_to=GBP
api_token null true The API token associated with your account for authentication. Get your own free API token here. - api_token=demo
date_from start of dataset false The date you wish to start the data retrieval. - date_from=2018-01-02
date_to end of dataset false The date you wish to end the data retrieval. - date_to=2018-06-01
sort newest false Sort order by newest or oldest data first. newest, oldest sort=oldest
output json false Change output to CSV. csv, json output=csv
formatted true false Alter JSON data format. Does not affect CSV true, false formatted=false

Single Day History

GET https://api.worldtradingdata.com/api/v1/forex_single_day?base=USD&date=2018-08-31&api_token=demo

The above URL returns JSON structured like this:

{
    "base": "USD",
    "date": "2018-08-31"
    "data": {
        AED: "3.673200",
        AFN: "73.482500",
        ALL: "108.990000",
        AMD: "483.070000",
        ANG: "1.845850",
        AOA: "276.287500",
        ARS: "36.842000",
        AUD: "1.390600",
        AZN: "1.702500",
        BAM: "1.594100",
        ...
    }
}

Our multi single day currency data endpoint can return data for over 20,000 currency combinations for a specific date. The endpoint is extremely easy to use and incredibly powerful and will return the all the conversion rates for the base currency for a specific date in exceptional timing.

You can try it yourself for free by signing up today.

HTTP Request

GET https://api.worldtradingdata.com/api/v1/forex_single_day

Query Parameters

This endpoint takes a single base currency and returns the conversion rate for all available currencies. The base, date, and api_token parameters are required for each request.

Parameter Default Required Description Options Example
base null true Value of the currency you wish to return data for. - base=USD
date null true Date you wish to return the conversion data for. - date=2018-08-31
api_token null true The API token associated with your account for authentication. Get your own free API token here. - api_token=demo
output json false Change output to CSV. csv, json output=csv
formatted true false Alter JSON data format. Does not affect CSV true, false formatted=false

Searching

Stocks and Indexes

GET https://api.worldtradingdata.com/api/v1/stock_search?search_term=SNAP&search_by=symbol,name&limit=50&page=1&api_token=demo

The above URL returns JSON structured like this:

{
    "total_returned": 5,
    "total_results": 5,
    "total_pages": 1,
    "limit": 50,
    "page": 1,
    "data": [
        {
            "symbol": "SNAP",
            "name": "Snap Inc.",
            "currency": "USD",
            "price": "13.52",
            "stock_exchange_long": "New York Stock Exchange",
            "stock_exchange_short": "NYSE"
        },
        ...
    ]
}

Our search endpoint allows you to search and filter our entire stock and index database to build your own search functionality for your applications.

You can try it yourself for free by signing up today.

HTTP Request

GET https://api.worldtradingdata.com/api/v1/stock_search

Query Parameters

Parameter Default Required Description Options Example
search_term null false Search term you wish to find stocks for. - search_term=SNAP
api_token null true The API token associated with your account for authentication. Get your own free API token here. - api_token=demo
search_by symbol,name false Search by only symbol or name, or both. symbol,name, symbol, name search_by=symbol,name
stock_exchange all false Filter by a comma seperated list of stock exchanges. any supported exchanges stock_exchange=NASDAQ,NYSE
currency all false Filter by a comma seperated list of currencies. any supported stock currencies currency=USD,AUD
limit 50 false Limit the number of results returned. 1-500 limit=50
page 1 false Value of the page you wish to see values for. - page=1
sort_by symbol false Sort by a specific column. symbol, name, currency, stock_exchange_long, stock_exchange_short, market_cap, volume, change_pct sort_by=symbol
sort_order 1 false Sort order of the sort_by column. asc, desc sort_order=asc
output json false Change output to CSV. csv, json output=csv

Lists

Stocks, Indices and Mutual Funds

GET https://api.worldtradingdata.com/api/v1/ticker_list?type=stocks&api_token=demo

The above URL returns JSON structured like this:

{
    "000001.SZ",
    "000002.SZ",
    "000003.SZ",
    "000004.SZ",
    "000005.SZ",
    "000006.SZ",
    "000007.SZ",
    ...
}

Our ticker list endpoint allows you to download our full lists of stocks and indices or mutual funds in one request. Please note that no demo is available for this endpoint.

You can try it yourself for free by signing up today.

HTTP Request

GET https://api.worldtradingdata.com/api/v1/ticker_list

Query Parameters

Parameter Default Required Description Options Example
type null true Return stocks and indices or mutual fund list. stocks, mutual_funds type=stocks
symbol_only true false Set to false to return other meta data along with the symbols. true, false symbol_only=false
api_token null true The API token associated with your account for authentication. Get your own free API token here. - api_token=demo
output json false Change output to CSV. csv, json output=csv

Plan limitations

Below is the number of weekly requests available on each of our plans. View more plan details here.

Plan name Weekly requests
Free 1
Basic 7
Standard 14
Plus 28
500K 56
750K 84
1M 112

Stock Exchanges

GET https://api.worldtradingdata.com/api/v1/exchange_list?api_token=demo

The above URL returns JSON structured like this:

{
    "AEX": {
        "stock_exchange_long": "Euronext Amsterdam",
        "timezone_name": "Europe/Amsterdam"
    },
    "ASX": {
        "stock_exchange_long": "Australian Securities Exchange",
        "timezone_name": "Australia/Sydney"
    },
    "BCBA": {
        "stock_exchange_long": "Buenos Aires Stock Exchange",
        "timezone_name": "America/Argentina/Buenos_Aires"
    },
    ...
}

Our exchange list endpoint allows you to download our full exchange list in one request. Please note that no demo is available for this endpoint.

You can try it yourself for free by signing up today.

HTTP Request

GET https://api.worldtradingdata.com/api/v1/exchange_list

Query Parameters

Parameter Default Required Description Options Example
api_token null true The API token associated with your account for authentication. Get your own free API token here. - api_token=demo
formatted true false Alter JSON data format. Does not affect CSV true, false formatted=false
output json false Change output to CSV. csv, json output=csv