https://github.com/factset/enterprise-sdk-eventdriven-factsettrading-java
https://github.com/factset/enterprise-sdk-eventdriven-factsettrading-java
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/factset/enterprise-sdk-eventdriven-factsettrading-java
- Owner: factset
- License: apache-2.0
- Created: 2023-05-11T07:01:09.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2026-04-09T05:56:29.000Z (3 months ago)
- Last Synced: 2026-04-09T07:36:38.727Z (3 months ago)
- Language: Java
- Size: 151 KB
- Stars: 1
- Watchers: 4
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# FactSet Trading event-driven client library for Java
[](https://search.maven.org/artifact/com.factset.sdk.eventdriven/factsettrading)
[](https://www.apache.org/licenses/LICENSE-2.0)
This repository contains an event-driven api client for the FactSet Trading API
## Requirements
* Java JDK >= 1.8
## Installation
### Maven
Add the below dependency to the project's POM:
```xml
com.factset.sdk.eventdriven
factsettrading
2.0.1
```
### Gradle
Add these dependencies to your project's build file:
```groovy
repositories {
mavenCentral()
}
dependencies {
implementation "com.factset.sdk.eventdriven:factsettrading:2.0.1"
}
```
### Snapshot Releases
To be able to install snapshot releases of the sdk an additional repository must be added to the maven or gradle config.
#### Maven Snapshot Repository
```xml
sonatype
sonatype-snapshot
https://central.sonatype.com/repository/maven-snapshots/
true
false
```
#### Gradle Snapshot Repository
```groovy
repositories {
mavenCentral()
maven {
url = uri("https://central.sonatype.com/repository/maven-snapshots/")
mavenContent {
snapshotsOnly()
}
}
}
```
Snapshot releases are cached by gradle for some time, for details see: [Gradle Dynamic Versions](https://docs.gradle.org/current/userguide/dynamic_versions.html#sub:declaring_dependency_with_changing_version)
## Usage
1. [Generate OAuth 2.0 authentication credentials](https://developer.factset.com/learn/authentication-oauth2).
2. Setup Java environment.
1. Install and activate Java 1.8+
2. Install [gradle](https://gradle.org/install/)
3. [Install dependencies](#installation).
4. Run the following code:
```java
package com.factset.sdk.console;
import com.factset.sdk.eventdriven.factsettrading.OrderUpdateApi;
import com.factset.sdk.eventdriven.factsettrading.model.OrderSubscriptionRequest;
import com.factset.sdk.utils.authentication.ConfidentialClient;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.time.Duration;
import java.util.Collections;
import java.util.List;
public class Console {
private static final Logger logger = LoggerFactory.getLogger("main");
public static void main(String[] args) throws Exception {
ConfidentialClient confidentialClient = new ConfidentialClient("/path/to/config/file");
// initialize the websocket client
WebsocketApiClient client = new WebsocketApiClient(
WebsocketApiClient.Options.builder()
.url("https://api.factset.com/streaming/trading/ems/v0")
.authorizer(confidentialClient)
.maximumIdleInterval(Duration.ofSeconds(30))
.build()
).connectAsync().join();
// initialize the order update api
OrderUpdateApi api = new OrderUpdateApi(client);
// subscribe to order updates
OrderSubscriptionRequest.Subscribe subscribe = OrderSubscriptionRequest.Subscribe.builder()
.inboundOrders(true)
.parentOrders(true)
.childOrders(true)
.inboundMessages(true)
.childMessages(true)
.build();
OrderSubscriptionRequest request = new OrderSubscriptionRequest(subscribe);
Subscription subscription = api.subscribeOrderUpdates(request)
.onSnapshotEvent((snapshotEvent) -> {
// clients logic of handling the snapshotEvent message goes here
logger.info(snapshotEvent.toString());
})
.onTradeEvent((tradeEvent) -> {
// clients logic of handling the tradeEvent message goes here
logger.info(tradeEvent.toString());
})
.onError((exception) -> {
logger.error(exception.toString());
})
.subscribe()
.join();
// wait
Thread.sleep(10000);
// cancel the subscription
subscription.cancel();
// close the websocket connection
client.disconnectAsync().join();
}
}
```
## Contributing
Please refer to the [contributing guide](CONTRIBUTING.md).
## Logging
All logger names start with "com.factset".
This library uses [SLF4J](https://www.slf4j.org/) as logging interface,
which requires a [binding](https://www.slf4j.org/manual.html#swapping) to your logging framework on the classpath.
If no binding is found, SLF4J prints out the following warning and then defaults to a no-operation
implementation, which discard all logs:
```text
SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.
```
## Installation into local maven repo
```sh
./gradlew publisToMavenLocal
```
## Copyright
Copyright 2023 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.