Initialize Clock | Tradovate Partner API

Set the inital date and time for a market replay session.

Using a WebSocket connected to the Tradovate Market Replay URL, we can start a Market Replay Session which will simulate a given timeframe as if it were happening live. Each replay session creates a new replay account which gets discarded at the end of the replay session.

1 const URL = 'wss://replay.tradovateapi.com/v1/websocket'
2 
3 const myMarketReplaySocket = new WebSocket(URL)
4 
5 //simple WebSocket authorization procedure
6 myMarketReplaySocket.onOpen = function onOpen() {
7     myMarketReplaySocket.send(`authorize\n0\n\n${accessToken}`)
8 })
9 
10 const requestBody = {
11     startTimestamp: new Date('2018-04-30').toJSON(),
12     speed: 100, //100%, range is from 0-400%
13     initialBalance: 50000 //account balance for replay session
14 }
15 
16 myMarketReplaySocket.send(`replay/initializeclock\n1\n\n${JSON.stringify(requestBody)}`)
17 
18 myMarketReplaySocket.addEventListener('message', msg => {
19     const datas = JSON.parse(msg.data.slice(1))
20     if(datas) {
21         datas.forEach(({i, d}) => {
22             if(i && i === 1) { //sent id is 1, response id will be 1
23                 console.log(d) //=> { ok: true }
24             }
25         })
26     }
27 })

### Set the inital date and time for a market replay session. Using a WebSocket connected to the Tradovate Market Replay URL, we can start a Market Replay Session which will simulate a given timeframe as if it were happening live. Each replay session creates a new replay account which gets discarded at the end of the replay session. ```js const URL = 'wss://replay.tradovateapi.com/v1/websocket' const myMarketReplaySocket = new WebSocket(URL) //simple WebSocket authorization procedure myMarketReplaySocket.onOpen = function onOpen() { myMarketReplaySocket.send(`authorize\n0\n\n${accessToken}`) }) const requestBody = { startTimestamp: new Date('2018-04-30').toJSON(), speed: 100, //100%, range is from 0-400% initialBalance: 50000 //account balance for replay session } myMarketReplaySocket.send(`replay/initializeclock\n1\n\n${JSON.stringify(requestBody)}`) myMarketReplaySocket.addEventListener('message', msg => { const datas = JSON.parse(msg.data.slice(1)) if(datas) { datas.forEach(({i, d}) => { if(i && i === 1) { //sent id is 1, response id will be 1 console.log(d) //=> { ok: true } } }) } }) ```

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

startTimestampstringRequiredformat: "date-time"

speedintegerRequired0-400

initialBalancedoubleOptional

Response

SimpleResponse

okboolean

errorTextstring or null<=8192 characters

Non-empty if the request failed

Set the inital date and time for a market replay session.

1 const URL = 'wss://replay.tradovateapi.com/v1/websocket'
2 
3 const myMarketReplaySocket = new WebSocket(URL)
4 
5 //simple WebSocket authorization procedure
6 myMarketReplaySocket.onOpen = function onOpen() {
7     myMarketReplaySocket.send(`authorize\n0\n\n${accessToken}`)
8 })
9 
10 const requestBody = {
11     startTimestamp: new Date('2018-04-30').toJSON(),
12     speed: 100, //100%, range is from 0-400%
13     initialBalance: 50000 //account balance for replay session
14 }
15 
16 myMarketReplaySocket.send(`replay/initializeclock\n1\n\n${JSON.stringify(requestBody)}`)
17 
18 myMarketReplaySocket.addEventListener('message', msg => {
19     const datas = JSON.parse(msg.data.slice(1))
20     if(datas) {
21         datas.forEach(({i, d}) => {
22             if(i && i === 1) { //sent id is 1, response id will be 1
23                 console.log(d) //=> { ok: true }
24             }
25         })
26     }
27 })

1	curl -X POST https://demo.tradovateapi.com/v1/replay/initializeclock \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"startTimestamp": "2024-01-15T09:30:00Z",
6	"speed": 1
7	}'

1	const URL = 'wss://replay.tradovateapi.com/v1/websocket'
2
3	const myMarketReplaySocket = new WebSocket(URL)
4
5	//simple WebSocket authorization procedure
6	myMarketReplaySocket.onOpen = function onOpen() {
7	myMarketReplaySocket.send(`authorize\n0\n\n${accessToken}`)
8	})
9
10	const requestBody = {
11	startTimestamp: new Date('2018-04-30').toJSON(),
12	speed: 100, //100%, range is from 0-400%
13	initialBalance: 50000 //account balance for replay session
14	}
15
16	myMarketReplaySocket.send(`replay/initializeclock\n1\n\n${JSON.stringify(requestBody)}`)
17
18	myMarketReplaySocket.addEventListener('message', msg => {
19	const datas = JSON.parse(msg.data.slice(1))
20	if(datas) {
21	datas.forEach(({i, d}) => {
22	if(i && i === 1) { //sent id is 1, response id will be 1
23	console.log(d) //=> { ok: true }
24	}
25	})
26	}
27	})