VTX Insights

Connect Codex, Claude Code, Cursor, GitHub Copilot, Google Antigravity, OpenCode, OpenClaw, Hermes Agent, or another compatible harness to power VTX bot inference or perform deep trade-chain analysis.

Agent operating guide

Start with the machine-readable contract, then use the live capability registry to analyze evidence, operate bots, and verify the result.

Power bot inference

Use the connected harness as the live inference engine behind Main, Review, or Screener. VTX supplies the exact prompt, market context, and output contract; the harness returns the model response or structured decision that powers the normal VTX trading loop.

Analyze the trade chain

Authentication identifies the VTX account using the connector, but it does not establish whether a supplied profile handle is owned or public. For named-profile work, discover the profiles once, confirm the ownership label for every requested handle or wallet, use the matching exact owned or public selection, and preserve that resolved selection with one evidence cutoff. Then connect effective settings and prompt generations to decisions, reasoning, executions, fills, position campaigns, fees, funding, and realized outcomes. Report unavailable evidence instead of silently narrowing the claim.

Run and verify a bot

Resolve the owned profile, read its current execution mode and runtime state, request bot-control access, and start the normal VTX Trader. Server Mode runs on VTX and uses the normal fee. A Client Mode start records the requested intent but still needs a fresh owner: open that profile on Trade in a browser or desktop app, or run vtx auth login --scopes read,bot:control followed by vtx --profile <profile-id> runtime run --follow for the supported headless path. The bot is not running until current heartbeat and ownership evidence confirm it.

Supervise your fleet

Let an agent watch the bots you own with the read-only vtx-fleet-supervisor skill, on demand or on a schedule. Each check reports bots that should be running but are not, closed Client Mode hosts, Hyperliquid and model-provider errors, deep unrealized losses, stale open orders, profit giveback, winners, losers, and odd trades, and stays to one line when all is clear. Connect the agent to the read-only monitor address, https://api.vtxmacro.com/insights/monitor/mcp: it only ever receives Analyze access and never shares permissions with the agent's other VTX connections. The Connect a harness tabs show the scheduling steps for agent apps where VTX has verified unattended runs.

Use the capability registry

Search the live capability registry instead of guessing tool names. Read each capability's permission and input contract, preview consequential changes, ask for approval, and verify receipts against effective state and observed results. A bot is not running until current runtime evidence confirms it.

Give your agent this instruction

Read https://api.vtxmacro.com/insights/access-center/metadata, choose the appropriate bundled skill and live capability, request only the permissions required for my outcome, and explain what you will verify before taking any consequential action.

Bundled skills

Plugin installs include five skills. OpenCode, OpenClaw, and Hermes Agent can install the same skills separately, and other compatible harnesses can use the VTX capabilities through MCP.

5 bundled skills
2026.10.22

vtx-insights-analysis

Included

The general VTX router and safety contract. It discovers the right capability, preserves complete evidence, separates permissions, and verifies settings, profile, connection, bot-control, and trading actions.

Use $vtx-insights-analysis to work with VTX safely and choose the right capability.

vtx-bot-trade-chain-analysis

Included

The specialist performance workflow. It reconstructs settings generations, decisions, executions, fills, positions, exits, fees, funding, PnL, and market context before recommending a focused improvement.

Use $vtx-bot-trade-chain-analysis to explain why my bots are winning or losing and recommend the smallest evidence-backed improvements.

vtx-bot-screener

Included

Screen symbols with current market context and compare existing seven-day leaderboard ROI before proposing an allocation. The assistant evaluates tradability, identifies mixed-symbol performance, and keeps recommendations read-only.

Use $vtx-bot-screener to screen native Hyperliquid symbols, compare seven-day leaderboard ROI across VTX, and propose symbols for my bots without changing settings.

vtx-wallet-cashflow-check

Included

Check one wallet and time window using local-only cashflow and official Hyperliquid explorer reads. Distinguish external cashflows from internal account transfers and report coverage gaps before interpreting ROI.

Use $vtx-wallet-cashflow-check to check deposits, withdrawals, and transfers for this wallet and time window from my local machine. Use the official Hyperliquid explorer and report coverage gaps without querying from a VPS.

vtx-fleet-supervisor

Included

Supervise the bots you own on demand or on a schedule. It reports bots that should be running but are not, closed Client Mode hosts, exchange and model-provider errors, deep unrealized losses, stale open orders, profit giveback, winners, losers, and odd trades, using read-only access.

Use $vtx-fleet-supervisor to check my VTX bots and tell me only what needs my attention.
View the public connector source

Connect a harness

Choose a compatible harness, install the VTX connector, and approve only the access it needs.

Codex
Recommended and tested with the dedicated VTX trade-chain analysis skill.
Available

Quick install

codex plugin marketplace add DataDoesYou/VTX-Insights
codex plugin add vtx-insights@vtx-insights
codex mcp login vtx-insights --scopes insights:read

Manual setup

[mcp_servers.vtx-insights]
url = "https://api.vtxmacro.com/insights/mcp"
tool_timeout_sec = 120

VTX sign-in lets you approve analysis, settings management, bot control, and trading separately.

Connect your VTX account

1Authentication starts in the MCP client, not on this page. In ChatGPT desktop, open Settings → MCP servers, select VTX Insights, and choose Authenticate
2In Codex CLI or the IDE, run codex mcp login vtx-insights --scopes insights:read and approve the browser request. Request additional permissions only when a later task needs them
3Run codex --version before troubleshooting OAuth. Codex 0.146.0 has a known issuer-validation regression; upgrade it if login reports Authorization server response missing required issuer

Verify the connection

Restart ChatGPT desktop or open a new Codex CLI or IDE session after authentication so initialization and tool discovery run again
In ChatGPT desktop, type /mcp and confirm VTX Insights is active; in CLI or the IDE, inspect the new session's MCP tool inventory
Confirm expected read tools such as analysis.start and positions.episodes are available. An OAuth grant alone does not prove that initialization and tool discovery succeeded

Monitor your fleet on a schedule

Runs the read-only vtx-fleet-supervisor skill unattended. It reports stopped or offline bots, errors, deep unrealized losses, profit giveback, winners, and losers, and never changes settings, controls bots, or trades.

1

Add the read-only VTX monitor address and approve the connection in the browser. VTX shows only Analyze for this address, whatever Codex requests.

codex mcp add vtx-monitor --url https://api.vtxmacro.com/insights/monitor/mcp
2

Run one check and confirm it reports your bots.

codex exec --skip-git-repo-check 'Use $vtx-fleet-supervisor with the vtx-monitor server to check my VTX bots and tell me only what needs my attention.'
3

Schedule the same command with cron on macOS or Linux (use the full path to codex if cron cannot find it), or Task Scheduler on Windows. Each run appends its report to the log file; forward that file to your own notifier if you want alerts.

0 */4 * * * codex exec --skip-git-repo-check 'Use $vtx-fleet-supervisor with the vtx-monitor server to check my VTX bots and tell me only what needs my attention.' >> ~/vtx-monitor.log 2>&1

Authorized agent apps

See which agent apps have VTX OAuth access, what each one may do, and remove access at any time. This list does not prove that a native client initialized, discovered tools, or loaded the installed plugin; verify those in the agent app.

Sign in to manage authorized agent apps

The complete guide is public. Your connections, permissions, profile data, and actions remain private.

Sign in to VTX
Connect an agent inference host
Connect a supported background service, automatic foreground bridge, or foreground agent to a running VTX bot. Provider mode keeps the normal VTX analysis cycle unchanged. Agent mode assigns an explicitly capable Main model to the bot; it chooses data reads and whether to submit trading decisions. The Agent harness owns recurring checks and turn timing; VTX provides data and optional decision tools.
Public guide

Harness support matrix

Durable means VTX can operate the vendor's official machine interface after this setup chat ends. Foreground harnesses remain useful, but their agent loop must stay open.

Background services

These integrations can keep serving VTX after the setup chat ends. Keep the host computer on and its service running.

OpenAI Codex
durable

The existing pinned App Server path remains the reference implementation, including ChatGPT identity, live model and effort discovery, quota telemetry, cancellation, and exact crash recovery.

vtx inference-host codex-login; vtx inference-host service install --adapter codex
Billing: subscription · Schema: native · Crash replay: yes
Claude Code
durable

Claude Code runs the user's own installed, unmodified Claude Code CLI with a separate login made through Claude Code's own sign-in, used only by this host, for Provider and Main Agent modes. VTX never reads that login, and runs draw on the Claude subscription's usage limits. Provider runs have no tools; Agent runs expose only the three assignment-scoped VTX tools. VTX validates structured output and the model and usage Claude Code reports. When the subscription reaches a usage limit, jobs move to the next fallback host until it resets. Uncertain interrupted requests remain fenced; same-attempt recovery and Codex subscription quota telemetry are not supported.

Install Claude Code, sign this host in with vtx inference-host claude-login, then install a claude-code inference host
Billing: subscription · Schema: native · Crash replay: quarantined
GitHub Copilot
durable

VTX uses GitHub's official SDK with the package-owned pinned platform runtime, authenticated GitHub login identity, exact enabled model and effort events, token usage, and cooperative cancellation. Auto-only catalogs fail closed because they cannot prove the effective model. Output text is schema-validated by VTX; uncertain interrupted calls are quarantined.

Sign in with the official Copilot CLI, then run vtx inference-host service install --adapter copilot
Billing: subscription credits · Schema: validated text · Crash replay: quarantined
DeepSeek Harness
durable

VTX uses the exact-pinned official DeepSeek Harness runtime in both Provider and Main Agent modes. The key remains in the local VTX private credential boundary, Provider runs have no tools, Agent runs expose only the three assignment-scoped VTX tools, and a loopback receipt verifies the provider-returned model and response ID. VTX validates final JSON; interrupted ambiguous work is never blindly retried.

Import a DeepSeek API key through stdin with vtx inference-host deepseek-login, then run vtx inference-host service install --adapter deepseek-harness
Billing: api billed · Schema: validated text · Crash replay: quarantined
Grok Build
durable

Grok Build uses the pinned official runtime and a separate local OAuth session for Provider and Main Agent modes. Provider runs have no tools; Agent runs expose only the three assignment-scoped VTX tools. VTX validates structured output, model identity, and reported usage. Uncertain interrupted requests remain fenced; same-attempt recovery and Codex subscription quota telemetry are not supported.

Sign in with vtx inference-host grok-login, then install a grok-build inference host
Billing: subscription · Schema: native · Crash replay: quarantined
Pi
durable

The pinned Pi SDK supports Provider mode and Main Agent mode through the existing controls. The initially qualified models use one separately stored OpenAI API key per instance and advertise exact provider/model identities from the release's configured qualification policy and SDK catalog. Provider runs have no tools; persistent Agent sessions expose only the three assignment-scoped VTX tools. VTX validates structured output and execution receipts. Uncertain interrupted model calls stop safely; Pi does not claim same-attempt recovery. Subscription OAuth and unqualified provider protocols are not enabled by this adapter.

Import an OpenAI API key through stdin with vtx inference-host pi-login --provider openai, then run vtx inference-host doctor --adapter pi and vtx inference-host service install --adapter pi
Billing: api billed · Schema: native · Crash replay: quarantined

Automatic foreground bridge

The bridge serves VTX automatically while its process stays open.

Exo
foreground

Exo means exoharness/exo. The VTX-owned bridge runs the pinned Exo custom harness automatically in Provider and Main Agent modes; no manual job transfer is needed. Each instance advertises only the release-qualified routes for its OpenAI or Venice credential. Venice currently offers Gemma 4 31B IT with effort None only. Provider runs receive complete VTX input with no tools; Agent runs expose only assignment-scoped VTX tools. VTX validates canonical JSON; native structured-output enforcement is not claimed. VTX OAuth stays outside Exo. This Linux/WSL foreground bridge has no durable service or same-attempt recovery: uncertain interrupted work remains fenced. It does not add native Exo MCP support.

On Linux or WSL, import a Venice key with vtx inference-host exo-login --provider venice --instance exo-1 (use --provider openai for OpenAI), then keep vtx inference-host run --adapter exo --exo-root /path/to/exo --instance exo-1 open
Billing: api billed · Schema: validated text · Crash replay: quarantined

Foreground agent integrations

Keep the harness session and its VTX foreground host loop open. Available modes depend on the connected model’s advertised capabilities.

Amp
foreground

Amp offers subscriptions, credits, and linked ChatGPT capacity, but its selectable product is a managed mode rather than a stable underlying model identity.

Use Amp through agent-connect while managed model-mode identity remains unfrozen
Billing: mixed · Schema: validated text · Crash replay: quarantined
Auggie
foreground

Auggie exposes account, models, credits, ACP cancellation, and sessions, but its SDK currently declares structured output unsupported and recovery remains incomplete.

Use Auggie through agent-connect until structured results and recovery are complete
Billing: subscription credits · Schema: validated text · Crash replay: quarantined
Cursor
foreground

Cursor's official SDK has strong lifecycle and usage telemetry, but SDK authentication is API-key and token-billed rather than a clear consumer-subscription subsidy.

Use Cursor's foreground agent loop for subscription sessions
Billing: api billed · Schema: validated text · Crash replay: quarantined
Gemini CLI
foreground

The current official individual OAuth flow rejects this client and directs users to Antigravity. API-key and Vertex routes are API-billed rather than a consumer-subscription subsidy, and the CLI does not enforce a final response schema.

Use the foreground agent loop or VTX's normal Gemini API provider; do not install Gemini CLI as a subscription worker
Billing: mixed · Schema: validated text · Crash replay: quarantined
Google Antigravity
foreground

A live 1.1.13 Starter Quota acceptance exposed shell, file, browser, web, MCP, subagent, and messaging tools even under an isolated agent declaring tools: [], and the requested final JSON Schema was not enforced. VTX therefore keeps Antigravity in a monitored foreground loop.

Use vtx inference-host agent-connect and keep the signed-in Antigravity loop open
Billing: subscription credits · Schema: validated text · Crash replay: quarantined
Hermes Agent
foreground

Hermes supports remote OAuth MCP servers, so it can use VTX Insights directly. Its one-shot runner can make unreported auxiliary model calls, undercounts usage, reports requested rather than proven effective identity, can exit successfully after provider failures, and has no structured interruption receipt or clean no-tools mode, so it is not a durable VTX adapter.

Use Hermes' native MCP client for VTX Insights; use agent-connect only for foreground VTX inference
Billing: mixed · Schema: validated text · Crash replay: quarantined
JetBrains Junie
foreground

Junie has headless JSON, ACP, sessions, and subscription routing, but effort can fall back and its public machine contract does not yet provide the exact effective identity and usage evidence required for a durable VTX worker.

Use Junie through agent-connect while its effective model, effort, and usage receipts remain incomplete
Billing: subscription credits · Schema: validated text · Crash replay: quarantined
Kiro CLI
foreground

Kiro API keys legitimately consume paid subscription credits, but its headless chat lacks a stable JSON result, effective-model, token-usage, and cancellation receipt.

Use the foreground agent loop; do not install Kiro as a durable VTX worker yet
Billing: subscription credits · Schema: validated text · Crash replay: quarantined
OpenClaw
foreground

OpenClaw's published package supports remote OAuth MCP servers, so it can use VTX Insights directly. Durable VTX inference remains disabled because the published runtime does not expose a package-owned terminal receipt with complete effective model, provider-call usage, tool, cancellation, and interruption evidence.

Use OpenClaw's native MCP client for VTX Insights; use agent-connect only for foreground VTX inference
Billing: mixed · Schema: validated text · Crash replay: quarantined
OpenCode
foreground

OpenCode can run VTX Provider jobs or claim a true Main Agent assignment while its foreground loop stays open, and it can connect directly to VTX Insights with scoped OAuth and native Agent Skills. The open-source harness has a strong SDK and session contract, but its generic receipts do not prove provider-returned model identity or complete ambient-tool isolation. Its hosted terms also prohibit unattended programmatic output extraction, and upstream vendors do not authorize OpenCode as a durable router for their consumer subscription OAuth credentials.

Use OpenCode through agent-connect for foreground Provider or Main Agent mode with local or BYOK models; use its native OAuth MCP client for VTX Insights
Billing: mixed · Schema: native · Crash replay: quarantined
Qwen Code
foreground

Qwen Code has a strong no-tools, JSON Schema, usage, and cancellation contract, but the Coding Plan prohibits automated scripts, application backends, and non-interactive use. Standard ModelStudio API quota is a normal API/BYOK route rather than subscription capacity.

Keep Coding Plan sessions foreground-only; use VTX's normal ModelStudio provider for API-key usage
Billing: mixed · Schema: native · Crash replay: quarantined
Warp Oz
foreground

Warp and Oz can consume plan credits and run cloud agents, but they do not expose the exact effort, structured result, token accounting, and direct inference lifecycle required for a durable VTX provider.

Use Warp or Oz through agent-connect for foreground automation
Billing: subscription credits · Schema: validated text · Crash replay: quarantined

Fresh computer or existing fleet

Use this path when several existing profiles or durable inference hosts must move to a new computer. A new installation creates new host identities even when the vendor credential is unchanged, so every saved profile lane must be checked and any stale binding must be explicitly previewed and rebound.

Existing fleets
  1. 1Before changing anything, freeze the exact profile cohort and record each lane's current model, reasoning effort, control mode, execution mode, primary host, and ordered fallbacks. Record every computer's displayed host name, stable local --instance name, adapter, host ID, and intended model. Record authenticated account identity only when that adapter reports one.
  2. 2Install the CLI from native Windows or native Linux. On each physical computer, run login, then the adapter-specific vendor step: codex-login for Codex, the official Copilot CLI login for Copilot, deepseek-login through stdin for DeepSeek Harness, pi-login --provider openai through stdin for Pi, grok-login for Grok Build, or claude-login for Claude Code. Use the same --instance name for login, vendor credentials, doctor, and service install. Run doctor and service install with the exact adapter and instance; one OS supervisor manages that computer's isolated workers. Each worker keeps its own VTX grant, credential boundary, and runtime state. Never copy inference-host credentials or state between computers. Codex and Copilot multiple-instance setups require distinct authenticated accounts. DeepSeek Harness currently permits only one worker for that adapter per computer because it does not advertise a stable provider account identity.
  3. 3Compare each newly registered host ID with the exact host identity saved on every target lane. Matching account email is not proof of the same host; neither is a matching API key, adapter, or device name. Preview an owner-scoped update for only the frozen cohort, explicitly replace stale primary and fallback host bindings, and preserve model, reasoning effort, response mode, execution mode, control mode, symbols, prompts, and every unrelated setting.
  4. 4Apply only the approved, version-fenced preview with its rollback snapshot. Read back every target lane and Host cascade, then confirm each named instance maps to the intended host ID and adapter and advertises the intended model and effort. When account identity is available, verify it too. Do not revoke the previous computer's grants until the new bindings and workers are verified.
  5. 5Verify a fresh completed and accepted inference from every primary host; for full fleet acceptance, verify one from every target profile. A routed request, claim, start acknowledgement, running Trader, start receipt, or brief Live label does not prove inference completion. Inspect failures before making one controlled retry.
  6. 6A durable service starts immediately and registers startup for that user at sign-in, not before Windows login. While the computer is off, asleep, signed out, or offline it cannot serve inference. At sign-in and periodically while running, a desired-running service checks for a verified CLI update. It finishes active Provider calls and Agent turns with heartbeats intact before switching releases and reconnecting automatically; if the registry is unavailable, it keeps the last verified compatible runtime. service stop disables update checks, automatic recovery, and login startup until service start re-enables them.
  7. 7Fallback workers installed on the same computer protect against an individual provider credential or quota failure, not against that computer being unavailable. Reboot or sign out only with the user's approval; after signing back in, verify supervisor state, every instance and adapter, any reported account identity, fresh remote heartbeats, and a new completed inference.

Reboot and login

The service is per-user login startup, not a pre-login machine service. Nothing runs while the computer is powered off, and workers cannot serve while it is asleep, signed out, or offline. After the user signs in, instances whose desired state is running reconnect automatically. Workers on the same computer share that computer-level failure domain.

Completion checklist

  • Exact effective primary and fallback bindings read back for every target lane.
  • One OS supervisor reports every intended named worker desired-running with the correct adapter and, when available, authenticated account.
  • Every new host has a fresh remote heartbeat and advertises the intended model and reasoning effort.
  • Each primary host completes and VTX accepts a fresh inference; full-fleet acceptance covers every target profile.
  • A post-login check proves automatic restart when reboot or sign-out verification was approved.

Ask your agent to move a fleet

Add your exact profile names and account order after copying this prompt.

Read https://vtxmacro.com/insights#subscription-inference and set up or move my exact existing durable inference fleet to this computer. Before changes, list the exact profiles, named instances, adapters, primary and fallback order, model, reasoning, control mode, and execution mode. Use the adapter-specific vendor login or key-import step and one native OS supervisor with isolated workers. DeepSeek Harness is limited to one worker for that adapter per computer until it can advertise a stable provider account identity. Explicitly preview and rebind stale host identities, preserve all unrelated settings, and verify effective readback plus a fresh completed inference from each primary. Do not call routing, a start receipt, or running Trader state proof of inference completion. Explain user-login startup and computer-off behavior before any reboot.

Agent host setup

Install, connect, choose a control mode, and verify the host.

Available

Install @vtxmacro/cli from npm, then connect OpenAI Codex, Claude Code, GitHub Copilot, DeepSeek Harness, Grok Build, or Pi as a durable host. The 13 foreground integrations in the support matrix above serve VTX while their bridge or agent loop stays open.

  1. 1Install the public host with npm install -g @vtxmacro/cli, confirm the installed release with vtx --version, and use vtx inference-host --help whenever you need command discovery.
  2. 2New service installations use a private verified launcher: at login, each service start, and periodically while running it checks the official npm registry and verifies an exact release. Before switching it stops new admission and lets active Provider calls and Agent turns finish with heartbeats intact. It selects the candidate only after every configured worker reports ready. Routine updates do not require a manual restart. A stable recovery launcher retains the previous working release and is not replaced by routine updates. A failed activation or unexpected updater exit rejects that release and restores the previous runtime; an unavailable update check also keeps the working runtime. An intentionally stopped service stays stopped and makes no update request.
  3. 3Hosts installed before the private launcher need one final normal npm update and cooperative service reinstall to adopt it. Startup-only launchers adopt background checking after their next normal start activates a release that includes it; publishing a release cannot replace an older process that is already running. Durable services run on native Windows x64 or native Linux x64. WSL supports foreground diagnostics and agent-driven commands but refuses service installation; install from native Windows for Windows-login startup.
  4. 4For Exo (https://github.com/exoharness/exo), use Linux or WSL and the source revision qualified by this CLI release. Follow the Exo setup in the CLI package README, then run vtx inference-host login --instance exo-1. Import one OpenAI or Venice key per instance through stdin with vtx inference-host exo-login --provider venice --instance exo-1; use --provider openai for OpenAI. Run doctor --adapter exo --exo-root /path/to/exo --instance exo-1, then keep vtx inference-host run --adapter exo --exo-root /path/to/exo --instance exo-1 open. The bridge automatically serves both Provider and Main Agent modes. Each instance advertises only its credential provider's qualified models and efforts. Venice currently offers Gemma 4 31B IT with effort None only. Other routes and subscription logins are not qualified. Windows users run the foreground bridge inside WSL; native Windows and durable services are not supported. Exo trading inference does not require native MCP support in Exo.
  5. 5Run vtx inference-host login and approve the exact insights:inference grant in the VTX browser consent flow. A VTX authorization-complete page confirms the callback; if the browser still shows ERR_BLOCKED_BY_CLIENT but the terminal reports logged_in and doctor reports credential-present, a browser extension blocked only the confirmation page and authorization succeeded.
  6. 6The CLI verifies that the OS credential store retained the grant. If Windows Credential Manager or another OS store fails, the new remote grant is revoked instead of reporting success. Retry with the supported private-file store: in PowerShell set $env:VTX_INFERENCE_HOST_CREDENTIAL_STORE="file"; in bash run export VTX_INFERENCE_HOST_CREDENTIAL_STORE=file; then run vtx inference-host login again.
  7. 7For automated Codex inference, enable Device code authorization in ChatGPT Security, then run vtx inference-host codex-login. Never share or enter a device code you did not initiate. The host advertises every visible Codex model with its reported display name and reasoning efforts; hidden entries are not exposed. Verify both logins with vtx inference-host doctor --json, then run vtx inference-host service install. Hosts have no subscription-specific concurrency limit by default; --max-concurrency adds a local limit, and active turns share the subscription rate-limit gate. Installation starts at login. service status --json reports workers; vtx inference-host status --json is local-only. Confirm the intended ChatGPT email and plan before starting a Trader. When an exact Main model advertises Agent control, the assigned Codex runtime reuses these logins, receives no VTX prompt, and chooses its cadence and assignment-scoped data calls. Use vtx inference-host run for foreground diagnostics.
  8. 8For Claude Code, install Claude Code from https://code.claude.com on the computer that will serve VTX (native Windows or Linux; on Windows use the native installer, which provides claude.exe), then run vtx inference-host login --instance claude-1. Run vtx inference-host claude-login --instance claude-1: it starts Claude Code's own sign-in for a separate login used only by this host. Claude Code opens its sign-in page in the browser; the user approves with the Claude subscription account and sign-in finishes on its own. If no page opens, open the printed claude.ai link and paste the code Claude shows into the same terminal. VTX never reads that login, and the host refuses an API-key or token login. Then run vtx inference-host doctor --adapter claude-code --instance claude-1 and vtx inference-host service install --adapter claude-code --instance claude-1. After service uninstall, vtx inference-host claude-logout --instance claude-1 signs this host out.
  9. 9A Claude Code host advertises the Claude models this CLI release qualifies, with Provider and Agent control. Each run counts toward the Claude subscription's usage limits; when a limit is reached, jobs move to the next fallback host until it resets, so add a fallback host before relying on one subscription for frequent bot runs. An AI agent setting this up for the user, including Claude Code itself, runs the commands above, tells the user to approve the sign-in page Claude Code opened and shows the authorization_url from claude-login --json as the fallback link, then waits for the command to finish. If the user gets a code instead, the user runs claude-login in their own terminal and pastes it there. The agent never substitutes its own session's login or an API key.
  10. 10For machine-level fallback, repeat login, codex-login, doctor, and service installation on each physical computer. Every computer receives a distinct VTX grant and host ID while its displayed name defaults to the operating-system device name; the same authenticated Codex subscription may be used on more than one computer. Never copy host credentials or state between machines. Multiple instances on one computer still require distinct authenticated subscriptions; use --instance <name> for that setup. Use service status --json to list local workers and vtx inference-host status --instance <name> --json for one local instance. In each profile lane, use Host cascade to add and order compatible computers. Host #1 is selected, and the model picker shows only its models; later hosts are managed only under Host cascade.
  11. 11For Pi, run vtx inference-host login --instance pi-1, import the provider key privately with vtx inference-host pi-login --provider openai --instance pi-1 through stdin, then run doctor --adapter pi and service install --adapter pi with the same instance. Select its advertised provider/model and effort in the existing model controls. Use one provider per instance; a provider API key is separate from the VTX grant. The Pi adapter does not import ordinary Pi sessions or subscription logins.
  12. 12For GitHub Copilot, sign in with the official Copilot CLI and run vtx inference-host service install --adapter copilot --instance copilot-1. The adapter discovers the authenticated runtime catalog, rejects BYOK substitution, and quarantines an uncertain interrupted dispatch rather than repeating it. The AI page exposes Agent only for an exact Main model that the installed host advertises as Agent-capable. Never install a different adapter over an existing Codex instance; use a distinct instance and VTX grant.
  13. 13For DeepSeek Harness, run vtx inference-host login --instance deepseek-1, pipe the DeepSeek API key into vtx inference-host deepseek-login --instance deepseek-1, then run vtx inference-host doctor --adapter deepseek-harness --instance deepseek-1 and vtx inference-host service install --adapter deepseek-harness --instance deepseek-1. The key stays local and is not written to service manifests or sent to VTX. The authenticated live catalog is intersected with VTX-supported DeepSeek text models. Provider mode is tool-less; Main Agent mode keeps a durable Harness session and exposes the canonical assignment-scoped data, optional decision and decision-status tools. Review and Screener remain Provider-only.
  14. 14For another compatible agent harness without a supported headless adapter, run vtx inference-host agent-connect --adapter <lowercase-harness-id> --model <exact-model-id> --model-label "<label>" --effort <effort> --json and keep vtx inference-host agent-run plus the harness session open. In Provider mode, keep calling agent-next, reason over its exact prompt/context/schema fields, then submit agent-complete or agent-fail. In Agent mode, use agent-assignment-next for the exact Main assignment, make zero or more assignment-scoped agent-data-call requests, optionally submit the normal structured decision with agent-decision-submit, recover an uncertain receipt with agent-decision-status, and use agent-assignment-heartbeat to record the next wake. Use agent-assignment-release only when intentionally ending that foreground control session. This foreground path is not advertised as durable after its harness session exits.
  15. 15For recurring foreground checks, prefer the harness's authorized native scheduler and verify its task, interval and next run. If unavailable, explicitly use session-bound clock waits. Follow a fixed clock rhythm with one active turn and skip missed slots; do not wait a full interval after each turn finishes. Inspect source timestamps on market reads through agent-data-call. Keep agent-run alive for heartbeats; it does not schedule checks or reopen a closed harness. A check never requires HOLD or trading JSON. Existing native durable adapters retain their model-chosen wake behavior.
  16. 16For agent-fail, use not_dispatched only if no harness inference began, confirmed_dispatched if it began but produced no reliable result, or outcome_unknown if dispatch itself cannot be confirmed. Examples: {"dispatch_outcome":"not_dispatched","failure_category":"adapter","failure_code":"harness_unavailable","retryable":true}; {"dispatch_outcome":"confirmed_dispatched","failure_category":"adapter","failure_code":"no_reliable_result","retryable":false}; {"dispatch_outcome":"outcome_unknown","failure_category":"transport","failure_code":"dispatch_confirmation_lost","retryable":false}. Set retryable true only when a fresh attempt is safe. Durable Agent adapters persist an ambiguous dispatch fence across service restart and never auto-redispatch it. status --json and doctor --json expose the fence; reconcile and revoke/relink the instance before resuming. A successful replacement DeepSeek key import clears an authentication fence, while quota and rate-limit failures honor their retry time or a bounded cooldown.
  17. 17Use VTX to bind the advertised model to Main, Review, or Screener. Main shows Provider and, only when explicitly advertised, Agent control; Review and Screener stay Provider-only. When an adapter reports authenticated account and quota telemetry, the selected row shows this profile's estimated membership burn rate as percentage points per hour, per day, and per seven days, each with one decimal. VTX normalizes attributed increases over measured coverage; gaps do not erase same-window evidence. Bot restarts, controller generations, and model or reasoning changes preserve measurement for the same membership; a quota reset or changed host/account starts a new window. DeepSeek Harness is API-billed and reports no membership burn window.
  18. 18Cascaded prompts appear on the membership that actually ran them. Models and Providers counts include native and external choices once each and do not change with control mode. Stopping a Trader leaves a durable host service online and idle; a foreground host remains online only while its automatic Exo bridge or generic agent-run and harness session stays open. An unavailable host never falls back to native inference.
  19. 19Host cascade keeps one ordered peer row per distinct host ID. Two computers remain separate rows even when they report the same authenticated subscription. Host #1 is selected; moving another host into that slot changes the selected computer without changing the model or request controls. Provider-mode calls may continue only through this exact saved order. Agent mode keeps its durable thread and assignment on the exact selected Host #1; an Agent failure is fenced rather than automatically transferred to another host. Add, remove, and reorder actions animate with the normal AI-list behavior.
  20. 20Codex product badges identify the frozen host position: Host #1 has no suffix, Host #2 uses #2, and Host #3 uses #3, including when a Provider request begins directly on an available later host because Host #1 is already offline. Provider quota remains account-level when an adapter reports account identity, so quota-classified Provider failures skip later hosts only when they positively report the same identity. DeepSeek Harness reports no stable account identity, so its ordered compatible hosts are not suppressed by identity matching in Provider mode.
  21. 21After an approved Trader start, verify current status until the normal Trader is genuinely running. If it returns to Stopped, read the latest runtime error or event, report the cause, correct it, and only then make one controlled retry; a start receipt or a brief Live label is not success.
  22. 22On native Windows, if service status or logs show that guarded recovery is blocking one installed subscription, run vtx inference-host service recover --instance <name> --force-recovery --json for that exact instance. Both --instance and --force-recovery are required; --json changes only the output format. The shared supervisor briefly quiesces so all installed workers stop cooperatively, then VTX restores its previous desired state and peer subscriptions. Recovery does not kill an arbitrary process, reboot, log either account out, change profile settings, or control a Trader. If any package-owned VTX automation is still live, the command fails closed and preserves its recovery evidence.
  23. 23Use vtx inference-host service status and service logs to inspect the durable provider. service stop pauses it and disables automatic recovery and login startup until service start re-enables them; the OS registration remains installed. service uninstall --instance <name> removes one worker while preserving the others; unqualified service uninstall removes the whole supervisor. Run the appropriate uninstall before logout, revoke, or package removal. Connected Agent Apps groups live sessions for the same immutable app contract into one card and Disconnect or Relink revokes every active credential represented by that card; revoked and expired rows stay in audit history but are not shown as connected. Automated Codex users can separately run codex-logout.

Choose who controls the cycle

Both modes return the same structured trading decision to VTX. The difference is who decides when to run and which data the model needs.

Provider

VTX keeps its normal cadence, builds the lane's prompt and context, and asks the connected model for a response. This remains the only mode for Review and Screener.

  1. 1On the AI page, open Main Model, Review Model, or Screener Model and select the connected entry under Connected Providers.
  2. 2Choose the reasoning effort. For Main, set Mode to Provider; Review and Screener use Provider automatically. Save the AI settings.
  3. 3Confirm that the selected background service listed above is active, or keep the foreground agent-run and harness session open (for Exo, keep its automatic run --adapter exo bridge open). Verify the host is registered, then start the normal VTX Trader. If Trader returns to Stopped, inspect the latest runtime error before a controlled retry.
Agent

VTX assigns the running Trader to an explicitly capable Main agent. The agent chooses when to act, requests any assignment-scoped VTX data it needs or none, and submits the same structured trading decision VTX normally consumes.

  1. 1On the AI page, open Main Model and select a connected model that explicitly offers Agent mode.
  2. 2Choose the reasoning effort, set Mode to Agent, and save the AI settings. Review and Screener remain Provider-controlled.
  3. 3Confirm that the selected durable Agent-capable service is active, or keep the foreground agent-run and harness session open (for Exo, keep its automatic run --adapter exo bridge open). Then start the normal VTX Trader. The assignment lets the agent choose its cadence and data calls; VTX still validates the submitted decision and owns bot lifecycle, risk, tracking, and execution.
Provider mode supports Main, Review, and Screener while the normal VTX bot and connected host are running. Agent mode is available only for explicitly capable Main models; Review and Screener remain Provider-only. VTX delivers the assignment, canonical instructions and data tools. The Agent harness owns waits, recurring market checks and model turns; checks never force HOLD or a trade. The saved trading interval does not schedule Agent turns. Both Server Mode and Client Mode retain normal execution authority. Foreground harnesses keep agent-run alive only for host and assignment heartbeats and must keep their original session open. Durable adapter services retain their existing native runtime support. Services restart at user login on native Windows or Linux; asleep or offline hosts cannot check markets. WSL remains foreground-only.

Ask your agent

Any compatible Insights agent can read this public guide and walk you through setup without access to private host status.

Read https://vtxmacro.com/insights#subscription-inference and help me connect your supported VTX inference host. Install the durable service when your harness has a supported headless adapter; otherwise use the foreground host path and keep its agent loop open. For Main, help me choose Provider or Agent based on the model's explicit capabilities; keep Review and Screener in Provider mode. Save the setting and start the normal VTX Trader only after I approve. Confirm either that the OS service remains active independently of this chat or that the required foreground loop is still open. Do not advertise durability or Agent control that your harness cannot provide.

Connections are governed by the Privacy Policy and Terms of Service.

Prompts, examples, and operating rules

Explore workflows, live examples, and reusable prompts. The machine-readable guide remains canonical.

Use

Describe the outcome you want and let the agent choose the best VTX and native tools for the job.

1. Choose the population

Name the population: my profiles, exact public handles or wallets, or the whole platform. For named profiles, the agent verifies each ownership label before choosing the owned or public selection.

2. Set the time window

Name the time window and the decision you are trying to make.

3. Describe the outcome

Ask for the analysis, comparison, recommendation, or action that helps you decide.

4. Review and approve

Review important assumptions and approve consequential changes or trades in plain language.

5. Interpret replays carefully

Treat policy replay as a counterfactual, not as observed live performance.

Your agent stays in charge

Your agent decides how to investigate, calculate, recommend, and respond. VTX supplies the tools; it never grades or rewrites the answer.

Approve each permission

Choose analysis, settings, bot control, trading, profile, connection, account security, billing, and content access separately. Your agent app receives only the permissions you approve. Newly added permissions must be granted explicitly; existing connections never gain them automatically, and interrupted actions are not blindly repeated.Choose analysis, settings, bot control, trading, profile, connection, account security, and content access separately. Your agent app receives only the permissions you approve. Newly added permissions must be granted explicitly; existing connections never gain them automatically, and interrupted actions are not blindly repeated.

Writes stay owner-scoped

Changes and trades are limited to profiles you own and still pass the same VTX trading safeguards.

Account controls stay in VTX

Your agent can also start billing and account-security actions. Payments finish on the payment provider's page, and password, two-factor, and passkey changes finish in a signed-in VTX verification page that keeps those secrets out of the agent.Your agent can also start account-security actions. Password, two-factor, and passkey changes finish in a signed-in VTX verification page that keeps those secrets out of the agent.

Examples

Review examples drawn from current VTX trading activity, then copy and adapt a prompt.

Sign in for live VTX examples

Sign in to see current showcase results and their exact coverage and sources. Public setup, capabilities, and prompt ideas remain available below.

Sign in to view examples

Prompt ideas

Search starting points for performance reviews, trade-chain analysis, settings ideas, market research, and VTX product help.

73 prompt ideas
Curated starting points for analysis, research, and review-ready settings ideas.
Showing 6 of 73 prompt ideas
Performance

How am I trading this week?

Performance

How is this account trading this week?

Performance

How am I trading this month?

Performance

Compare all my bots this month. Which model is performing best?

Performance

What was my account PnL and ROI over the last 30 days?

Performance

Rank my bots by PnL, win rate, and drawdown over the last 30 days.

Capabilities

Browse capabilities by permission group, or search for an exact analysis or owned-profile action.

Complete JSON contract
Population and coverage handling

VTX tools preserve the selected population, resume large results from acknowledged checkpoints, and report unavailable evidence instead of silently substituting a smaller answer.

Settings and app actions

Your agent can configure a Local AI or OpenAI-compatible connection and select its model for a profile; model discovery runs on the online app host you select, and a saved model list does not prove the server is still online. It can read or reset the shared AI defaults while keeping settings you name, manage saved Settings Snapshots (create, rename, replace, favorite, import, delete) separately from fleet rollback points, and choose a Copy source with the app's identity checks. Desktop preferences and updates need an online desktop host, and installing an update needs your explicit restart choice. Order, TWAP, and funding reads need no server signing key but follow exchange history limits. Standalone Server Mode analysis gives advice without placing orders, and decision follow-ups can be edited or reset; local-model follow-ups run on the selected host. With Manage connections, it can read the order of a bot's provider key slots, add a secondary key, and reorder or remove slots; stored secrets and key previews are never returned, the order is reread after each change, and key validation is a separate check. With Manage settings, it can change your timezone and automatic timezone, which follows the device displaying VTX.

Analysis evidence boundaries

Since-change reviews use one frozen boundary, and multi-window reviews keep exact economics, coverage, and missing-data limits. You can follow a historical change through a later date. Turnaround reviews show when decisions stopped and resumed, with the runtime observations and, for owned bots, positions and account values retained at those gaps; silence alone does not prove a bot was offline, and a flat realized-profit chart does not rule out open losses. Older prompt sections appear only when independently verifiable. Scaling reviews separate profitable positions with recorded unit capacity, requests to add, and executed additions; repeated HOLDs are repeated observations, not separate opportunities. Same-symbol decision comparisons link retained inputs, prompts, explanations, and executions and flag differences that affect the comparison. Exits are classed as verified protective stops, model exits, or manual exits, and unresolved exits stay unknown. After a prompt change, verification separates confirmed use from a pending decision, delayed evidence, or missing evidence. Owned-bot reviews also show retained operating conditions such as failed attempts, data sources, and unexplained gaps, without adjusting profits to guess what a blocked bot might have earned.

10 permission groups · 177 capabilities

Analyze

70

Markets, profiles, decisions, settings, performance, and strategy evidence.

Read account display preferences

account.preferences.readaccount preferences
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned account
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Account Presentation Read

account.presentation.readaccount presentation
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Presentation Schema

account.presentation.schemaaccount presentation
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Read account snapshot

account.snapshotAccount
Analysis

Inspect live positions, balances, orders, fills, and account activity.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Cancel long analysis

analysis.cancelLarge analyses
Analysis

Start or resume a complete analysis that needs more time to finish.

Authority
insights:read
Population
authorized analysis job
Freshness
durable_job_state
Delivery
inline
Provenance: required
Input contract

Analysis History

analysis.historyactivity
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Start long analysis

analysis.startLarge analyses
Analysis

Start or resume a complete analysis that needs more time to finish.

Authority
insights:read
Population
authorized analysis job
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Check long analysis

analysis.statusLarge analyses
Analysis

Start or resume a complete analysis that needs more time to finish.

Authority
insights:read
Population
authorized analysis job
Freshness
durable_job_state
Delivery
inline
Provenance: required
Input contract

Analyze trading data

analytics.queryTrading analysis
Analysis

Compare performance, settings, trades, decisions, and strategy outcomes.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Continue a large analysis

artifact.manifestLarge results
Analysis

Work through complete large result sets without losing requested evidence.

Authority
insights:read
Population
authorized artifact
Freshness
immutable_artifact
Delivery
inline
Provenance: required
Input contract

Search analysis evidence

artifact.queryLarge results
Analysis

Work through complete large result sets without losing requested evidence.

Authority
insights:read
Population
authorized artifact
Freshness
immutable_artifact
Delivery
inline
Provenance: required
Input contract

Query several analysis artifact paths

artifact.query_manyLarge results
Analysis

Work through complete large result sets without losing requested evidence.

Authority
insights:read
Population
authorized artifact
Freshness
immutable_artifact
Delivery
inline
Provenance: required
Input contract

Read more analysis evidence

artifact.readLarge results
Analysis

Work through complete large result sets without losing requested evidence.

Authority
insights:read
Population
authorized artifact
Freshness
immutable_artifact
Delivery
inline
Provenance: required
Input contract

Resume complete artifact retrieval

artifact.resumeLarge results
Analysis

Work through complete large result sets without losing requested evidence.

Authority
insights:read
Population
authorized artifact
Freshness
immutable_artifact
Delivery
inline
Provenance: required
Input contract

Billing Balance

billing.balanceaccount finance
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Billing Prices

billing.pricesaccount finance
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Billing Pricing

billing.pricingaccount finance
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Billing Stats

billing.statsaccount finance
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Compare trading models and decisions

comparison.readcomparison
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Content Posts List

content.posts.listcommunity content
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Content Posts Read

content.posts.readcommunity content
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Check bot status

control.bot.statusBot control
Analysis

Check Server and Client Mode status for one, selected, or all profiles you own, including whether a Client host is online.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Copy Runtime Read

copy.runtime.readactivity
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Read decision follow-up conversation

decision.chat.readdecision chat
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Read decision context

decision.contextDecisions
Analysis

Inspect the market and bot context behind stored trading decisions.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Analyze decision outcomes

decision.outcomesDecisions
Analysis

Connect stored decisions with what happened afterward.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Find decision replay scenarios

decision.replay.scenariosdecision replay
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Read decision replay scenario sets

decision.replay.sets.readdecision replay
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Read decision history

decisions.historyTrading analysis
Analysis

Compare performance, settings, trades, decisions, and strategy outcomes.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Read a bot's exchange account

exchange.account.readexchange
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Read a bot's exchange

exchange.readexchange
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Analyze execution quality

execution.qualityExecution
Analysis

Analyze fills, fees, slippage, and order execution quality.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Open VTX help

help.openVTX Help
Analysis

Find current VTX product guidance and operating behavior.

Authority
insights:read
Population
vtx help
Freshness
versioned_help
Delivery
inline, artifact
Provenance: required
Input contract

Search VTX help

help.searchVTX Help
Analysis

Find current VTX product guidance and operating behavior.

Authority
insights:read
Population
vtx help
Freshness
versioned_help
Delivery
inline, artifact
Provenance: required
Input contract

Host Command Read

host.command.readclient host
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Host List

host.listclient host
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Read external inference status

inference.statusexternal inference
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned external inference runtime
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Read market calendar

market.calendarMarkets
Analysis

Read current markets, price history, news, and the economic calendar.

Authority
insights:read
Population
vtx market
Freshness
live
Delivery
inline, artifact
Provenance: required
Input contract

Read market history

market.historyMarkets
Analysis

Read current markets, price history, news, and the economic calendar.

Authority
insights:read
Population
vtx market
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

List an exchange's markets

market.listMarkets
Analysis

Read current markets, price history, news, and the economic calendar.

Authority
insights:read
Population
vtx market
Freshness
live
Delivery
inline, artifact
Provenance: required
Input contract

Read market snapshot

market.snapshotMarkets
Analysis

Read current markets, price history, news, and the economic calendar.

Authority
insights:read
Population
vtx market
Freshness
live
Delivery
inline, artifact
Provenance: required
Input contract

Read notification settings

notifications.readnotifications
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned account
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Attribute equity runs and drawdowns to changes, market, and incidents

period.attributiontrade chain
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
artifact
Provenance: required
Input contract

Evaluate retained trading policy

policy.evaluateStrategy tests
Analysis

Replay trading policies and compare counterfactual outcomes.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Replay trading policy

policy.replayStrategy tests
Analysis

Replay trading policies and compare counterfactual outcomes.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Analyze position excursions

position.excursionsTrading analysis
Analysis

Compare performance, settings, trades, decisions, and strategy outcomes.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Read position episodes

positions.episodesTrading analysis
Analysis

Compare performance, settings, trades, decisions, and strategy outcomes.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Profile Emoji Read

profile.emoji.readaccount presentation
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Profile Order Read

profile.order.readaccount presentation
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Discover VTX profiles

profiles.discoverProfiles
Analysis

Find your profiles, exact public profiles, or the full public platform.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
live_authorization_state
Delivery
inline, artifact
Provenance: required
Input contract

Read live trading prompt variables

prompt.contextprompt
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Discover trading prompt variables

prompt.variablesprompt
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
canonical prompt variables
Freshness
current_configuration
Delivery
inline, artifact
Provenance: required
Input contract

Referrals Read

referrals.readaccount finance
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Report Prompts

report.promptsaccount finance
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Report Tax

report.taxaccount finance
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Runtime Events Read

runtime.events.readactivity
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Trace bot and settings changes

runtime.provenanceChange history
Analysis

Trace runtime, model, settings, and deployment changes behind behavior.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Choose screening candidates

screener.candidatesScreener
Analysis

Inspect Screener candidates, runs, assignments, and outcomes.

Authority
insights:read
Population
vtx market, owned profiles
Freshness
live
Delivery
inline, artifact
Provenance: required
Input contract

Read canonical screening prompts

screener.contextScreener
Analysis

Inspect Screener candidates, runs, assignments, and outcomes.

Authority
insights:read
Population
vtx market, owned profiles
Freshness
live
Delivery
inline, artifact
Provenance: required
Input contract

Read screener history

screener.historyScreener
Analysis

Inspect Screener candidates, runs, assignments, and outcomes.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Rank screening evaluations

screener.rankScreener
Analysis

Inspect Screener candidates, runs, assignments, and outcomes.

Authority
insights:read
Population
caller supplied evaluations
Freshness
caller_supplied
Delivery
inline, artifact
Provenance: required
Input contract

Screener Status

screener.statusactivity
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Find Copy Trading sources

settings.copy_source.searchsettings parity
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Read complete AI defaults

settings.defaults.readai defaults
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Read saved AI settings library

settings.library.readsettings parity
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Read selectable AI models

settings.models.readai defaults
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Read bot settings

settings.readSettings
Analysis

Inspect, preview, snapshot, apply, and restore bot settings without a fleet-size cap.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
inline, artifact
Provenance: required
Input contract

Inspect bot settings schema

settings.schemaSettings
Analysis

Inspect, preview, snapshot, apply, and restore bot settings without a fleet-size cap.

Authority
insights:read
Population
vtx configuration
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Read owned orders and exchange history

trade.readTrading
Analysis

Place or manage orders for profiles you own.

Authority
insights:read
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Analyze trades since a configuration or prompt change

trade_chain.since_changetrade chain
Analysis

Use this VTX ability in your connected agent.

Authority
insights:read
Population
owned profiles, public profiles, whole platform
Freshness
captured_cutoff
Delivery
artifact
Provenance: required
Input contract

Manage settings

22

Preview, snapshot, tune, and restore settings across one bot or your owned fleet.

Update account display preferences

account.preferences.updateaccount preferences
Can manage settings

Use this VTX ability in your connected agent.

Authority
insights:settings
Population
owned account
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Account Presentation Update

account.presentation.updateaccount presentation
Can manage settings

Use this VTX ability in your connected agent.

Authority
insights:settings
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Disconnect Telegram

notifications.telegram.disconnectnotifications
Can manage settings

Use this VTX ability in your connected agent.

Authority
insights:settings
Population
owned account
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Start a Telegram connection

notifications.telegram.linknotifications
Can manage settings

Use this VTX ability in your connected agent.

Authority
insights:settings
Population
owned account
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Send a test notification

notifications.telegram.testnotifications
Can manage settings

Use this VTX ability in your connected agent.

Authority
insights:settings
Population
owned account
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Update notification settings

notifications.updatenotifications
Can manage settings

Use this VTX ability in your connected agent.

Authority
insights:settings
Population
owned account
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Profile Emoji Update

profile.emoji.updateaccount presentation
Can manage settings

Use this VTX ability in your connected agent.

Authority
insights:settings
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Apply owned fleet settings

settings.applySettings
Can manage settings

Apply an approved common or per-bot settings plan with a pre-change snapshot.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Settings Client_Backup Update

settings.client_backup.updateSettings
Can manage settings

Inspect, preview, snapshot, apply, and restore bot settings without a fleet-size cap.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Select Copy Trading source

settings.copy_source.selectsettings parity
Can manage settings

Use this VTX ability in your connected agent.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Reset complete AI defaults

settings.defaults.resetai defaults
Can manage settings

Use this VTX ability in your connected agent.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Diff owned fleet settings

settings.diffSettings
Can manage settings

Inspect, preview, snapshot, apply, and restore bot settings without a fleet-size cap.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Save AI settings draft to library

settings.library.createsettings parity
Can manage settings

Use this VTX ability in your connected agent.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Delete saved AI settings

settings.library.deletesettings parity
Can manage settings

Use this VTX ability in your connected agent.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Import public bot AI settings into library

settings.library.importsettings parity
Can manage settings

Use this VTX ability in your connected agent.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Rename, favorite or overwrite saved AI settings

settings.library.updatesettings parity
Can manage settings

Use this VTX ability in your connected agent.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Preview owned fleet settings

settings.previewSettings
Can manage settings

Inspect, preview, snapshot, apply, and restore bot settings without a fleet-size cap.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Create fleet settings snapshot

settings.snapshot.createSettings
Can manage settings

Save an immutable rollback point for selected bots or your complete owned fleet.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

List fleet settings snapshots

settings.snapshot.listSettings
Can manage settings

Inspect, preview, snapshot, apply, and restore bot settings without a fleet-size cap.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline, artifact
Provenance: required
Input contract

Read selected fleet snapshot fields

settings.snapshot.readSettings
Can manage settings

Inspect, preview, snapshot, apply, and restore bot settings without a fleet-size cap.

Authority
insights:settings
Population
owned profiles
Freshness
immutable_snapshot_state
Delivery
inline, artifact
Provenance: required
Input contract

Restore fleet settings snapshot

settings.snapshot.restoreSettings
Can manage settings

Restore an approved fleet snapshot with version checks and complete per-bot outcomes.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Update owned bot settings

settings.updateSettings
Can manage settings

Apply approved AI and bot-setting changes to a profile you own.

Authority
insights:settings
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Control bots

16

Inspect, start, stop, restart, trigger immediate cycles, or change execution mode across your owned bot fleet. Ask models paid follow-up questions about retained decisions and save their answers.

Start Server Mode Assistants

control.assistant.startBot control
Can control bots

Start the dry-run Assistant for one, selected, or all owned Server Mode profiles.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Stop Server Mode Assistants

control.assistant.stopBot control
Can control bots

Stop the dry-run Assistant for one, selected, or all owned Server Mode profiles.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Restart Server Mode bots

control.bot.restartBot control
Can control bots

Restart one, selected, or all owned Server Mode bots with resumable stop/start stages.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Start a bot

control.bot.startBot control
Can control bots

Start one, selected, or all owned Server or Client Mode bots through normal VTX runtime checks.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Stop a bot

control.bot.stopBot control
Can control bots

Stop one, selected, or all owned Server or Client Mode bots and retain every verified outcome.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Run Server Mode bots now

control.bot.trigger_analysisBot control
Can control bots

Request an immediate cycle for active owned Server Mode Traders or dry-run Assistants; Trader cycles may place trades.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Change execution mode

control.execution_mode.updateBot control
Can control bots

Move one, selected, or all owned profiles between Client Mode and Server Mode.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Ask a decision follow-up

decision.chat.askdecision chat
Can control bots

Use this VTX ability in your connected agent.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Reset an owned decision conversation

decision.chat.resetdecision chat
Can control bots

Use this VTX ability in your connected agent.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Replay decisions with prompt or model variants

decision.replaydecision replay
Can control bots

Use this VTX ability in your connected agent.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
artifact
Provenance: required
Input contract

Save a decision replay scenario set

decision.replay.sets.savedecision replay
Can control bots

Use this VTX ability in your connected agent.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Host Command

host.commandclient host
Can control bots

Use this VTX ability in your connected agent.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Host Command Cancel

host.command.cancelclient host
Can control bots

Use this VTX ability in your connected agent.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Resume configured Screener automation

screener.resumeBot control
Can control bots

Inspect or control owned Server Mode bots.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Run the Screener now

screener.runBot control
Can control bots

Inspect or control owned Server Mode bots.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Stop the current Screener run

screener.stopBot control
Can control bots

Inspect or control owned Server Mode bots.

Authority
insights:control
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Trade

11

Place market and limit orders or cancel open orders for profiles you own.

Run a fleet trading batch

trade.batchTrading
Can trade

Run an ordered, resumable mix of trading actions across any number of owned profiles.

Authority
insights:trade
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Cancel all owned-profile orders

trade.cancel_all_ordersTrading
Can trade

Place or manage orders for profiles you own.

Authority
insights:trade
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Cancel an open order

trade.cancel_orderTrading
Can trade

Cancel an open order for a profile you own.

Authority
insights:trade
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Cancel a TWAP order

trade.cancel_twapTrading
Can trade

Cancel one exact owned-profile TWAP and verify its latest exchange state.

Authority
insights:trade
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Close every position

trade.close_all_positionsTrading
Can trade

Close every open position for one owned profile after explicit confirmation.

Authority
insights:trade
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Close a position

trade.close_positionTrading
Can trade

Close one complete owned-profile position and verify the market is flat.

Authority
insights:trade
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Place a limit order

trade.limit_orderTrading
Can trade

Place a limit order for a profile you own.

Authority
insights:trade
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Place a market order

trade.market_orderTrading
Can trade

Place a market order, including reduce-only closes, for a profile you own.

Authority
insights:trade
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Place a scale order

trade.scale_orderTrading
Can trade

Place a complete ladder of limit orders and retain every child outcome.

Authority
insights:trade
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Place a trigger order

trade.trigger_orderTrading
Can trade

Place a take-profit or stop-loss trigger order for a profile you own.

Authority
insights:trade
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Update market leverage

trade.update_leverageTrading
Can trade

Update cross or isolated leverage for one owned-profile market.

Authority
insights:trade
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Manage profiles

8

Create, clone, rename, reorder, archive, or restore profiles you own, and manage your referral code.

Archive bot profiles

profile.archiveProfile management
Can manage profiles

Archive stopped owned profiles while preserving at least one active profile.

Authority
insights:profiles
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Clone bot profiles

profile.cloneProfile management
Can manage profiles

Clone settings from owned profiles without copying wallets, keys, or credentials.

Authority
insights:profiles
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Create bot profiles

profile.createProfile management
Can manage profiles

Create one or more owned profiles through the account's current capacity rules.

Authority
insights:profiles
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Rename bot profiles

profile.renameProfile management
Can manage profiles

Rename owned profiles through the same uniqueness and cooldown rules as VTX.

Authority
insights:profiles
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Profile Reorder

profile.reorderaccount presentation
Can manage profiles

Use this VTX ability in your connected agent.

Authority
insights:profiles
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Restore bot profiles

profile.restoreProfile management
Can manage profiles

Restore selected or all archived profiles you own.

Authority
insights:profiles
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Referrals Code Update

referrals.code.updateaccount finance
Can manage profiles

Use this VTX ability in your connected agent.

Authority
insights:profiles
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Referrals Initialize

referrals.initializeaccount finance
Can manage profiles

Use this VTX ability in your connected agent.

Authority
insights:profiles
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Manage connections

16

Add, validate, replace, or remove exchange and model-provider credentials. Secrets you save are never displayed back; a MetaTrader 5 bridge code VTX creates is shown once.

Read Local AI or OpenAI-compatible connection

credentials.endpoint.readendpoint connections
Can manage connections

Use this VTX ability in your connected agent.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Remove Local AI or OpenAI-compatible connection

credentials.endpoint.removeendpoint connections
Can manage connections

Use this VTX ability in your connected agent.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Update Local AI or OpenAI-compatible connection

credentials.endpoint.updateendpoint connections
Can manage connections

Use this VTX ability in your connected agent.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Connect an exchange account

credentials.exchange.createConnection management
Can manage connections

Connect owned-profile exchange wallets and signing keys through canonical validation.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Remove exchange connections

credentials.exchange.removeConnection management
Can manage connections

Remove explicitly confirmed exchange wallet and signing-key connections.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Replace an exchange connection

credentials.exchange.replaceConnection management
Can manage connections

Replace an exchange connection after wallet ownership and signed-action validation.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Validate exchange connections

credentials.exchange.validateConnection management
Can manage connections

Validate configured exchange connections without returning wallet keys.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Connect a model provider

credentials.provider.createConnection management
Can manage connections

Connect model-provider keys to owned profiles through encrypted write-only storage.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Read ordered model-provider key references

credentials.provider.readConnection management
Can manage connections

Manage write-only exchange and model-provider connections for profiles you own.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Remove model-provider connections

credentials.provider.removeConnection management
Can manage connections

Remove explicitly confirmed model-provider connections from owned profiles.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Replace a model-provider connection

credentials.provider.replaceConnection management
Can manage connections

Replace complete model-provider key sets without exposing the previous or new values.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Validate model-provider connections

credentials.provider.validateConnection management
Can manage connections

Validate configured model-provider connections and return status metadata only.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Remove a bot's exchange account

exchange.account.removeexchange
Can manage connections

Use this VTX ability in your connected agent.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Create a bot's exchange key

exchange.key.createexchange
Can manage connections

Use this VTX ability in your connected agent.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Set a bot's exchange API key

exchange.key.setexchange
Can manage connections

Use this VTX ability in your connected agent.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Choose a bot's exchange

exchange.updateexchange
Can manage connections

Use this VTX ability in your connected agent.

Authority
insights:credentials
Population
owned profiles
Freshness
live_authoritative_state
Delivery
inline
Provenance: required
Input contract

Manage account security

22

Manage sessions and connected apps. Sensitive account changes require verification in VTX; secrets stay in your browser.

Account Access Grants Read

account.access.grants.readaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Access Grants Update

account.access.grants.updateaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Info Read

account.info.readaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Account Delete

account.security.account.deleteaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Agent_Tokens Create

account.security.agent_tokens.createaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Agent_Tokens Read

account.security.agent_tokens.readaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Agent_Tokens Revoke

account.security.agent_tokens.revokeaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Detached_Runtime Read

account.security.detached_runtime.readaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Detached_Runtime Revoke

account.security.detached_runtime.revokeaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Email Disable

account.security.email.disableaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Email Enable

account.security.email.enableaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Passkeys Delete

account.security.passkeys.deleteaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Passkeys Read

account.security.passkeys.readaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Passkeys Register

account.security.passkeys.registeraccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Passkeys Rename

account.security.passkeys.renameaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Password Change

account.security.password.changeaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Sessions Read

account.security.sessions.readaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Sessions Revoke

account.security.sessions.revokeaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Sessions Terminate_All

account.security.sessions.terminate_allaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Totp Disable

account.security.totp.disableaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Totp Enroll

account.security.totp.enrollaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Account Security Totp Recovery Rotate

account.security.totp.recovery.rotateaccount access
Manage account security

Use this VTX ability in your connected agent.

Authority
insights:account_security
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Manage billing

1

Read billing details and prepare checkout. Complete payment with the payment provider.

Billing Checkout Create

billing.checkout.createaccount finance
Manage billing

Use this VTX ability in your connected agent.

Authority
insights:billing
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Publish content

11

Publish and manage comments and permitted News content, report comments and bots, and block users.

Content Blocks Create

content.blocks.createcommunity content
Publish content

Use this VTX ability in your connected agent.

Authority
insights:content
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Content Blocks Delete

content.blocks.deletecommunity content
Publish content

Use this VTX ability in your connected agent.

Authority
insights:content
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Content Blocks List

content.blocks.listcommunity content
Publish content

Use this VTX ability in your connected agent.

Authority
insights:content
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Content Comments Create

content.comments.createcommunity content
Publish content

Use this VTX ability in your connected agent.

Authority
insights:content
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Content Comments Delete

content.comments.deletecommunity content
Publish content

Use this VTX ability in your connected agent.

Authority
insights:content
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Content Comments Update

content.comments.updatecommunity content
Publish content

Use this VTX ability in your connected agent.

Authority
insights:content
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Content Images Upload

content.images.uploadcommunity content
Publish content

Use this VTX ability in your connected agent.

Authority
insights:content
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Content Posts Create

content.posts.createcommunity content
Publish content

Use this VTX ability in your connected agent.

Authority
insights:content
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Content Posts Delete

content.posts.deletecommunity content
Publish content

Use this VTX ability in your connected agent.

Authority
insights:content
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Content Posts Update

content.posts.updatecommunity content
Publish content

Use this VTX ability in your connected agent.

Authority
insights:content
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Content Reports Create

content.reports.createcommunity content
Publish content

Use this VTX ability in your connected agent.

Authority
insights:content
Population
Not specified
Freshness
captured_cutoff
Delivery
inline
Provenance: required
Input contract

Administer VTX

0

Administrator operations on accounts, credits, bot start and stop, execution mode, model administration, and community reports and moderation, all under one short-lived administrator verification.

Setup, troubleshooting, and lifecycle

Open this reference when connecting, updating, disconnecting, or recovering an agent app.

Troubleshooting

Get a connection or workflow back on track quickly.

My agent app cannot find VTX Insights

Refresh its plugin or MCP integrations, confirm VTX Insights is enabled, or use the manual setup shown on this page. Update the app or integration if it is still unavailable.

VTX asks me to sign in again

Start the agent's VTX sign-in flow, choose the permissions you want, and approve the connection. If access was revoked or expired, relink the client from this page.

My agent reports Auth required

Start VTX authentication from the MCP client and approve the browser request. In ChatGPT desktop use Settings, MCP servers, VTX Insights, and Authenticate. In Codex CLI or the IDE run codex mcp login vtx-insights --scopes insights:read.

Codex reports Authorization server response missing required issuer

Codex 0.146.0 has a known OAuth issuer-validation regression. Check codex --version, upgrade Codex, and start a new VTX login.

My agent reports Insights tool discovery failed

OAuth succeeded, but VTX could not return the authorized MCP tool catalog. This is a VTX MCP service or catalog problem, not a request for more browser or extension permissions. Retry after VTX service health is restored.

VTX reports Authorization request is unavailable

That authorization link is no longer usable. Return to the MCP client and start a new login; do not reuse the URL.

A result looks incomplete

Ask which profiles and time window were used, what was unavailable, and whether population coverage differs from exact-economics coverage. Replay and excursion calculations run when requested; they are not an always-running simulator or an exact alternate-PnL forecast. Excursion coverage uses fully completed candles at a disclosed resolution, so an unfinished candle is not a gap, open-position results stay provisional, and a completed analysis alone does not prove complete MAE/MFE. Temporary market-data limits can delay recovery, and remaining gaps stay visible.

My agent reports profile selection unavailable

At least one exact handle or wallet could not be resolved in the selected owned or public population. Ask the agent to discover the profiles again, confirm each ownership label, and retry with the corrected exact selection. VTX stops before starting a background analysis rather than silently analyzing a smaller population.

The model's conclusion looks wrong

Ask it to show the VTX evidence and calculations, challenge the assumptions, or try a different approach. Models can make mistakes; VTX does not approve or correct their conclusions.

An analysis is taking a long time

The agent can continue the complete analysis in the background and resume retrieval from its last acknowledged checkpoint without shrinking the profiles or time window you asked for.

My agent cannot query a targeted artifact path

Targeted discovery is recursive and does not change the server index. The agent should query the artifact root, then each needed disclosed object path and continuation, then the disclosed list parent before batching exact child paths. Large typed filters scan that exact indexed parent incrementally and may continue through background analysis if they exceed the response window.

My agent lacks a newly added permission

Existing connections keep only the permissions you approved earlier. Use Relink on this page, then sign in again from the agent and approve the new permission.

Open orders show unavailable freshness

The exchange state is unknown, not empty, so it does not mean there are no orders. Retry after the source recovers. During an account-data outage, account and performance values stay unavailable while complete market-regime data remains visible.

My agent says a symbol replacement is blocked

The result says whether an open position, unavailable position data, active automation, an unsettled exchange action, or changed signing authority blocked it. The existing symbols stay assigned, and a blocked result does not authorize closing positions or forcing the replacement.

A runtime-history request is too large

Insights marks that evidence unavailable instead of reporting partial counts. Use a shorter period or fewer profiles; recorded history and financial results are unaffected.

FAQ

The essentials of agent choice, permissions, trading, and control.

Can VTX Insights trade or change my bot?

Yes. With your approval, a connected agent can update AI settings on profiles you own, control Server Mode bots, request Client Mode Trader starts and stops, and place or cancel orders on profiles you own. For a Client Mode profile, the order is sent to that profile's open VTX app, which signs it on your device; if no app is open, nothing is sent. Scale orders, Close All, and TWAP cancellation stay unavailable in Client Mode, as on the Trade page. Client control does not take over an owner; waiting for an eligible browser, desktop, or headless owner is not the same as running, and an in-flight stop may wait for settlement before its owner lease is revoked. Client Mode starts, Assistant runs, immediate cycles, and Screener requests report whether they are queued, claimed, waiting for an owner, completed, or failed; a queued request does not mean a bot is running.

Do I need to teach my agent how to analyze a trade chain?

No. The VTX Insights connector ships a dedicated trade-chain analysis skill for Codex, Claude Code, Google Antigravity, OpenCode, OpenClaw, Hermes Agent, and other compatible skill hosts. It teaches the agent how to reconstruct bot campaigns, compare settings generations, verify evidence, and recommend focused improvements.

Can I analyze another public VTX profile?

Yes. Select exact public handles or wallets, or compare the whole platform. Actions always remain limited to profiles you own.

Does VTX choose the model?

No. The connected agent app owns model choice, conversation, inference, and native tools.

Are large results summarized?

The response may summarize the result, but complete evidence remains available for focused indexed queries or restart-safe acknowledged retrieval.

How are model comparisons and ROI calculated?

Comparisons across owned or public bots over the same period use the model that actually answered, distinguished from configured and fallback models. They include open-position gains and losses through account-equity changes, adjusted for deposits and withdrawals when that history is complete; when it is not yet complete, the result assumes no deposits, withdrawals, or transfers in the period and says so, and you can tell your agent about any transfer so it is accounted for. Bots without decisions stay in the comparison. Before a detailed ROI review, Insights checks for comparable account values and complete cashflow history and names any missing periods or sources; a gap in that history does not hold back the result or a review of trading behavior.

Can my agent ask a bot why it made a decision?

Yes. With Control bots, your agent can ask a follow-up about one of your bot's retained decisions. It uses the model that answered that decision, including a fallback model, and reports unsupported routes instead of substituting. The answer is a new explanation, not proof of the original reasoning. Each question costs a normal model call and saves the conversation, which read access can reopen. It never changes settings, starts a bot, or places a trade, and after an interruption the agent checks the saved conversation before asking again.

Can I undo a settings change made by my agent?

Yes. Ask it to restore a saved rollback snapshot. Settings and prompts restore while the bot keeps running unless an assigned symbol is removed, which requires stopped automation and a fresh check that no position remains. Restoring never switches execution mode or starts a stopped bot.

What account actions can my agent take?

With the matching permissions, it can create, rename, reorder, archive, and restore profiles, manage referral codes, change timezone preferences, read billing, usage, referrals, and tax reports, prepare a credit checkout, manage your News and Updates comments, and manage sessions, connected apps, agent tokens, password, two-factor, recovery codes, and passkeys. Payment finishes on the payment provider's page. Security changes finish in a signed-in VTX verification page that keeps secrets in your browser, and your agent receives only the result. Changing credentials or ending sessions may require you to sign in and reconnect the agent.With the matching permissions, it can create, rename, reorder, archive, and restore profiles, manage referral codes, change timezone preferences, read usage, referrals, and tax reports, manage your News and Updates comments, and manage sessions, connected apps, agent tokens, password, two-factor, recovery codes, and passkeys. Security changes finish in a signed-in VTX verification page that keeps secrets in your browser, and your agent receives only the result. Changing credentials or ending sessions may require you to sign in and reconnect the agent.

Where should I ask general VTX support questions?

Use VTX Help for product guidance outside Insights, or join the VTX Macro Telegram group for community help and setup discussion. Connected agent apps can also search and open the same canonical Help content.

Update, disconnect, and recover

Keep the agent integration current and remove access whenever a connected app is no longer trusted.

Refresh the agent app's marketplace or registry and install the current compatible package version.
Disable the integration temporarily when supported, or uninstall it from the agent app.
Disconnect the agent from this page whenever you no longer want it to use VTX.
Use Relink to remove the old connection first, then sign in again from the agent.
If an agent remains stuck, remove its saved VTX connection, reinstall or reconfigure it, and sign in again.