Argix Labs
Documentation

Reference

Bot Builder Reference

Complete documentation for every block, rule, and concept in the Argix Labs bot builder. 40 blocks across 10 categories.

This documentation describes what each block does — not whether it will be profitable. All indicators are backward-looking. Trading involves risk of loss.

Overview

Core concepts behind the Argix Labs bot builder.

The bot builder is a visual tool for assembling trading strategies from modular blocks. It does not generate strategies for you — you decide the logic, the parameters, and the risk limits. The builder organizes your decisions into a tree structure that can be validated, backtested, and deployed to a broker. Understanding the execution model and block categories is essential before building.

Structural Blocks

Organize and allocate capital across branches of your bot tree.

Structural blocks do not contain trading logic themselves. They define how your strategy tree is organized, how capital is split between sub-strategies, and which assets each branch targets. A simple bot may not need any structural blocks beyond the root. Multi-asset or multi-strategy bots use Groups, Weights, and Asset blocks to manage complexity.

Flow Control

Conditional logic and branching blocks.

Flow-control nodes introduce conditional routing within the strategy graph: distinct subgraphs may be activated according to indicator predicates, temporal constraints, or user-defined expressions. They increase topological complexity; inclusion should be motivated by explicit branching requirements in the strategy specification.

Flow control: if/else splits execution into two branches, switch/case splits into multiple branches
Conditional blocks route execution through different strategy branches

Signals

Signal blocks express conditions the graph can react to. In many trees several signals feed the same branch with OR logic—whichever fires first can advance the pipeline.

In typical graph layouts, signal nodes appear upstream: they assert when an indicator condition—computed from historical price and volume—is satisfied. That assertion is a structural predicate within the execution model, not a forecast of return. Downstream nodes commonly apply filters, sizing, and risk constraints; this reference specifies measurement semantics and composition rules only, without recommending a particular trading style.

Filters

Filter blocks narrow when a branch may continue. On a path where several filters apply, AND logic means each one must pass before the graph advances.

Filters are applied downstream of signals: they cannot originate an entry condition; they only permit or deny transitions for predicates that have already evaluated true. A passing filter is a Boolean constraint, not a performance metric. Production graphs vary from dense gating (session, liquidity, volatility) to minimal structure; this section documents mechanics and failure modes only, without prescribing portfolio policy.

Entry & Exit

Entry blocks describe how an order is expressed when the graph reaches that step. Exit blocks describe how a flat is requested. Validator rules in Argix Labs expect one entry and at least one exit on deployable graphs; several exits behave as OR—first condition hit wins in the model.

Market orders prioritize time priority in the matching engine at the expense of price certainty; limit orders impose a price bound with nonzero non-fill probability. Stop-loss, take-profit, and hybrid exit nodes are frequently composed so that the first satisfied condition initiates closure; trailing stops ratchet protective stops with favorable drift. Executed prices remain subject to gap risk, partial fills, and venue-specific behavior independent of configured parameters.

Sizers & Risk

Position sizers determine how much capital each trade uses. Risk blocks enforce safety limits that cannot be disabled.

Position sizing controls how much of your account is allocated to each trade. Risk management blocks define hard limits on drawdown, daily loss, and exposure. The Risk block is always required and cannot be removed from any bot. No sizing method or risk limit can prevent all losses — they are tools for managing exposure, not guarantees against loss.

AI & Data Blocks

Data integration surface: live market-feed configuration plus deferred AI and HTTP connector documentation.

The Data Source node is supported in the v3 builder and specifies the origin of price and quote series consumed by downstream predicates. Artificial-intelligence and generic HTTP blocks listed below remain disabled in production builds; they are retained in documentation for product roadmap transparency. All external data paths introduce latency, rate limits, and availability risk; redundant sourcing should be evaluated where continuity requirements are stringent.

AI Agent

Maintenance

An LLM-powered decision node that processes context and produces signals, filters, or text outputs. You provide the system prompt that defines its behavior.

Chart Analysis

Maintenance

AI-based pattern recognition on price charts. Attempts to identify technical patterns (head & shoulders, flags, wedges) and generate signals from them.

News Sentiment

Maintenance

Monitors configured news sources and runs sentiment analysis on articles mentioning target assets. Outputs a sentiment score between 0 and 1.

API Request

Maintenance

Fetches data from an external HTTP API and makes it available to other blocks in the strategy. Supports REST endpoints with custom headers.

Math Expression

Maintenance

Evaluates a custom mathematical expression on available data. Compute custom indicators, ratios, or composite scores that are not available as built-in blocks.

Validation

Continuous structural verification of the strategy graph prior to simulation and deployment.

Validation executes incrementally as the graph is edited. It enumerates missing structural elements required by the current execution contract; it does not assess economic merit. Severities marked as blocking prevent deployment under present product rules; non-blocking notices indicate configurations that remain executable but may be inconsistent with implicit single-active-node assumptions (e.g. multiple entry nodes with one effective path). Neither category constitutes performance evaluation.

Best Practices

Practical guidance for building and testing strategies.

These are not guarantees of success — they are patterns observed by practitioners that tend to reduce common mistakes. Trading involves risk. No strategy, no matter how carefully constructed, is certain to be profitable. The following guidelines are intended to help you avoid well-known pitfalls.

This documentation describes the available tools and their parameters. It does not constitute financial advice. Past indicator behavior does not predict future results. You are solely responsible for your trading decisions and risk management.