Find Markets

List All Markets

To start using the API, you first need to know the FinID for the market or markets you're interested in. To find this, you can use this List Markets endpoint to get the information programmatically. Alternatively, you can use the MIC and our system will select the closest matching FinID and return the appropriate information.

Tip

You can also browse our data coverageopen in new window to see what markets are available.

You can also use the market details endpoint to get more information about a market. In the details, there is a memo field that describes in detail the securities that are covered by a FinID.

MICs (Market Identification Codes)

We include segment MIC in the response to help you find the appropriate FinID. Typically, MICs alone are not granular enough to identify distinct trading schedules and calendars. That is why we created FinIDs - an identifier that uniquely identifies each distinct trading schedule. If you use MIC in place of the FinID, our system will select the closest match.

In order to find the correct FinID, look at exchange, market, and product.

We're here to help!

If you need help determining which FinID to use, contact us. We'll be happy to help.

Schema

FieldFormatDescription
fin_idStringThe FinID for the market.
exchangeStringThe exchange name of the market.
marketStringThe name of the market.
productsStringDescription of the products or securities group.
micStringThe MIC for the market.
asset_typeStringDescribes the asset type of the market.
groupStringDescribes which market tier the market is included in.

Query String Parameters

Supported query string parameters are listed in the table below:

ParameterSupported ValuesDefaultDescription
groupCore, Extended, All, AllowedAllSpecify which group of markets to show. "Allowed" will show all markets you are permitted to access.
formatCSV, JSONJSONSpecify output format

Examples

Remember to use your authentication token for all requests.

Get All Markets

https://api.tradinghours.com/v3/markets

Get All Core Markets

https://api.tradinghours.com/v3/markets?group=core

Get Extended Markets

https://api.tradinghours.com/v3/markets?group=extended

Get All Markets in CSV Format

https://api.tradinghours.com/v3/markets?format=csv

Sample JSON Response

{
    "data": [
        {
            "fin_id": "AE.ADX",
            "exchange": "Abu Dhabi Securities Exchange",
            "market": "Abu Dhabi Securities Exchange (ADX)",
            "products": null,
            "mic": "XADS",
            "asset_type": "Securities",
            "group": "Extended"
        },
        {
            "fin_id": "AE.DFM",
            "exchange": "Dubai Financial Market",
            "market": "Dubai Financial Market (DFM)",
            "products": null,
            "mic": "XDFM",
            "asset_type": "Securities",
            "group": "Extended"
        },
        {
            "fin_id": "AE.NDXB",
            "exchange": "NASDAQ Dubai",
            "market": "NASDAQ Dubai (Equities)",
            "products": null,
            "mic": "DIFX",
            "asset_type": "Securities",
            "group": "Extended"
        },
        ...
    ],
}

Lookup / Search Markets

The "Lookup Markets" endpoint allows you to search for markets based on any attribute such as exchange name, market name, security description, MIC, or country.

Each unique trading schedule or trading calendar is identified by a unique "FinID." Most exchanges have several different trading schedules for equities, bonds, futures, etc. In total, we track over 900 different trading schedules.

This API allows you to easily search for the exact trading calendar you need.

Schema

The response schema for the Lookup API is the same as the List Markets API above.

Query String Parameters

Supported query string parameters are listed in the table below:

ParameterSupported ValuesDefaultDescription
qAnyN/AFree-form search field
groupCore, Extended, All, AllowedAllSpecify which group of markets to show. "Allowed" will show all markets you are permitted to access.
formatCSV, JSONJSONSpecify output format

Examples

Remember to use your authentication token for all requests.

https://api.tradinghours.com/v3/markets/lookup?q=hong+kong
https://api.tradinghours.com/v3/markets/lookup?q=new+york
https://api.tradinghours.com/v3/markets/lookup?q=usd