External Signal Integration

Use webhooks when an external system needs to send a trading signal into Vantixs. This is the connector-lite path for TradingView alerts, scripts, scanners, or signal providers without installing server adapters into the hosted stack.

How It Fits

External signal flow

Source emits a signal

TradingView, a script, or another service sends an HTTP POST to your Vantixs webhook URL.

Vantixs validates the request

Token, payload shape, action, symbol, and configured mode are checked.

Signal is queued and audited

Accepted signals are processed asynchronously and logged with status.

Risk controls run

Sizing, credential, account, and strategy constraints are applied before any action.

Paper or supported execution continues

The signal either routes directly to risk checks or through a saved strategy pipeline, depending on webhook mode.

Payload Validation

Webhook payloads should be explicit and minimal. At minimum, include the action and symbol expected by the webhook configuration:

json

{
  "action": "buy",
  "symbol": "BTCUSDT"
}

Vantixs may reject signals when:

The token is invalid or expired.
The payload is malformed or missing required fields.
The symbol or action is unsupported.
The configured strategy or exchange credential is unavailable.
Risk checks, preflight, or account constraints fail.

Credential and Live-Risk Constraints

External signals do not bypass account safety. Webhooks use the exchange credential, sizing mode, strategy mode, and risk controls configured in Vantixs. Use scoped API keys, avoid withdrawal permissions, and review live-readiness constraints before connecting signals to any real-capital workflow.

Auditability

Every received signal should be traceable:

Original payload and timestamp.
Webhook configuration and routing mode.
Accepted, executed, rejected, failed, or replayed status.
Rejection or failure reason where available.
Replay history for operational testing.

For arbitrary external services, keep Vantixs as the controlled ingress point. Do not depend on unsupported server adapters or hidden connector code.