Sending Signals - Email Method
For Service Providers
![]() |
Send Signals by Email |
With this integration method, Signals can be sent directly through your email account by entering your signal syntax and sending an email to signals (at) zignaly (dot) email |
2. Develop your Syntax
To build your Signals Syntax, we will establish the four components:
- First you need to have your Key
- Which type of Signal
- Mandatory parameters
- Optional Parameters
2.1. Key:
The key is what connects the signal with your service, to get your key, go to your provider page, In the edit tab you will find your key in the SignalURL (key=xxxx)
It's important that you don't share this key with anybody because it controls your service (sending buy/sell orders to the exchange)
2.2. Type
Every signal you send will need to specify the type of signal and enter this into your syntax:
type=entry
type=exit
As well as other options:
type=stop
type-start
type=disableMarket
type=enableMarket
type=panicSell
type=update
type=cancelEntry
type=reverse
*For more details on each of these please select click on the specific type to view the definition and conditions in our Signals article.
2.3. Mandatory Parameters
On each type you will see the mandatory fields applied to this type of Signal.
(Check in the ‘signals’ article what are the mandatory fields for each Type of Signal.)
Now we can build our Syntax off of this information:
(Key,Type, plus mandatory fields> exchange, pair, positionSizePercentage & signalId)
There are two different formats for composing the email: one parameterper line or separated by ||
One parameter per line:
key = YOURSECRETKEY
exchange=binance
type=entry
pair=QTUMBTC
Parameters separated by ||
||key=YOURSECRETKEY||exchange=binance||type=entry||pair=QTUMBTC||
Note the starting || and ending ||, that's to be sure the email doesn't add anything to the first or last parameter.
- With both formats, any parameter that is not recognized will be ignored.
Also, the system doesn't use the subject for anything.
Lets create a Type ‘entry’ signal (example only):
key = YOURSECRETKEY type=entry exchange=binance pair=ethbtc positionSizePercentage=10 SignalId=123 |
positionSizePercentage The percentage is from the configured value in the allocated balance setting. It has to be a value between 1 and 100. As always if the resulting position size is below the minimum allowed by the exchange, it will fail.
signalId An ID that you can use to identify the positions that have been opened from a specific buy signal. Later, if you want to act against those positions (selling, rebuying), you need to use the same ID.
2.4. Additional Parameters
If you would like to add additional parameters to this signal please review the other options under ‘Parameters’ on our Signals documentation. Be sure these parameters are permissible with the type of signal you are using.
Example: orderType=market
Other parameter options may include: stopLossPercentage, takeProfitPercentage, takeProfitAmountPercentage...
If trading futures, you will need to add 3 required parameters to this entry signal:
|
Now let assemble our entry signal to have our final completed Syntax:
Example only:
For Spot: | For Futures: |
key = YOURSECRETKEY type=entry exchange=binance pair=ethbtc orderType=market positionSizePercentage=10 SignalId=123 |
key = YOURSECRETKEY type=entry exchange=binance exchangeAccountType=futures pair=ethbtc orderType=market side=long leverage=2 positionSizePercentage=10 SignalId=123 |
Here is an example of an entry Syntax you would insert into your email:
Send your signal to signals (at) zignaly (dot) email
(the system doesn't use the subject field for anything)
3. VIDEO
Take a look at this quick video to see how simple this is:
Comments
0 comments
Please sign in to leave a comment.