Connectors

Reference

Unique Webhook

Copy your unique URL from the Dashboard after creating an API.


                            https://zignalhub.com/api/{broker}/webhook/api-key/{KEY}?secret={SECRET}

Stock & Derivatives

SETTrade Open API

Integrate Thai stock and derivatives trading with Zignal Hub using the SETTrade Open API.

1 Prerequisites

✓ Application ID
✓ Application Secret
✓ Broker ID (e.g., 098 for Sandbox)

2 Webhook URL


                                https://zignalhub.com/api/settrade/webhook/api-key/{KEY}?secret={SECRET}

Payload Configuration (JSON)

settrade_payload.json

{
  "symbol": "S50H25",
  "side": "buy",
  "position_size": 1,
  "price": "",
  "price_type": "Limit",
  "comment": "My strategy"
}

Parameters

Field	Type	Description
symbol	string	Trading symbol Required
side	string	buy, sell, or cover Required
position_size	number	Order volume Required
price	string	Order price (use TradingView variables)
price_type	string	Limit, ATO, ATC, MP-MTL, MP-MKT
comment	string	Optional. Order comment sent to broker

Crypto Futures

Binance Futures

Trade cryptocurrency futures on the world's largest exchange.

1 Prerequisites

✓ Binance API Key
✓ Binance API Secret
✓ Futures Trading Enabled

Go to Binance → API Management → Create API → Enable Futures

2 Webhook URL


                                https://zignalhub.com/api/binance/webhook/api-key/{KEY}?secret={SECRET}

Rate Limits

• Order Rate: 10 orders/10s, 100 orders/min per account
• IP bans scale from 2 min to 3 days for repeat offenders
• View API Reference →

Payload Configuration (JSON)

binance_payload.json

{
  "symbol": "BTCUSDT",
  "side": "BUY",
  "type": "LIMIT",
  "quantity": 0.001,
  "price": "",
  "timeInForce": "GTC",
  "positionSide": "LONG",
  "comment": "My strategy"
}

Parameters

Field	Type	Description
symbol	string	Trading pair (e.g., BTCUSDT) Required
side	string	BUY or SELL Required
type	string	LIMIT, MARKET, STOP, TAKE_PROFIT
quantity	number	Order quantity Required
price	string	Limit price (required for LIMIT orders)
timeInForce	string	GTC, IOC, FOK, GTD
positionSide	string	LONG, SHORT, BOTH (for Hedge Mode)
reduceOnly	boolean	Set true to close position only
comment	string	Optional. Stored in API Activity log (not sent to broker)

Thai Crypto Exchange

Bitkub

Trade cryptocurrencies on Thailand's leading exchange. Execute THB-paired crypto orders from TradingView.

1 Prerequisites

✓ Bitkub API Key
✓ Bitkub API Secret
✓ KYC Verified Account

Go to Bitkub → Settings → API Management → Create New API

2 Webhook URL


                                https://zignalhub.com/api/bitkub/webhook/api-key/{KEY}?secret={SECRET}

Rate Limits

• Place Order: 150 req/sec
• Cancel Order: 200 req/sec
• Blocked for 30 seconds when limit exceeded (HTTP 429)
• View API Reference →

Payload Configuration (JSON)

bitkub_payload.json

{
  "sym": "btc_thb",
  "side": "buy",
  "amt": 1000,
  "rat": 1500000,
  "typ": "limit",
  "client_id": "my_ref",
  "comment": "My strategy"
}

Parameters

Field	Type	Description
sym	string	Trading pair (e.g., btc_thb) Required
side	string	buy or sell Required
amt	float	Amount (THB for buy, crypto for sell). No trailing zeros Required
rat	float	Rate/price. Set 0 for market orders. No trailing zeros
typ	string	limit or market
client_id	string	Your custom reference ID
post_only	boolean	Set true for maker-only orders
comment	string	Optional. Stored in API Activity log (not sent to broker)

Error Codes Reference

Common error codes you may encounter when using the API.

SETTrade Error Codes

Code	Description	Solution
401	Invalid credentials	Re-authenticate with broker
503	Service unavailable	SETTrade servers are down, retry later
SESSION_EXPIRED	Session expired	Reconnect from dashboard

Binance Error Codes

Code	Description	Solution
-1022	Signature invalid	Check API Secret is correct
-2014	API key not found	Verify API Key or create new one
-2015	Invalid API key, IP, or permissions	Check IP whitelist and permissions
-1021	Timestamp outside of recv window	Sync system time
-4131	Insufficient margin	Add more funds or reduce position size

Bitkub Error Codes

Code	Description	Solution
2001	Invalid JSON	Check payload format
2003	Invalid API Key	Verify API Key is correct
2005	Invalid signature	Check API Secret
3001	Insufficient balance	Add more funds
429	Rate limit exceeded	Wait 30 seconds before retry

SETTrade Open API

1 Prerequisites

2 Webhook URL

Payload Configuration (JSON)

Parameters

Binance Futures

1 Prerequisites

2 Webhook URL

Rate Limits

Payload Configuration (JSON)

Parameters

Bitkub

1 Prerequisites

2 Webhook URL

Rate Limits

Payload Configuration (JSON)

Parameters

Error Codes Reference

SETTrade Error Codes

Binance Error Codes

Bitkub Error Codes

Order Examples

Binance Futures Examples

Market Buy

Limit Sell

Close Long Position

Open Short (Hedge Mode)

Bitkub Examples

Market Buy (1000 THB)

Limit Buy

Sell 0.001 BTC

Post-Only Limit

FAQ