# API Details

# Identifying Markets

We use a proprietary code to identify all markets and trading venues in our system. This code is called a Financial Identifier, or FinID.

To obtain the FinId, use the list markets endpoint to enumerate all markets you have access to as part of your subscription. You can then use the market details endpoint to see specifics about which securities are included in a FinID.

The FinID is more specific than the standard Market Identifier Code, or MIC. However, you can use the MIC in place of the FinID, and our system will generate the best match. If you need help mapping securities and FinIDs, our team is available to help.

Use the query string parameter fin_id to specify a market or markets. Some endpoints support multiple FinIDs in a single request. To specify multiple FinIDs, separate them by a comma. Whenever possible, we recommend making bulk requests with multiple FinIDs to avoid hitting rate limit restrictions.

# Examples

Remember to use your authentication token for all requests.

https://api.tradinghours.com/v3/markets/details?fin_id=us.nyse
https://api.tradinghours.com/v3/markets/status?fin_id=us.nyse,jp.jpx

Notice

Our system does have rate limit restrictions. Specify multiple FinIDs or MICs in a single request to avoid hitting restrictions.

# Formats

Our API supports JSON format and CSV format for most requests. By default, if left unspecified, the response format is JSON.

To get a response in CSV format, use the query string parameter format to specify the output format.

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

Not all endpoints will support returning the data in CSV format. Please see the documentation on individual endpoints for details on which formats are supported.

# Rate Limits

Our API has rate limits to ensure system resources are available for all customers. The rate limit is not intended to restrict access. If you exceed the rate limit, you will receive an error message 419: Too many requests.

# Bulk Requests

To avoid exceeding the rate limit, use bulk API requests whenever possible. To send bulk API requests, specify multiple FinIDs in a single request.

https://api.tradinghours.com/v3/markets/status?fin_id=us.nyse,jp.jpx,gb.lse

Tip

You can always check the X-RateLimit-Limit and X-RateLimit-Remaining response headers to see how many requests you have left.