Self Api and TradingView Webhook Tool

Easily receive and execute strategy alerts from TradingView. This tool enables automatic market order placements based on TradingView alerts and supports integration with third-party services via webhooks. It also provides the flexibility to run multiple strategies/markets simultaneously.

Conditions

A computing device (Cloud service, local PC) with a stable internet connection.
A TradingView Account with at least a Essential plan to enable Webhook notifications.
A blockchain wallet with private key (e.g., Metamask, Wallet).
A trading account with collateral (USDT, USDC) already in the wallet and ETH for pay gas fees.

Features

Receive and execute market orders based on TradingView strategy alerts.
Place orders using webhooks from third-party services.
Supports multiple strategies/markets concurrently.

Security

Use of environment variables to safeguard sensitive information.
Implementation of a passphrase authentication between TradingView alerts and your web server.

Setup Steps

Web Server Setup:
- Set up a web server (local or cloud). We recommend using Render.
- Create a web service on Render, synchronize with your GitHub repository, configure the environment, and obtain a webhook.

Environment Configuration:

# Required variables
WALLET_PRIVATE_KEY=
TYPE_NETWORK=testnet

Setting TradingView Alerts:

Configure an alert on the TradingView website with the following format:

{ 
"exchange": "deperp", 
"strategy": "test", 
"asset": "USDT", 
"market": "ETH-USD", 
"size": "120", 
"leverage": "5", 
"reverse": true, 
"order": "{{strategy.order.action}}", 
"position": "{{strategy.market_position}}", 
"price": "{{strategy.order.price}}", 
"passphrase": "" 
}

Running the Tool:

npm run start

API Endpoints:

Post Sell (Short):

curl -X POST https://yourwebhook.com/api/endpoint -H "Content-Type: application/json" -d '{
"exchange": "deperp",
"strategy": "test",
"asset": "USDT",
"market": "BTC-USD",
"size": "110",
"leverage": "5",
"reverse": false,
"order": "sell",
"passphrase": ""
}'

Post Buy (Long):

curl -X POST https://yourwebhook.com/api/endpoint -H "Content-Type: application/json" -d '{
"exchange": "deperp",
"strategy": "test",
"asset": "USDT",
"market": "BTC-USD",
"size": "110",
"leverage": "5",
"reverse": false,
"order": "buy",
"passphrase": ""
}'

Note: To close a long order, pass the "sell" parameter with the same quantity. Currently, only market orders are supported, stop limits and take profits you place as market orders from your strategies

oxowl / Deperp-Self-Api-v2