How to Connect BingX API to AlgoWay

Prerequisites

BingX account with Perpetual Futures enabled.
AlgoWay account with access to Webhooks dashboard.
TradingView plan that supports webhooks.

For security, restrict your BingX API key to the AlgoWay IP you were provided in your dashboard. Do not enable withdrawals.

Step 1 — Create BingX API Key

Open API Management on BingX and click Create API Key. Set a label (e.g., TEST).

BingX Create API Key modal with permissions and IP whitelist — Create API Key → enable **Read**, **Spot Trading** (optional) and **Perpetual Futures Trading**. Add the trusted IP to the whitelist.

Confirm and copy both API Key and Secret Key (the secret is displayed once). Keep them safe.

BingX API key details page with Read/Spot/Perpetual and IP restriction — API key created. **Restrict access to trusted IPs only** must stay enabled.

Never enable Withdraw permission for AlgoWay. Keep trading-only permissions.

Step 2 — Add Main Webhook in AlgoWay

In AlgoWay Dashboard → Add Main Webhook.

AlgoWay Add Main Webhook form filled for BingX — Set **Platform** = BingX, **Market Type** = Futures/Perpetual, choose your **Trade Type** (e.g., Reverse). Paste **API Key** and **API Secret**.

Required fields

Platform: BingX
Quantity Multiplier: as needed (e.g., Absolute 1)
Market Type: Futures/Perpetual
Trade Type: your mode (e.g., Reverse)
API Key / Secret: from Step 1

Save the webhook. You will get a unique Webhook URL (UUID).

Step 3 — Create TradingView Alert

Open the chart of the instrument used on BingX Perpetual (e.g., BTCUSDT.P on 1h). Choose your indicator/condition.

TradingView Create Alert settings for BTCUSDT.P 1h — Select the symbol and the condition from your indicator. Choose interval and trigger policy.

In Notifications, tick Webhook URL and paste your AlgoWay link (from Step 2).

Step 4 — Webhook URL & JSON Payload

Webhook URL

Use the exact URL shown in AlgoWay after saving your webhook. Example:

https://algoway.co/1f104647-9848-493d-85d1-c6768676f717

Your UUID will be different. Do not share it publicly.

AlgoWay TradingView Alert Sample JSON modal — Copy the JSON template from AlgoWay and paste it into the TradingView alert message.

Message (JSON)

{
  "platform_name": "bingx",
  "ticker": "{{ticker}}",
  "order_contracts": "{{strategy.order.contracts}}",
  "order_action": "{{strategy.market_position}}",
  "price": "{{close}}"
}

Ticker mapping: keep symbols consistent with BingX Perpetual (e.g., BTCUSDT.P).

Verification & Logs

Create a small test alert (minimal size) and let it fire once.
In AlgoWay, open Webhook Log for the UUID and confirm the incoming JSON and the outgoing order status.
In BingX → Orders / Positions, verify that the order/position reflects your Trade Type and size.

If the order is not created, check: API permissions, IP whitelist, correct Webhook URL, JSON fields, and indicator firing logic.

FAQ / Notes

Permissions: only Read and Perpetual Futures Trading are required. Do not enable Withdraw.
IP Restriction: the API key must be limited to the AlgoWay IP given in your dashboard.
Trade Type: Reverse in AlgoWay will invert the direction relative to the signal if that’s your strategy requirement.
Alert Frequency: set Once per bar close for bar-close strategies to avoid intra-bar noise unless your logic requires otherwise.
Security: rotate API keys periodically and keep the Secret outside screenshots and chats.