Sending signals - Email Method

Sending Signals - Email Method

For Service Providers

EMAIL signals

E-mail

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.

 


Check out this article for more ways to send signals: 3 ways to send your Signals to Zignaly

    1. Develop your Syntax
    2. Video

 

  1. 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

 

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)

 

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.

 

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 parameter per 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.

Let's 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.

 

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:
  • exchangeAccountType (This is required to specify futures)
  • side (You must use this field to identify a Long or Short position)
  • leverage (Enter your leverage amount, if not using enter 1)


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)

    1. VIDEO

Take a look at this quick video to see how simple this is:

Was this article helpful?
9 out of 12 found this helpful
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.