This guide explains how to authenticate requests to the Advanced Trade WebSocket API server channels. It assumes that you have already created API keys.
Use the code samples below to generate/export a JSON Web Token (JWT) and make an authenticated request.
WebSocket JWTs (vs those for REST API) are not built with a request method or request path.
Regardless of which code snippet you use, follow these steps:
key name
and key secret
with your key name and private key. key secret
is a multi-line key and newlines must be preserved to properly parse the key. Do this on one line with \n
escaped newlines, or with a multi-line string.export JWT=...
.Your JWT expires after 2 minutes, after which all requests are unauthenticated.
The easiest way to generate a JWT is to use the built-in functions in our Python SDK as described below. Otherwise, use the code samples below to generate/export a JWT and make an authenticated request.
Install the SDK.
In the console, run: python main.py
(or whatever your file name is).
Set the JWT to that output, or export the JWT to the environment with export JWT=$(python main.py)
.
Most feed messages contain a sequence number. Sequence numbers are increasing integer values for each product, with each new message being exactly one sequence number greater than the one before it.
Sequence numbers that are greater than one integer value from the previous number indicate that a message has been dropped. Sequence numbers that are less than the previous number can be ignored or represent a message that has arrived out of order.
In either situation you may need to perform logic to make sure your system is in the correct state.
Even though a WebSocket connection is over TCP, the WebSocket servers receive market data in a manner that can result in dropped messages. Your feed consumer should be designed to handle sequence gaps and out of order messages, or should use channels that guarantee delivery of messages.
To guarantee that messages are delivered and your order book is in sync, consider using the level2 channel.
See Also: