Streams Direct WebSocket
Domains
Description | Testnet URL | Mainnet URL |
---|---|---|
WebSocket endpoint to subscribe to price updates | wss://ws.testnet-dataengine.chain.link/ | wss://ws.dataengine.chain.link |
Authentication
Headers
All routes require the following three headers for user authentication:
Header | Description |
---|---|
Authorization | The user’s unique identifier, provided as a UUID (Universally Unique IDentifier). |
X-Authorization-Timestamp | The current timestamp, with precision up to milliseconds. The timestamp must closely synchronize with the server time, allowing a maximum discrepancy of 5 seconds (by default). |
X-Authorization-Signature-SHA256 | The HMAC (Hash-based Message Authentication Code) signature, generated by hashing parts of the request and its metadata using SHA-256 with a shared secret key. |
WebSocket Connection
Establish a streaming WebSocket connection that sends reports for the given feedID(s) after they are verified.
Endpoint
/api/v1/ws
Type | Parameter(s) |
---|---|
WebSocket | feedIDs : A comma-separated list of Data Streams feed IDs. |
Sample request
GET /api/v1/ws?feedIDs=<feedID1>,<feedID2>,...
Sample response
{
"report": {
"feedID": "hex encoded feedId",
"fullReport": "a blob containing the report context + body, can be passed unmodified to the contract for verification"
}
}
Error response codes
Status Code | Description |
---|---|
400 Bad Request | This error is triggered when:
|
401 Unauthorized User | This error is triggered when:
|
500 Internal Server | Indicates an unexpected condition encountered by the server, preventing it from fulfilling the request. This error typically points to issues on the server side. |