# 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.

Use the list markets endpoint to enumerate all markets. You can then use the market details endpoint to see specifics about which securities are including in a FinID. Our team is available to help mapping between specific securities and FinIDs if needed.

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.

# Examples

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 in a single request to avoid hitting restrictions.

# Formats

Our API supports JSON format and CSV format for most requests. Response format is JSON by default. To get a response in CSV format use the query string parameter format to specify the output format. Not all endpoints support CSV format. See the documentation on individual endpoints for details.

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

# 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 and error message 419: Too many requests.

# Bulk Requests

To avoid exceeding the rate limit, use bulk API requests when ever 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 headers to see how many requests you have left.