Turn Codex into your VTX trading copilot
Connect your agent app to investigate bot results, reconstruct available trade-chain evidence, improve settings, control owned bots, and trade through VTX. Approve each action permission separately.
Analyze
26Manage settings
7Control bots
8Trade
10Manage profiles
6Manage connections
8Trade-chain analysis
Go beyond aggregate PnL and connect the available settings, decisions, executions, and outcomes behind a bot's trading campaigns.
Follow the full chain
Connect settings generations and decision-time context to model reasoning, executions, fills, position changes, exits, fees, funding, and realized results.
Explain the mechanism
Separate strategy mistakes from market variance, thin liquidity, timing, overtrading, sizing, exit management, execution quality, and recent configuration changes.
Improve from evidence
Compare losing chains with profitable counterexamples, preserve what works, and distinguish retained, same-decision repaired, recomputed, or unavailable evidence before proposing a small reversible experiment.
Connect
Choose an agent app, approve only the access it needs, and start working with VTX in the same conversation.
Quick install
codex plugin marketplace add DataDoesYou/codex plugin add 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.
Connected agent apps
See which agent apps can use VTX, what each one may do, and remove access at any time.
The complete guide is public. Your connections, permissions, profile data, and actions remain private.
Connections are governed by the Privacy Policy and Terms of Service.
Use
Describe the outcome you want and let the agent choose the best VTX and native tools for the job.
Name the population: my profiles, exact public handles or wallets, or the whole platform.
Name the time window and the decision you are trying to make.
Ask for the analysis, comparison, recommendation, or action that helps you decide.
Review important assumptions and approve consequential changes or trades in plain language.
Treat policy replay as a counterfactual, not as observed live performance.
Your agent stays in charge
Codex 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 management, bot control, profile management, connection management, and trading access separately. Your agent app receives only the permissions you approve.
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
Insights is built for trading and bot operations. Manage billing and account security directly in VTX.
Examples
Explore live examples drawn from current VTX trading activity, then copy a prompt to take the analysis further.
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.
Prompt ideas
Search starting points for performance reviews, trade-chain analysis, settings ideas, market research, and VTX product help.
How am I trading this week?
How is this account trading this week?
How am I trading this month?
Compare all my bots this month. Which model is performing best?
What was my account PnL and ROI over the last 30 days?
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.
Analyze
26Markets, profiles, decisions, settings, performance, and strategy evidence.
Analyze
26Markets, profiles, decisions, settings, performance, and strategy evidence.
Read account snapshot
Inspect live positions, balances, orders, fills, and account activity.
Start long analysis
Start or resume a complete analysis that needs more time to finish.
Check long analysis
Start or resume a complete analysis that needs more time to finish.
Analyze trading data
Compare performance, settings, trades, decisions, and strategy outcomes.
Continue a large analysis
Work through complete large result sets without losing requested evidence.
Search analysis evidence
Work through complete large result sets without losing requested evidence.
Read more analysis evidence
Work through complete large result sets without losing requested evidence.
Read decision context
Inspect the market and bot context behind stored trading decisions.
Analyze decision outcomes
Connect stored decisions with what happened afterward.
Read decision history
Compare performance, settings, trades, decisions, and strategy outcomes.
Analyze execution quality
Analyze fills, fees, slippage, and order execution quality.
Open VTX help
Find current VTX product guidance and operating behavior.
Search VTX help
Find current VTX product guidance and operating behavior.
Read market calendar
Read current markets, price history, news, and the economic calendar.
Read market history
Read current markets, price history, news, and the economic calendar.
Read market news
Read current markets, price history, news, and the economic calendar.
Read market snapshot
Read current markets, price history, news, and the economic calendar.
Evaluate retained trading policy
Replay trading policies and compare counterfactual outcomes.
Replay trading policy
Replay trading policies and compare counterfactual outcomes.
Analyze position excursions
Compare performance, settings, trades, decisions, and strategy outcomes.
Read position episodes
Compare performance, settings, trades, decisions, and strategy outcomes.
Discover VTX profiles
Find your profiles, exact public profiles, or the full public platform.
Trace bot and settings changes
Trace runtime, model, settings, and deployment changes behind behavior.
Read screener history
Inspect Screener candidates, runs, assignments, and outcomes.
Read bot settings
Inspect, preview, snapshot, apply, and restore bot settings without a fleet-size cap.
Inspect bot settings schema
Inspect, preview, snapshot, apply, and restore bot settings without a fleet-size cap.
Manage settings
7Preview, snapshot, tune, and restore settings across one bot or your owned fleet.
Manage settings
7Preview, snapshot, tune, and restore settings across one bot or your owned fleet.
Apply owned fleet settings
Apply an approved common or per-bot settings plan with a pre-change snapshot.
Diff owned fleet settings
Inspect, preview, snapshot, apply, and restore bot settings without a fleet-size cap.
Preview owned fleet settings
Inspect, preview, snapshot, apply, and restore bot settings without a fleet-size cap.
Create fleet settings snapshot
Save an immutable rollback point for selected bots or your complete owned fleet.
List fleet settings snapshots
Inspect, preview, snapshot, apply, and restore bot settings without a fleet-size cap.
Restore fleet settings snapshot
Restore an approved fleet snapshot with version checks and complete per-bot outcomes.
Update owned bot settings
Apply approved AI and bot-setting changes to a profile you own.
Control bots
8Inspect, start, stop, restart, trigger immediate cycles, or change execution mode across your owned bot fleet.
Control bots
8Inspect, start, stop, restart, trigger immediate cycles, or change execution mode across your owned bot fleet.
Start Server Mode Assistants
Start the dry-run Assistant for one, selected, or all owned Server Mode profiles.
Stop Server Mode Assistants
Stop the dry-run Assistant for one, selected, or all owned Server Mode profiles.
Restart Server Mode bots
Restart one, selected, or all owned Server Mode bots with resumable stop/start stages.
Start a Server Mode bot
Start one, selected, or all owned Server Mode bots through normal VTX runtime checks.
Check Server Mode bot status
Check complete Server Mode status for one, selected, or all profiles you own.
Stop a Server Mode bot
Stop one, selected, or all owned Server Mode bots and retain every verified outcome.
Run Server Mode bots now
Request an immediate cycle for active owned Server Mode Traders or dry-run Assistants; Trader cycles may place trades.
Change execution mode
Move one, selected, or all owned profiles between Client Mode and Server Mode.
Trade
10Place market and limit orders or cancel open orders for profiles you own.
Trade
10Place market and limit orders or cancel open orders for profiles you own.
Run a fleet trading batch
Run an ordered, resumable mix of trading actions across any number of owned profiles.
Cancel an open order
Cancel an open order for a profile you own.
Cancel a TWAP order
Cancel one exact owned-profile TWAP and verify its latest exchange state.
Close every position
Close every open position for one owned profile after explicit confirmation.
Close a position
Close one complete owned-profile position and verify the market is flat.
Place a limit order
Place a limit order for a profile you own.
Place a market order
Place a market order, including reduce-only closes, for a profile you own.
Place a scale order
Place a complete ladder of limit orders and retain every child outcome.
Place a trigger order
Place a take-profit or stop-loss trigger order for a profile you own.
Update market leverage
Update cross or isolated leverage for one owned-profile market.
Manage profiles
6Create, clone, rename, archive, restore, or delete profiles you own.
Manage profiles
6Create, clone, rename, archive, restore, or delete profiles you own.
Archive bot profiles
Archive stopped owned profiles while preserving at least one active profile.
Clone bot profiles
Clone settings from owned profiles without copying wallets, keys, or credentials.
Create bot profiles
Create one or more owned profiles through the account's current capacity rules.
Delete bot profiles
Permanently delete explicitly confirmed owned profiles after runtime safety checks.
Rename bot profiles
Rename owned profiles through the same uniqueness and cooldown rules as VTX.
Restore bot profiles
Restore selected or all archived profiles you own.
Manage connections
8Add, validate, replace, or remove exchange and model-provider credentials. Secrets are never displayed back.
Manage connections
8Add, validate, replace, or remove exchange and model-provider credentials. Secrets are never displayed back.
Connect an exchange account
Connect owned-profile exchange wallets and signing keys through canonical validation.
Remove exchange connections
Remove explicitly confirmed exchange wallet and signing-key connections.
Replace an exchange connection
Replace an exchange connection after wallet ownership and signed-action validation.
Validate exchange connections
Validate configured exchange connections without returning wallet keys.
Connect a model provider
Connect model-provider keys to owned profiles through encrypted write-only storage.
Remove model-provider connections
Remove explicitly confirmed model-provider connections from owned profiles.
Replace a model-provider connection
Replace complete model-provider key sets without exposing the previous or new values.
Validate model-provider connections
Validate configured model-provider connections and return status metadata only.
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.
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.
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 retrieve the finished result without shrinking the profiles or time window you asked for.
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 their Server Mode bots, and place or cancel orders through VTX.
Do I need to teach Codex how to analyze a trade chain?
No. The VTX Insights Codex connector installs a dedicated trade-chain analysis skill that teaches Codex 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 the complete evidence remains available for the agent to inspect or query in focused pieces.
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.