How do I access the API?

Fastmarkets customers will have their own API credentials to consume and process data. A unique Service Key and Service Name is issued by Fastmarkets which can be used when calling the Fastmarkets Authentication API to generate an Access Token. The returned Access Token (in the form of a JSON Web Token) is then needed for any subsequent calls to other Fastmarkets APIs (such as the Fastmarkets Physical Prices API) to verify that the calling service has the necessary permissions to view the requested data.

You can access Swagger UI technical documentation page with your Fastmarkets account. Details of your username and password will be sent in a welcome email. Once received you can click the top right Authorize button to login in.

Once authorized you can test requests and responses for each Endpoint, find example values, field descriptions and API response models, discover error messages for each Endpoint

You will receive a welcome email with details of your username and password as a technical user of the API which will provide access to the API Swagger UI to test requests and responses. 

Do you have any example requests?

Please use Fastmarkets API Postman collection of all APIs. You can add this collection to Postman application. Fill your API credentials (service name and service key) in collection variables and run test queries. In the Postman you can get example code snippets generated for any programming language as next:

You can also find integration user guides with Python code snippets included:

• Fastmarkets Physical Prices API,
• Fastmarkets News API,
• Fastmarkets Market Data API,
• Authentication API

How many technical users can have access to the Swagger UI?

At least 1 technical user is required to manage the service key(s). However, we understand that many of our customers require several technical or third party technical users to test requests and responses during implementation as well as regular maintenance of our API which may require support by several team members in different locations. Please request any additional technical users through through our contact page - Let’s get you some help 

Should any of your technical users change or leave please notify us.

Will my service name and service key change or be interrupted when our contract renews?

No, the service name and service key will remain the same at renewal. There is no need to amend any authentication to the API.
 

How do I regenerate the service key?

Should you require your service key to be regenerated for security or other reasons please contact us - Let’s get you some help.

Please note that the API will be unavailable until the new key is entered into your system.
 

Another business area requires access to Fastmarkets pricing via the API. Can we implement using the same service name and key?

Service keys should not be shared when implementing across different business teams or divisions for security and licensing reasons. Please contact your Account Manager or Customer Success team who can provide a separate service name and key as required.

Do you have a test environment?

We do not have a separate test environment for our APIs. Instead, we recommend testing the request and response using our Swagger UI before connecting using your service key to the production version of the API. This will require a named user access and is available to all technical users of the API. Should you require a separate test service name please contact us - Let’s get you some help.

What are API rate limits? What limitations are there on queries that can be made?

It is possible to request large sets of data via the Fastmarkets API by specifying multiple symbols/article IDs and date ranges. However, there are limits on what can be requested in a single API request. These are described as follows:

Authentication API: 5 requests per 10 minutes.
Physical Prices & Market Data API: Max symbols: 100, max dates: 10, max date range: 2 years.
News API: Max article IDs: 100.

Please note that historical time series will vary between symbols depending on launch date. To determine the start of the time series please refer to the “firstDate” field which can be requested in the GET /Instruments or GET /Prices endpoints.
 

Further Help