How do I access the API?
Customers of Fastmarkets data will typically have their own services that will consume and process data. As such, authentication based on a single user’s credentials are not appropriate. Instead, 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.
Full technical documentation is provided through our Swagger UI which requires a named technical user access. 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. To access and authenticate to our API we will provide an auto-generated service name and a service key. Your service name and key can then be used in applications such as Postman to authenticate and generate an access token to then call our Physical Prices API from your system.
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 the Physical Prices API. 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.
Do you have any example requests?
Please see the links below for example request in JSON, C#, Java and Python.
Access the Fastmarkets Physical Prices API User Guide JSON version here
Access the Fastmarkets Physical Prices API User Guide C# version here
Access the Fastmarkets Physical Prices API User Guide Java version here
Access the Fastmarkets Physical Prices API User Guide Python version here
What limitations are there on the number of queries that can be made?
It is possible to request large sets of data via the Physical Prices API by specifying multiple symbols and date ranges. However, there are limits on what can be requested in a single API request. These are described as follows:
GET/Prices
Max Symbols: 100
Max Dates: 10 (if requesting latest prices there is no date limit)
GET Prices/History
Max Symbols: 100
Max Date Range: 2 years
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 end points.
Our technical documentation page provides detailed technical information about the Physical Prices API. This includes:
- Endpoint and parameter description
- Example requests and responses
- Model information with detailed descriptions of the response objects
- Example error codes and messages
Further Help
Further help
If you have more questions or need further support please look at all the help content available on our Support Hub. If you can't find what you need and want to contact our support teams then Let’s get you some help.
