The FactSet Enterprise SDK is a collection of client libraries designed to make it easier to use FactSet's APIs in .NET, Java, Python and TypeScript/JavaScript (Node.js). For more information on what APIs are available and how to subscribe, please see the Developer Portal.
The FactSet Enterprise SDK is made up of two main components, API client libraries and utility libraries. The API client libraries are auto-generated for .NET, Java, Python and TypeScript/JavaScript using the OpenAPI Generator based on the OpenAPI specifications published on the Developer Portal. Whereas the utility libraries are handwritten and contain shared functionality that spans all APIs, such as authentication logic.
The auto-generated source code for the API client libraries can be found in the code/ directory of this repository, which contains language-specific sub-directories and API-specific sub-directories under each language (e.g. code/python/PAEngine).
| Language | Client libraries | Utility library |
|---|---|---|
| .NET | .NET source | .NET utilities |
| Java | Java source | Java utilities |
| Python | Python source | Python utilities |
| TypeScript/JavaScript | TypeScript/JavaScript source | TypeScript utilities |
- Software Development Kit (SDK) - A programming-language-specific group of client libraries that a FactSet customer can use to programmatically access FactSet content and analytics.
- Client library - a programming-language-specific module that contains a grouping of related logic. Each SDK is made up of one or more client libraries. When implementing an application or service that depends on FactSet APIs, a customer would leverage one or more client libraries.
- Package - a client library that has been built for distribution to customers, often through a package manager like PyPi, Maven Central, NuGet or NPM.
- Semantic Versioning - a common specification for versioning software, where a version number looks like
MAJOR.MINOR.PATCH(e.g.1.2.3).- MAJOR - incremented when there is a breaking change, like changing a response type adding a new required parameter or changing status codes.
- MINOR - incremented when functionality is added in a backward compatible way, like adding a new endpoint, adding new optional query string arguments or adding a new optional property to the request body.
- PATCH - incremented when a backwards-compatible bug fix is added, like fixing a typo in documentation.
Each API and utility library is published as its own package to the following package managers:
- .NET - NuGet (
FactSet.SDKprefix) - Java - Maven (
com.factset.sdkgroup ID) - Python - PyPI (
fds.sdkprefix) - TypeScript/JavaScript - npm (
@factset/sdkprefix)
Each library linked above in the overview section also contains embedded sample code to help with getting started.
The FactSet Enterprise SDK supports two forms of authentication, both must be setup through FactSet's Developer Portal.
Please refer to the contributing guide.
Copyright 2022 FactSet Research Systems Inc
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
