This API consists of a protocol specification. Also included is a set of example programs used to illustrate implementation of the protocol to make websocket connections to Refinitiv Real-Time Distribution Systems, and, to Refinitiv Real-Time -- Optimized (RTO). RTO examples authenticate via Refinitiv Data Platform (RDP). These examples are built using certain widely available Websocket frameworks and follow the protocol specification to demonstrate how to setup a websocket connection and use message constructs to receive Refinitiv Real-Time content. This API is governed by the same Apache 2 open source license as defined in the LICENSE.md file.
Example Code Disclaimer: ALL EXAMPLE CODE IS PROVIDED ON AN “AS IS” AND “AS AVAILABLE” BASIS FOR ILLUSTRATIVE PURPOSES ONLY. REFINITIV MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, AS TO THE OPERATION OF EXAMPLE CODE, OR THE INFORMATION, CONTENT OR MATERIALS USED IN CONNECTION WITH EXAMPLE CODE. YOU EXPRESSLY AGREE THAT YOUR USE OF EXAMPLE CODE IS AT YOUR SOLE RISK
This release introduces oAuthClientCredentials authentication in Early Access in the Refinitiv Real-Time - Optimized (RTO) examples. A new RTO example written in Go has been added with support for oAuthClientCredentials. Please note that oAuthClientCredentials authentication method is available for preview only with ability to obtain Service Account credentials and use it, forthcoming.
These examples demonstrate the following usage:
- Connecting, logging in, and requesting a single item
- Requesting multiple items with a view in one message via a Batch Request
- Posting content to an item
- Logging in via Authentication
- Monitoring connection health via Ping messages
The examples are found under the Applications/Examples folder. Examples are provided in the following languages:
- C#
- Java
- Python
- Perl
- Node.js
- Go
- R
- Ruby
More details for each example are included in a README.md file in its respective folder.
These are examples written in Python, CSharp, Go and Java that demonstrate consuming content from Refinitiv Real-Time - Optimized (RTO).
The examples are found in the Applications/Examples/RDP folder with language specific sub-folders. More details are included in a README.md file in each example folder.
- Authenticating via RDP, Connecting to a Refinitiv Real-Time service available in RTO, and requesting a single item; examples handle session management or abiltiy to re-authenticate to renew authentication tokens
- Discover which RTO endpoint to connect to by making a service discovery request to RDP and using this information to connect to RTO to receive Real-Time content.
IMPORTANT NOTE: When specifying a 'region' as input to RDP Service Discovery applications, please consult [RTO documentation available on Refinitiv Developer Community] (https://developers.refinitiv.com/en/api-catalog/refinitiv-real-time-opnsrc/refinitiv-websocket-api/documentation) for a valid list of available regions. Default has been changed to "us-east-1" for region in sample applications starting with tag WSA-1.1.7.
In the event you would like to contribute to this repository, it is required that you read and sign the following:
Please email a signed and scanned copy to sdkagreement@refinitiv.com. If you require that a signed agreement has to be physically mailed to us, please email the request for a mailing address and we will get back to you on where you can send the signed documents.
Documentation for the WebSocket API and a Question & Answer forum are available at the WebSocket API Section of the Refinitiv Developer Community.
Issues raised via GitHub will be addressed in a best-effort manner. For broad questions regarding Websocket API, please refer to documentation and Q&A forum on Developer Community which is supported by an existing active community of API users.
