This page is concerned with providing you with information to set up live streaming.
We provide this API for you to subscribe to events related to your trading strategy. Using this API, you don't have to call our API over and over again. Instead, our backend will send a message to your code when something happens that you consider important for your strategy.
The Live Streaming API can be reached via:
Please use a Paper Trading API key to access this API for the time being. See Authentication for more information about the pending introduction of market data keys.
We will guide you through the API using small code snippets in JavaScript. If you prefer to just download the code and run with it, go ahead:
node.js [via GitHub]If you like to see an example added to this section, contact us on Slack or send an email to support@lemon.markets.
In order to access the live stream, you'll have to call the authorization endpoint of the Live Streaming API.
The authorization endpoint will provide you with all the information needed to set up a connection to Ably, our streaming partner.
Use the following URL to request an authentication token for Ably:
Specify your request as follows to retrieve an authentication token for the streaming SDK:
Set your Authorization header in the format Bearer {'YOUR-API-KEY'}
(see the example in the code snippet on the right)
Use this value to authenticate against the Ably streaming service.
Your token will be valid until this point in time (specified as milliseconds since the unix epoch).
Your user ID, used to subscribe to events as well as receive the events.
1import requests
2import json
3
4paper_trading_key = 'YOUR-PAPER-TRADING-KEY'
5request = requests.post("https://realtime.lemon.markets/v1/auth",
6 headers={"Authorization": f"Bearer {paper_trading_key}"})
7print(request.json())1{
2 "expires_at" : 1655856000084,
3 "token" : "_aarfg.Aq8KZTQlsv9n2RtDp9BKf4ZrXLvJW5JDn-bsX3hsLNcjrGaaIc",
4 "user_id" : "usr_qyJDQss5546j0bXjtWtLlRC3B4CNBdmg9V"
5}