# 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 FinID
s if needed.
Use the query string parameter fin_id
to specify a market or markets. Some endpoints support multiple FinID
s in a single request. To specify multiple FinID
s 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 FinID
s 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 FinID
s 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.