I.Introduction
Before Ticker Tocker, we understand that many traders have a platform of their choice when create strategies and execute trades. With Ticker Tocker’s release, we make it easy for you to keep your current strategies in your existing platforms and send buy and sell signals generated from your existing strategies.
In this document, we will cover how you can send to Ticker Tocker buy and sell signals from your current platforms.
II. Support 3rd Party Platforms
TradeStation (via email only)
NinjaTrader
Sierra Chart
MetaTrader5
Quantopian
Note, as long as your current platform allows you to send HTTP POST request or send email from your custom strategies, then you can send your signals to Ticker Tocker.
III. Assumptions
This documentation assumes that you are familiar with one or more supported 3rd party platforms and that you have custom strategies created in one or more of these existing platforms. Creating custom strategies in the list of supported platforms is out of the scope of this documentation.
While Ticker Tocker’s strategy creator Drag & Drop requires no knowledge of coding, we assume that if you or your team has created custom strategies using any of the supported 3rd party platforms, you have basic knowledge of coding required for the rest of the documentation. We have sample code written in the respective languages (ninjascript, mq5…etc) of the supported 3rd party platforms.
IV. Submitting Trade Signals to Ticker Tocker
There are two ways to submit your trade signals to Ticker Tocker:
1. Through email
2. Through REST API
a. Email format for sending trade signals to Ticker Tocker
To enable this, please make sure you first configure your Ticker Tocker account, detailed in section IV.c.
To send your trade signal through email, please make sure you do the following when emailing:
Send To Address: ttexternalsignals@tickertocker.com
Subject Line: Strategy=<YOUR UDID>
Trade fields to be in body:
StrategyUUID=alpha-numeric
Symbol=alpha-numeric
Quantity=double
OrderSide=<0,1,2,3>
OrderType=<0,1,2,3>
TimeInForce=<1,3,5>
LimitPrice=double
StopPrice=double
TargetPrice=double
StopLossPrice=double
Where:
OrderType Values:
Market=0,
Limit=1,
StopMarket=2,
StopLimit=3
OrderSide Values:
Buy=0,
Sell=1,
SellShort=4,
BuyToCover=6
TimeInForce Values:
DayRegularSession = 1,
GoodTillCancelRegularSession = 2,
GoodTillDate = 5
In the email body, each line represents 1 trade signal.
Examples:
StrategyUUID=B764310E-5C9C-4012-8A5FD46F37E9258D,Symbol=QQQ,Quantity=100.00,OrderSide=0,OrderType=0,LimitPr ice=0,StopPrice=0,TargetPrice=161.0840,StopLossPrice=160.0160,TimeInForce=1
b. Through REST API
Other than email, Ticker Tocker also supports sending trade signals using proper formed JSON over HTTPS through POST.
REST API URL: https://prod-signals-api.tickertocker.com
POST /signals/login
The request payload requires the following information
• secretKey - this is the text that you got in step IV.b above
• leaderUserName - this is your Ticker Tocker user name
• leaderPassword - this is your Ticker Tocker password
A successful request will respond with a session token. You need to add this session token as http header with the key "Security" on the succeeding request. The session token will expire in 5 mins and you need to login again to call renew_token to get a new session token.
Request Payload:
{
"secretKey": "string",
"leaderUserName": "string",
"leaderPassword": "string"
}
Response (Status 200)
{
"data": {
"sessionToken": "string"
},
"message": "string",
"errorCode": 0
}
POST /signals/new
With this API call, you need to have “Authorization” in the HTTP header. The value for “Authorization” field is the sessionToken you get from /signals/login or /signals/renew_token
Request Payload
{
"StrategyUUID": "string",
"Symbol": "string",
"Quantity": 0,
"OrderSide": 0,
"OrderType": 0,
"LimitPrice": 0,
"StopPrice": 0,
"TargetPrice": 0,
"StopLossPrice": 0,
"TimeInForce": 1,
"Expiry": "2018-12-12T01:18:01.529Z"
}
Valid Value for Payload Parameters:
OrderType Values:
Market=0,
Limit=1,
StopMarket=2,
StopLimit=3
OrderSide Values:
Buy=0,
Sell=1,
SellShort=4,
BuyToCover=6
TimeInForce Values:
DayRegularSession = 1,
GoodTillCancelRegularSession = 2,
GoodTillDate = 5
AssetClass Values:
Equity = 1,
Currency = 3,
Futures = 5
Response (Status 200) - For OrderSide=0 and OrderSide=4. Note ONLY OrderSide=0 and OrderSide=4 will return PositionId
{
"data": {
"PositionId": 39725,
"ErrorMessage": ""
},
"message": "OK",
"errorCode": -1
}
Response (Status 200) - For OrderSide=1 and OrderSide=6. Note for orders that will not return immediately (for example: Sell and Buy To Cover orders), position id will not be return. Even though there is an error message, as shown below, this is expected.
{
"data": {
"PositionId": 0,
"ErrorMessage": "Unable to get position Id"
},
"message": "OK",
"errorCode": -1
}Validation errors:
|
ErrorCode: 2005, Message: Account token is expired. User should reauthenticate to brokerage account. |
ErrorCode: 8059, Message: Stop loss price must be greater than limit price |
|
ErrorCode: 10404, Message: Instrument not found |
ErrorCode: 8060, Message: Take profit price must be less than limit price |
|
ErrorCode: 8003, Message: Symbol is empty |
ErrorCode: 8061, Message: Stop price must be greater or equal to market price |
|
ErrorCode: 8006, Message: Order side is incorrect |
ErrorCode: 8062, Message: Stop price must be less or equal to market price |
|
ErrorCode: 8007, Message: Order type is incorrect |
ErrorCode: 8063, Message: Stop price is not provided |
|
ErrorCode: 8008, Message: Time in force is incorrect |
ErrorCode: 8064, Message: Stop loss price must be greater than stop price |
|
ErrorCode: 8009, Message: Quantity cannot be negative or zero |
ErrorCode: 8065, Message: Take profit price must be less than stop price |
|
ErrorCode: 8010, Message: Account id cannot be negative or zero |
ErrorCode: 8066, Message: Stop loss price must be less than stop price |
|
ErrorCode: 8012, Message: Limit price cannot be negative or zero |
ErrorCode: 8067, Message: Take profit price must be greater than stop price |
|
ErrorCode: 8013, Message: Target price cannot be negative or zero |
ErrorCode: 8068, Message: Limit price must be greater than stop price |
|
ErrorCode: 8014, Message: Stop price cannot be negative or zero |
ErrorCode: 8069, Message: Limit price must be less than stop price |
|
ErrorCode: 8018, Message: Limit price is not provided |
ErrorCode: 8070, Message: Limit price must be less or equal to market price |
|
ErrorCode: 8025, Message: Expiry is empty |
ErrorCode: 8071, Message: Limit price must be greater or equal to market price |
|
ErrorCode: 8026, Message: Expiry should be future dateC:\knowvera\TTWebAPI\Controllers\IndicatorsController.cs |
ErrorCode: 10012, Message: Explicit contract is not active |
|
ErrorCode: 8027, Message: Target price is empty |
ErrorCode: 8072, Message: You are choosing to exit a position that has an existing working order. You need to cancel your existing order before placing your new order. |
|
ErrorCode: 8033, Message: You can't trade a continuous contract. Please submit an explicit contract to trade |
ErrorCode: 8074, Message: User can't create close on end of session positions |
|
ErrorCode: 8035, Message: There are no positions to close |
ErrorCode: 5066, Message: Strategy is not external |
|
ErrorCode: 8036, Message: Various messages based on scenario |
ErrorCode: 8055, Message: Stop loss price must be greater than market price |
|
ErrorCode: 8047, Message: Boxed Positions are not allowed |
ErrorCode: 8056, Message: Take profit price must be less than market price |
|
ErrorCode: 10002, Message: Market is not trading |
ErrorCode: 8057, Message: Stop loss price must be less than limit price |
|
ErrorCode: 2001, Message: This account does not support chosen Symbol |
ErrorCode: 8058, Message: Take profit price must be greater than limit price |
|
ErrorCode: 8053, Message: Stop loss price must be less than market price |
ErrorCode: 8054, Message: Take profit price must be greater than market price |
POST /signals/newtradeidea
This is used for submitting new trade ideas into TickerTocker
Request Payload
[
{
"Side": 0,
"Qty": 0,
"Symbol": "string",
"LimitPrice": 0,
"IsMarketOrderType": true,
"TargetPrice": 0,
"StopLossPrice": 0,
"Tif": "string",
"TifDate": "2019-10-02T18:10:20.006Z",
"TifDateTimeZoneOffset": 0
}
]
Valid Value for Payload Parameters:
Side:
Long=0
Short=1
Tif:
This is string field describing the name of trade idea
Qty:
Has to be 1 or higher
TargetPrice:
Has to be specified.
POST /signals/renew_token
Request Payload
{ "secretKey": "string" }
Response (Status 200)
{
"data":
{
"sessionToken": "string"
},
"message": "string",
"errorCode": 0
}
GET /signals/positionOrders
This call returns all orders for a given position.
Request Payload
{
"positionId": "long"
}
Response (Status 200)
{
"data": [
{
"AccountId": 0,
"BrokerAccountId": "string",
"CreationTime": "2019-05-06T14:22:36.131Z",
"CustomerOrderId": "string",
"DiscretionOffset": 0,
"DollarCostPerUnit": 0,
"ExecutionVenueName": "string",
"InstrumentId": 0,
"IsPositionOpenOrder": true,
"LastTradePrice": 0,
"LimitPrice": 0,
"LinkedId": "string",
"MarketSession": 0,
"OrderSide": 0,
"OrderSourceDestinationName": "string",
"OrderType": 0,
"PersonId": 0,
"RoutingDestination": "string",
"TimeInForce": 0,
"TimeToLiveMinutes": 0,
"TradeSignalId": 0,
"CumQty": 0,
"ExecutorOrderId": "string",
"Id": 0,
"LeavesQty": 0,
"OrderQty": 0,
"OrderState": 0,
"PositionId": 0,
"RejectText": "string",
"ReplacementOrderId": 0,
"Symbol": "string",
"BarCloseTime": "2019-05-06T14:22:36.132Z",
"OrderDescription": "string",
"StrategyUUID": "string",
"StrategyName": "string",
"AllocatedCapital": 0
}
],
"message": "string",
"errorCode": 0
}
Validation errors:
ErrorCode: 8060, Message: Invalid positionId or position not found
ErrorCode: 1404, Message: No open orders for this position
PUT /signals/replaceOrder
This call allows you to change quantity and / or price of an existing limit or stop order
Request Payload
{
"orderId": long,
"newQuantity": integer,
"newPrice": double
}
Request Payload
This request requires an empty payload
{}
Response (Status 200)
{
"data": "string",
"message": "string",
"errorCode": 0
}
Validation errors:
ErrorCode: 8060, Message: Invalid orderId or order not found
ErrorCode: 1404, Message: Too late to replace
GET /signals/{uuid}/performance
This call returns strategy performance (account balance, return on capital…etc) given a strategy uuid.
Request Parameter
uuid: string
Response (Status 200)
{
"data": {
"LongOpenPositionCount": 0,
"LongClosedPositionCount": 0,
"LongPositionCount": 0,
"ShortOpenPositionCount": 0,
"ShortClosedPositionCount": 0,
"ShortPositionCount": 0,
"TotalOpenPositionCount": 0,
"TotalClosedPositionCount": 0,
"TotalPositionCount": 0,
"AvailableFunds": 0,
"InitialFunds": 0,
"UnrealizedPerformance": 0,
"UnrealizedPerformancePercentage": 0,
"RealizedPerformance": 0,
"RealizedPerformancePercentage": 0,
"TotalPerformance": 0,
"TotalPerformancePercentage": 0,
"LongExposureDollars": 0,
"ShortExposureDollars": 0,
"LongPerformance": 0,
"ShortPerformance": 0,
"StrategyType": 0,
"PercentReturnOnInitialCapital": 0,
"CapitalChange": 0
"AccountBalance": 0,
"VerifiedTradeMDDailyReturn": 0
},
"message": "string",
"errorCode": 0
}
Validation errors:
ErrorCode: 1000, Provided id is not GUID
ErrorCode: 5013, Strategy performance not found
GET /signals/strategyPositions
This calls returns all positions given a strategy uuid.
Request Parameter
strategyUUID: string
Response (Status 200)
{
"data": [
{
"Id": 0,
"PersonId": 0,
"AccountId": 0,
"BrokerAccountNumber": "string",
"InstrumentId": 0,
"InstrumentDescription": "string",
"RunningSetId": 0,
"TradeSignalId": 0,
"PositionCreationTime": "2019-05-06T14:22:36.125Z",
"StrategyName": "string",
"TradePriceMultiplier": 0,
"InstrumentType": 0,
"TickerSymbol": "string",
"ContractSize": 0,
"CurrencyConversionRate": 0,
"EntrySide": 0,
"TotalEntryQuantity": 0,
"PositionEntryTime": "2019-05-06T14:22:36.125Z",
"TotalEntryValue": 0,
"TotalExitQuantity": 0,
"PositionExitTime": "2019-05-06T14:22:36.125Z",
"TotalExitValue": 0,
"PositionStatus": 0,
"AdjustedSignalPrice": 0,
"PriceBasedAreActualValues": true,
"PriceBasedAverageEntryPrice": 0,
"PriceBasedPositionEntryTime": "2019-05-06T14:22:36.125Z",
"PriceBasedTotalEntryQuantity": 0,
"PriceBasedTotalEntryValue": 0,
"IntendedEntryQuantity": 0,
"EntryOrderType": 0,
"EntryOrderLimitPrice": 0,
"ExitOrderType": 0,
"ExitOrderLimitPrice": 0,
"ExitOrderTif": 0,
"IsVerifiedTrade": true,
"LastPrice": 0,
"PreviousClosePrice": 0,
"StrategyUuid": "string",
"Side": 0,
"TIF": 0,
"AvgPriceOut": 0,
"OpenQty": 0,
"Performance": 0,
"AccountTradeInRoundLotRequired": true,
"AccountOrderSizeInLots": true,
"AccountRoundLotSize": 0,
"CancelOnTargetHit": true,
"CloseEndNextSession": true,
"Leverage": 0
}
],
"message": "string",
"errorCode": 0
}
Sample Code for Supported Platforms
Note - samples below are created for guidance only. It worked and compiled at the time of creation, but we do not guarantee that it will work as platforms changes and updates.
Quantopian
#!/usr/bin/env python
import requests
import json
#login and get a token
data={
"secretKey": "YOUR-SECRETY-KEY",
"leaderUserName": "YOUR-TICKERTOCKER-USERNAME",
"leaderPassword": "YOUR-TICKERTOCKER-PW"
}
endpoint="https://prod-signals-api.tickertocker.com:443/signals/login"
r = requests.post(endpoint,data)
content= json.loads(r.content)
token = content.get('data').get('sessionToken')
if token :
# Send signal
data={
"StrategyUUID": "YOUR-UUID-HERE",
"Symbol": "NFLX",
"Quantity": 100,
"OrderSide": 0,
"OrderType": 1,
"LimitPrice": 350.0,
"TargetPrice": 370.0,
"StopLossPrice": 349.0,
"TimeInForce": 1,
"Expiry": "2018-12-07T19:19:11.321Z"
}
endpoint="https://prod-signals-api.tickertocker.com:443/signals/new"
headers={
"Authorization": "Bearer " + token,
"Accept": "application/json",
"Content-Type": "application/json"
}
r = requests.post(endpoint,data=json.dumps(data),headers=headers)
content= json.loads(r.content)
errorCode = content.get('errorCode')
if errorCode != -1:
print('Something went wrong:')
print('Reponse from server:')
print(r.status_code)
print(r.headers)
print(r.content)
else:
print('"Signal accepted"')
else :
print("Authorization failed")
NinjaTrader
//add this line to the using section of your strategy
using System.Net.Http;
private void sendTestSignal()
{
var loginData = new Dictionary<string, string>
{
{"secretKey", "YOUR-SECRETY-KEY" },
{"leaderUserName", "YOUR-TICKERTOCKER-USERNAME" },
{"leaderPassword", "YOUR-TICKERTOCKER-PW" }
};
var endpoint = "https://debug-prod-signals-api.tickertocker.com:443/signals/login";
var loginResponse = SendPost(endpoint, loginData).GetAwaiter().GetResult();
if (!string.IsNullOrEmpty(loginResponse))
{
//you can use your own json deserializer here but for a sample code not referencing any library, we can get the token from
//the json structured response string with a brute force search. Feel free to replace the parsing part with something like Newtonsoft json library
// dynamic loginResponceDynamic = JsonConvert.DeserializeObject(loginResponse);
// var token = (string)loginResponceDynamic.data.sessionToken;
var token = GetSessionTokenFromResponse(loginResponse);
Log("*** Token:{" + token + "}",LogLevel.Information);
var requestData = new Dictionary<string, string>
{
{ "StrategyUUID", "YOUR-UUID-HERE" },
{ "Symbol", "NFLX" },
{ "Quantity", "100" },
{ "OrderSide", "0" },
{ "OrderType", "1" },
{ "LimitPrice", "350.0" },
{ "TargetPrice", "370.0" },
{ "StopLossPrice", "349.0"},
{ "TimeInForce", "1" },
{ "Expiry", "2018-12-07T19:19:11.321Z" }
};
var signalsEndpoint = "https://prod-signals-api.tickertocker.com:443/signals/new";
var signalResponse = SendPost(signalsEndpoint, requestData, token).GetAwaiter().GetResult();
if (!string.IsNullOrEmpty(signalResponse))
{
if (!string.IsNullOrEmpty(signalResponse))
{
Log("*** New signal submission response from Ticker Tocker: " + signalResponse, LogLevel.Information);
}
}
} else
{
Log("*** Authorization to Ticker Tocker failed", LogLevel.Information);
}
}
private static async Task<string> SendPost(string url, Dictionary<string, string> data, string token = null)
{
try {
using (HttpClient client = new HttpClient())
{
var content = new FormUrlEncodedContent(data);
if (!string.IsNullOrEmpty(token)) AddHeaders(client, token);
var response = await client.PostAsync(url, content);
if (!response.IsSuccessStatusCode) return null;
return await response.Content.ReadAsStringAsync();
}
} catch (Exception ex) {
Log("*** Request to Ticker Tocker failed: " + ex.Message, LogLevel.Information);
return null;
}
}
private static void AddHeaders(HttpClient client, string token)
{
client.DefaultRequestHeaders.Add("Authorization", "Bearer " + token);
client.DefaultRequestHeaders.Add("Accept", "application/json");
client.DefaultRequestHeaders.Add("ContentType", "application/json");
}
private string GetSessionTokenFromResponse(string response)
{
int startPos = response.IndexOf("sessionToken");
startPos = response.IndexOf('"', "sessionToken".Length + startPos + 1);
int endPos = response.IndexOf('"', startPos + 1);
return response.Substring(startPos+1, endPos-startPos-1);
}
MetaTrader5
#include <JAson.mqh>
//+------------------------------------------------------------------+
//| Script program start function |
//+------------------------------------------------------------------+
void OnStart()
{
CJAVal jv;
string headers;
int res;
string result_headers;
char data[], result[];
string token;
string str;
str="secret=YOUR-SECRET-KEY&leaderUserName=YOUR-TICKERTOCKER-USERNAME&leaderPassword=YOURTICKERTOCKER-PWD";
StringToCharArray(str, data);
// Login
res = WebRequest( "POST",
"https://prod-signals-api.tickertocker.com:443/signals/login",
headers,
NULL,
data,
result,
result_headers);
if (res != 200) {
Print("Authorization failed");
} else {
jv.Deserialize(result);
token = jv["data"]["sessionToken"].ToStr();
if ( token != "" ) {
// Send signal here
headers="Authorization: Bearer " + token;
str="StrategyUUID=YOUR-STRATEGY-UUID &Symbol=NFLX&Quantity=100&OrderSide=0&OrderType=1&LimitPrice=350.0&TargetPrice=370.0&StopLossPrice=349. 0&TimeInForce=1&Expiry=2018-12-07T19:19:11.321Z";
StringToCharArray(str, data);
res = WebRequest( "POST",
"https://debug-prod-signals-api.tickertocker.com:443/signals/new",
headers,
NULL,
data,
result,
result_headers);
if (res == 200) {
Print("Signal added");
} else {
Print("Something went wrong. Signal doesn't added");
}
} else {
Print("Can not get Token");
}
}
}
//+------------------------------------------------------------------+
SierraCharts
With SierraCharts, make sure you are on SierraCharts version 1852 or higher. Anything lower will not have support for MakeHTTPPOSTRequest that is needed to make POST requests.
#include "sierrachart.h"
// This line is required. Change the text within the quote
// marks to what you want to name your group of custom studies.
SCDLLName("Send signal to TT API")
//This is the basic framework of a study function. Change the name 'TemplateFunction' to what you require.
SCSFExport scsf_TT_send_request(SCStudyInterfaceRef sc)
{
if (sc.SetDefaults)
{
sc.GraphName = "Send signal to TT API";
const char* URL = "https://prod-signalsapi.tickertocker.com:443/signals/login";
// Login
sc.MakeHTTPPOSTRequest(URL, "secret=YOUR-TICKERTOCKER-KEY&leaderUserName= YOURTICKERTOCKER-USERNAME&leaderPassword= YOUR-TICKERTOCKER-PWD");
if (sc.HTTPResponse) {
const char* token = sc.HTTPResponse.GetSubString(108, 25);
SCString NEW_URL = "https://prod-signalsapi.tickertocker.com:443/signals/new?api_key=";
NEW_URL.Append(token);
const char* data = "StrategyUUID= YOUR-STRATEGYUUID&Symbol=NFLX&Quantity=100&OrderSide=0&OrderType=1&LimitPrice=350.0&TargetPrice=370.0&StopLossPrice= 349.0&TimeInForce=1&Expiry=2018-12-07T19:19:11.321Z";
// Send signal sc.MakeHTTPPOSTRequest(NEW_URL, data);
}
return;
}
}
TradeStation
TradeStation only supports sharing signals through email, not REST calls. In EasyLanguage, users can use the Pager_send() function to send Ticker Tocker signals
Here is an example:
content = "StrategyUUID=YOUR-STRATEGY-UUID,Symbol=" + Getsymbolname + ",Quantity=" + Numtostr(QtyVal, 0) + ",OrderSide=" + Numtostr(OrdSide, 0) + ",OrderType=" + Numtostr(OrdType, 0) + ",LimitPrice=0,StopPrice=0,TargetPrice=" + Numtostr( Tgt , 2) + ",StopLossPrice=" + Numtostr( Stp , 2) + ",TimeInForce=1";
print(Time, " ", Pager_send("ttexternalsignals@tickertocker.com", content));
Comments
0 comments
Article is closed for comments.