Custom Node Concepts
Custom nodes are a beta extension surface for defining reusable node behavior inside Vantixs when the feature is enabled for your account. They are not a way to install arbitrary server code into the hosted runtime.
Node Contract
Each custom node has a structured definition:
| Part | Purpose |
|---|---|
| Inputs | Typed ports that receive data from upstream nodes |
| Outputs | Typed ports that downstream nodes can consume |
| Parameters | User-configurable values validated by schema rules |
| Logic | Controlled expression, function, or visual logic supported by the product |
| Version | A version label and saved definition history for review and rollback |
Common port data types include values such as number, string, boolean, array, object, OHLCV, SIGNAL, ORDER, and POSITION. Exact availability depends on the enabled node surface.
Validation and Security Limits
Custom nodes must pass product validation before they can be used:
- Required inputs and outputs must be declared.
- Parameters must define valid types, defaults, ranges, enum values, or patterns where needed.
- Code or expression logic is screened for unsafe patterns.
- High-severity security issues block registration.
- Runtime behavior stays inside Vantixs sandbox and execution controls.
Do not assume custom nodes can access the network, filesystem, secrets, npm packages, exchange clients, or server-side hooks. If a workflow needs an outside signal, use webhooks.
Testing and Versioning
Treat custom nodes like strategy code:
- Save changes as a new version.
- Test the node in a draft strategy.
- Run backtests to check data shape and signal behavior.
- Use paper mode before relying on the node in an operational bot.
- Keep older versions available for comparison or rollback.
Marketplace and Review
Publishing or installing marketplace nodes depends on the beta marketplace surface and review policy. Public availability, verification badges, pricing, ratings, and install access may vary by account and release stage.
Marketplace review is a quality and safety gate, not a guarantee that a node is profitable or suitable for your market.