// Overview

Orvex AI Documentation

The first autonomous trading agent powered by Binance AI. Orvex trades perpetual futures 24/7 using multi-timeframe technical analysis, AI confluence scoring, and adaptive self-learning — all within hard safety limits you configure once.

Quick Install
npx skills add https://orvex.trading/SKILL.md

Architecture

Every 30 seconds, the autonomous runner spins up a position monitor and per-symbol trade loops, each running the full pipeline before calling the Binance Futures API.

Trade Execution Flow
User          Orvex         Binance API     AI Engine
  |               |                |                |
  |──onboard()──> |                |                |
  |               |──fetchCandles()─>               |
  |               |<──candleData───|                |
  |               |                |                |
  |               |──────────evaluate()────────────>|
  |               |<─────────decision──────────────|
  |               |                |                |
  |               |──placeOrder()──>               |
  |               |<──confirmation─|                |
  |               |                |                |
  |               |──trailingStop()>               |
  |               |<──updated──────|                |
  |               |                |                |
  |<──report()──  |                |                |
  |               |                |                |
Pipeline Steps
┌─────────────┐   ┌──────────┐   ┌──────────────┐   ┌────────────┐   ┌───────────┐
│ Market Scan │──>│ TA Engine│──>│AI Confluence │──>│ Risk Check │──>│ Execution │
│  Candles    │   │ RSI,MACD │   │  Confidence  │   │  Leverage  │   │  Bracket  │
│  Multi-TF   │   │ BB, 12+  │   │  Threshold   │   │  Position  │   │  Orders   │
└─────────────┘   └──────────┘   └──────────────┘   └────────────┘   └───────────┘

Installation

Orvex is distributed as an OpenClaw skill. Add it to your agent with a single command:

terminal
$ npx skills add https://orvex.trading/SKILL.md

System Requirements

  • > Node.js >= 18
  • > curl, openssl, date (for Binance API auth)
  • > Binance API key + secret with Futures enabled

Required Binance Skills

Orvex depends on skills from the Binance Skills Hub. Install these before adding Orvex:

Core Trading
>
derivatives-trading-usds-futuresUSDS-M futures trading
npx skills add https://github.com/binance/binance-skills-hub/tree/main/skills/binance/derivatives-trading-usds-futures
>
spotSpot market trading
npx skills add https://github.com/binance/binance-skills-hub/tree/main/skills/binance/spot
>
algoAlgorithmic trading
npx skills add https://github.com/binance/binance-skills-hub/tree/main/skills/binance/algo
Market Intelligence
>
query-token-infoToken search and market data
npx skills add https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3/query-token-info
>
query-token-auditToken security audit
npx skills add https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3/query-token-audit
>
trading-signalOn-chain smart money signals
npx skills add https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3/trading-signal
>
crypto-market-rankMarket rankings and trends
npx skills add https://github.com/binance/binance-skills-hub/tree/main/skills/binance-web3/crypto-market-rank
Portfolio
>
assetsAsset management
npx skills add https://github.com/binance/binance-skills-hub/tree/main/skills/binance/assets
View All Binance Skills

Configuration

On first run, Orvex will prompt you to configure these parameters:

Parameter Description Default
BINANCE_API_KEYYour Binance API keyRequired
BINANCE_SECRET_KEYYour Binance secret keyRequired
TRADING_MODEtestnet or mainnettestnet
MAX_LEVERAGEMaximum allowed leverage5
APPROVED_SYMBOLSComma-separated symbol listBTCUSDT,ETHUSDT
BASE_INVESTMENTBase position size in USDT100
CONFIDENCE_THRESHOLDMin AI confidence (0-1)0.82
RISK_PER_TRADEMax risk as % of portfolio2

Safety Rules

Orvex enforces non-overridable safety constraints:

Hard Leverage Cap

Never exceeds MAX_LEVERAGE, regardless of signal strength.

Symbol Whitelist

Only trades pairs in your APPROVED_SYMBOLS list.

Position Sizing

Each trade risks at most RISK_PER_TRADE % of total portfolio.

Drawdown Circuit Breaker

Pauses trading if daily drawdown exceeds 5%.

Mandatory Stop-Loss

Every position has a stop-loss that cannot be removed.

Consent Required

Will not trade without explicit consent given at onboarding.

API Reference

Orvex exposes a REST API for monitoring trades and portfolio status.

GET/api/trades
Returns the latest 30 trades and current portfolio value.
Response: { trades: Trade[], portfolio: number }
GET/SKILL.md
Returns the SKILL.md manifest file for OpenClaw installation.