# List 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. Use the List Markets endpoint to get this information programmatically.
TIP
You can also browse our data coverage to see what's available.
After looking through the list of all markets you may still be unsure which FinID
to use. Contact our team and we'll be happy to assist with mapping the FinID
s.
You can also use the market details endpoint to get more information about a market. In the details there is a memo
field which described the securities that fall under a FinID
.
# MICs (Market Identification Codes)
We include segment MIC
in the response to help you finding the appropriate FinID
.
However, MIC
s alone are not granular enough to identify distinct trading schedules and calendars.
That is why we use FinID
, a proprietary market identifier.
In order to find the correct FinID
, look at exchange
, market
, and product
.
Note
If you need help determining which FinID
to use, contact us. We'll be happy to help.
# Example
https://api.tradinghours.com/v3/markets
https://api.tradinghours.com/v3/markets?group=core
https://api.tradinghours.com/v3/markets?group=extended
https://api.tradinghours.com/v3/markets?format=csv
# Response
{
"data": [
{
"fin_id": "AE.ADX",
"exchange": "Abu Dhabi Securities Exchange",
"market": null,
"products": null,
"mic": "XADS",
"asset_type": "Equities"
},
{
"fin_id": "AE.DFM",
"exchange": "Dubai Financial Market",
"market": null,
"products": null,
"mic": "XDFM",
"asset_type": "Equities"
},
{
"fin_id": "AE.NDXB",
"exchange": "NASDAQ Dubai",
"market": null,
"products": null,
"mic": "DIFX",
"asset_type": "Equities"
},
...
],
}