add_to_watchlist |
Add a new asset to your persistent watchlist.
Args:
asset: Asset symbol (e.g. 'EUR_USD', 'BTC_USD')
|
agent_approveread-only |
Approve a pending agent action (trade entry, exit, modification).
Args:
action_id: The pending action ID to approve
adjust_sl: Optional adjusted stop-loss price
adjust_tp: Optional adjusted take-profit price
adjust_size: Optional adjusted position size (units)
Returns:
Result of the executed action
Example:
"Approve action xyz789" or "Approve the pending EUR/USD trade"
|
agent_historyread-only |
Get historical performance and actions for an agent.
Args:
agent_id: Specific agent, or omit for all agents
days: Number of days of history (1-90). Default: 7
include_cycles: Include detailed scan cycle logs
include_trades: Include trade history. Default: True
limit: Max trades per agent (the Pro Terminal dashboard sends
this; unknown args previously made the whole call fail)
Returns:
Historical performance data, trade log, and statistics
Example:
"Show me my agent's trading history for the past week"
|
agent_link_telegramread-only |
Link your Telegram account to receive agent notifications.
To get your Telegram chat ID:
1. Open Telegram and search for @userinfobot
2. Start the bot and it will show your ID
3. Copy the number and use it here
Args:
telegram_chat_id: Your Telegram chat ID (a number like "123456789")
Returns:
Confirmation of successful linking
Example:
"Link my Telegram with chat ID 123456789"
|
agent_list_strategiesread-only |
List all available trading strategies with descriptions.
Returns information about each strategy including:
- Recommended timeframes and instruments
- Typical hold times
- Risk profile
- Minimum scan interval
Example:
"What trading strategies can the agent use?"
|
agent_modifyread-only |
Modify a running agent's parameters.
Args:
agent_id: The agent ID to modify
risk_per_trade: New risk per trade percentage (0.1-5.0)
max_positions: New maximum concurrent positions (1-10)
control_level: New control level ("manual", "supervised", "semi_auto", "full_auto")
scan_interval_minutes: New scan interval in minutes
instruments: Replace instrument list entirely
add_instruments: Add instruments to existing list
remove_instruments: Remove instruments from list
custom_rules: Update custom instructions
pause: True to pause agent, False to resume
min_score: Minimum sentiment score for scan filtering (0-100)
sentiment_threshold: (HFT) Minimum abs(score) to trigger signal (50-100)
sl_pips: (HFT) Stop loss in pips (1-50)
tp_multiplier: (HFT) Take profit multiplier on SL distance (1.0-5.0)
exclude_categories: Asset categories to exclude from scanning/trading.
Options: "forex", "crypto", "indices", "commodities", "metals", "bonds".
Pass empty list [] to clear exclusions.
exclude_instruments: List of specific instruments to exclude from trading,
e.g. ["USD_TRY", "EUR_TRY"]. Pass empty list [] to clear exclusions.
allow_closed_markets: If True, generate signals for closed markets using
limit orders instead of market orders. Default: False (skip closed markets).
auto_scan: Enable/disable dynamic scanning. When True with empty instruments,
agent rescans market each cycle to find fresh opportunities.
Returns:
Updated agent configuration
Example:
"Change my agent to 0.5% risk" or "Add GBP/USD to the agent"
|
agent_notification_settingsread-only |
View your notification settings and linked accounts.
Returns:
Your current notification preferences and linked services
Example:
"Show my notification settings"
|
agent_rejectread-only |
Reject a pending agent action.
Args:
action_id: The pending action ID to reject
reason: Optional reason for rejection (helps agent learn)
pause_agent: If True, pause the agent after rejection
Returns:
Confirmation of rejection
Example:
"Reject that trade, the spread is too high right now"
|
agent_startread-only |
Start an autonomous trading agent with specified strategy.
This creates a new agent that will scan markets, analyze opportunities,
and trade (or request approval) based on your configuration.
Args:
strategy: Strategy type - "swing", "scalper", "news_trader", "trend_follower", "breakout", "mean_reversion", "hft"
instruments: List of instruments to trade, e.g. ["EUR_USD", "XAU_USD"]. Optional if auto_scan=True.
auto_scan: If True, automatically scan market to find high-scoring opportunities. Default: False
scan_min_score: Minimum score (0-100) for auto-scanned instruments. Default: 70
scan_limit: Maximum number of instruments from scan results. Default: 10
exclude_instruments: List of instruments to exclude from trading, e.g. ["BTC_USD", "ETH_USD"]
timeframes: Timeframes to analyze, e.g. ["H1", "H4", "D"]. Defaults to strategy recommendation.
risk_per_trade: Maximum risk per trade as % of account (0.5-5.0). Default: 1.0
max_positions: Maximum concurrent open positions (1-10). Default: 3
control_level: Autonomy level. Options:
- "manual": Analysis only, no trading
- "supervised": Agent proposes trades, you approve each one
- "semi_auto": Auto-execute small trades, approve larger ones
- "full_auto": Fully autonomous within risk limits
scan_interval_minutes: How often to scan market (5-1440). Default: 60
notifications: Channels for alerts - ["telegram", "email", "push"]. Default: ["telegram"]
custom_rules: Optional custom instructions for the agent
min_score: Minimum sentiment score for scan filtering (0-100). Overrides strategy default.
sentiment_threshold: (HFT) Minimum abs(score) to trigger signal (50-100). Default: 80
sl_pips: (HFT) Stop loss in pips (1-50). Default: 10
tp_multiplier: (HFT) Take profit multiplier on SL distance (1.0-5.0). Default: 1.5
exclude_categories: Asset categories to exclude from scanning/trading.
Options: "forex", "crypto", "indices", "commodities", "metals", "bonds".
e.g. ["crypto", "bonds"] to skip all crypto and bond instruments.
allow_closed_markets: If True, generate signals for closed markets using
limit orders (executed when market reopens). Default: False (skip closed markets).
cooldown_enabled: If True, enforce cooldown period after trading a pair. Default: True.
cooldown_hours: Hours to wait before re-trading same instrument. Default: 4.
allow_wide_spreads: If True, trade even when spread is abnormally wide (3x+ typical).
Default: False. Useful for exotic pairs with naturally wide spreads.
Returns:
Agent details including ID, status, and next scan time
Examples:
"Start a scalper agent, auto-scan for opportunities with score > 80"
"Start a swing agent on EUR/USD and Gold, exclude crypto"
"Start an HFT agent on EUR/USD with 5 pip stop loss and 2x take profit"
|
agent_statusread-only |
Get status of one or all your agents.
Args:
agent_id: Specific agent ID, or omit for all agents
Returns:
Agent status including P&L, open positions, pending approvals
Example:
"What is my agent doing?" or "Show status of agent abc123"
|
agent_stopread-only |
Stop a running agent.
Args:
agent_id: The agent ID to stop
close_positions: If True, close all positions opened by this agent
cancel_pending: If True, cancel all pending orders from this agent
Returns:
Confirmation of agent stop and any actions taken
Example:
"Stop agent abc123 and close all its positions"
|
analyze_assetread-only |
Run a one-shot technical analysis for a SINGLE asset on a SINGLE timeframe.
Use this when the user asks about ONE specific asset by name, e.g.:
- "analyze EUR_USD"
- "give me your read on BTC on the 4-hour"
- "what's the signal on gold?"
- "deep analysis on SOL/USDC daily"
For multi-asset surveys ("scan the market", "find opportunities",
"what looks bullish today") use scan_market INSTEAD — that scans
the full universe and returns top setups by sentiment score.
Calling analyze_asset for a market-scan query is incorrect and
wastes tokens; the user wants a ranked list, not a deep dive on
one asset they didn't even name.
Args:
asset: Asset symbol (e.g., EUR_USD, XAU_USD, BTC, ETH)
timeframe: Timeframe for analysis (D, H4, H1, M30, M15, M5, M1)
priceType: Price type - B (bid), A (ask), or M (mid)
timeoutSec: Timeout in seconds (5-120)
language: Optional. The language for the written analysis and the
spoken narration — "es", "pt", "zh", "ja". Omit it and nothing
changes: the prose follows the language stored on the user's
profile, which is what every existing client gets today. Pass it
and it wins, because the caller knows what is on screen now while
a stored preference read from another process can be a cache
interval behind. Numbers, instrument symbols and every structured
field stay English either way.
Returns:
Analysis results with status, signals, and recommendations
|
analyze_timeframesread-only |
Analyze a single asset across multiple timeframes simultaneously.
Args:
asset: Asset symbol (e.g., EUR_USD)
timeframes: List of timeframes (e.g., ["D", "H4", "H1"])
priceType: B (bid), A (ask), or M (mid)
timeoutSec: Overall timeout in seconds (30-300)
Returns:
Multi-timeframe analysis results
|
analyze_watchlistread-only |
Analyze multiple assets from the user's SAVED watchlist in parallel.
Args:
timeframe: Timeframe (D, H4, H1, etc.)
priceType: B (bid), A (ask), or M (mid)
timeoutSec: Overall timeout in seconds (30-300)
(optional) timeframes: list of timeframes (timeframes mode) – if provided, supersedes timeframe
(optional) max_assets: limit how many watchlist assets to analyze (default: all)
Returns:
Results for all watchlist assets with analysis data
|
backtest_historyread-only |
List recent backtest runs, optionally filtered by instrument.
Args:
instrument: Filter by instrument (optional)
limit: Max results (1-50). Default: 20
Returns:
List of recent backtest runs with summary stats
Example:
"Show my backtest history" or "Show backtests for XAU_USD"
|
backtest_list_savedread-only |
List saved parameter presets, optionally filtered by instrument.
Args:
instrument: Filter by instrument (optional)
Returns:
List of saved parameter sets
Example:
"Show my saved backtest params" or "Show saved params for EUR_USD"
|
backtest_optimizeread-only |
Grid search optimization to find the best parameter set for an instrument.
Tests all combinations of sentiment_threshold, SL distance, and
tp_multiplier and ranks results by the chosen metric. On forex/OANDA
the SL grid is sl_pips_range (pips); on Hyperliquid, where pips are
meaningless for crypto perps, it is sl_pct_range (% of price).
Args:
instrument: Instrument (e.g. EUR_USD, XAU_USD; BTC on Hyperliquid)
timeframe: Candle granularity. Default: H1
count: Historical candles to fetch (100-5000). Default: 5000
threshold_range: Comma-separated sentiment thresholds to test. Default: "70,75,80,85,90,95"
sl_pips_range: Comma-separated SL values in pips (forex). Default: "5,8,10,15,20"
tp_mult_range: Comma-separated TP multipliers. Default: "1.0,1.5,2.0,2.5,3.0"
rank_by: Metric to rank by: "sharpe", "pnl", "profit_factor", "win_rate". Default: "sharpe"
initial_balance: Starting balance. Default: 10000
lookback: Candles lookback for indicators. Default: 120
spread_pips: Estimated spread in pips (forex). Default: 2.0
sl_pct_range: Comma-separated SL values as % of price (Hyperliquid). Default: "0.5,1.0,1.5,2.0,3.0"
spread_pct: Estimated spread+slippage as % of price (Hyperliquid). Default: 0.05
Returns:
Best parameters and top 50 results ranked by chosen metric
Example:
"Optimize EUR_USD on H4 and find the best threshold and SL"
|
backtest_runread-only |
Run a backtest on historical data using sentiment-based signals.
Uses the same deterministic sentiment scoring as the live scanner
(Bollinger Bands + SMA alignment) to generate buy/sell signals
when abs(score) >= threshold.
Distance mode is automatic: forex/OANDA instruments use pips
(sl_pips/spread_pips); on Hyperliquid, where pips are meaningless
for crypto perps, SL and spread are a percent of price
(sl_pct/spread_pct) and trade "pips" figures are percent moves.
Args:
instrument: Instrument (e.g. EUR_USD, XAU_USD; BTC on Hyperliquid)
timeframe: Candle granularity — M1, M5, M15, M30, H1, H2, H4, H6, H8, H12, D or W
(aliases like 1h/4h/daily accepted; monthly is not available). Default: H1
count: Number of historical candles (100-5000). Default: 5000
sentiment_threshold: Minimum abs(score) to trigger signal (50-100). Default: 80
sl_pips: Stop loss in pips (forex). Default: 10
tp_multiplier: Take profit as multiple of SL. Default: 1.5
risk_per_trade: Risk per trade as % of balance. Default: 1.0
max_positions: Max concurrent positions. Default: 1
spread_pips: Estimated spread in pips (forex). Default: 2.0
lookback: Candles lookback for indicators. Default: 120
initial_balance: Starting balance for simulation. Default: 10000
sl_pct: Stop loss as % of price (Hyperliquid/crypto). Default: 1.0
spread_pct: Estimated spread+slippage as % of price (Hyperliquid). Default: 0.05
Returns:
Backtest results with stats, equity curve, and trade list
Example:
"Backtest EUR_USD on H4 with 90 threshold"
|
backtest_save_paramsread-only |
Save a backtest's parameters as a reusable preset.
Args:
backtest_id: The backtest run ID to save params from
name: Name for this parameter set (e.g. "EUR_USD H4 aggressive")
Returns:
Saved parameter set details
Example:
"Save those backtest params as 'EUR_USD H4 optimal'"
|
cancel_pending_orderdestructive |
Cancel a pending (unfilled) Limit or Stop order.
Args:
order_id: The OANDA ID of the order to cancel.
|
chart_chat_proxyread-only |
Proxy to the Flask /api/chart-chat endpoint using the caller's bearer token.
Keeps token accounting/auth consistent with the web app while exposing chat via MCP.
|
close_positiondestructive | Close position for an instrument. |
close_tradedestructive | Close a specific trade (fully or partially). |
delete_oanda_credentialsdestructive |
Remove/Delete your stored OANDA API Key and Account ID.
Use this if you want to clear your credentials or switch accounts.
|
economic_eventsread-only |
Fetch upcoming economic events via the TradingView proxy source.
Args:
fromDays: Start of date range (days from now, 0-90)
toDays: End of date range (days from now, 0-90)
Returns:
List of economic events with importance, country, and timing
|
fetchread-only |
Retrieve complete forex analysis by ID.
Args:
id: Analysis ID in format "ASSET_TIMEFRAME" (e.g., "EUR_USD_D", "XAU_USD_H4")
Returns:
Full analysis document with technical indicators, signals, and recommendations
|
get_account_historyread-only |
Get account transaction history (e.g. closed trades, order fills).
Useful for finding past trades, reporting, or auditing.
Args:
from_time: Start time (RFC3339 format, e.g. "2023-05-01T00:00:00Z").
to_time: End time (RFC3339).
type_filter: Comma-separated types (e.g. "ORDER_FILL,TRADE_CLOSE"). To see closed trades, use "TRADE_CLOSE".
|
get_blog_articlesread-only |
Get recent articles from the Forex-GPT blog feed.
Args:
max_results: Maximum number of articles to return (1-50, default: 10)
category: Optional category slug to filter by. When unset, the
tool falls back to a broker-aware default:
- hyperliquid containers → "daily-crypto-hype" (ID 24)
so HL users see only crypto-focused content, not the
forex daily AI analysis stream.
- Anything else → site-wide feed.
Pass an explicit slug (e.g. "daily-deep-dive",
"the-weekly-open") to override the default.
Returns:
List of recent blog articles with titles, URLs, summaries, images, and publication dates
|
get_chart_dataread-only |
Retrieve OHLC (candlestick) data for charting.
Args:
asset: Asset symbol (e.g., EUR_USD)
timeframe: Timeframe (D, H4, H1, etc.)
count: Number of candles (50-5000)
Returns:
Candlestick data with timestamps, open, high, low, close prices
|
get_crypto_newsread-only |
Aggregated crypto-news feed from quality free RSS sources
(CoinDesk, Decrypt, Blockworks, The Defiant). Sorted newest-first,
deduped by URL across sources.
Args:
max_results: 1-50, default 25.
ticker: Optional symbol filter (e.g. "BTC", "ETH", "SOL", "HYPE").
When set, only articles mentioning the ticker (case-insensitive
substring match in title OR summary) are returned. Pass "all"
or empty to disable filtering.
Returns:
{status, count, ticker, articles: [{title, url, summary, published,
source, image?}]}
|
get_instrument_cache_statusread-only | |
get_instrument_specsread-only | |
get_live_heatmapread-only |
Generates a real-time Sentiment Heatmap snapshot.
Behavior:
1. If 'assets' are provided, scans those specific assets.
2. If 'assets' not provided, scans the user's saved Watchlist.
3. If Watchlist is empty, scans a default list of popular global assets.
Args:
assets: Optional list of symbols.
timeframe: Granularity (e.g. 'H1', 'D').
|
get_market_categoriesread-only | |
get_market_hoursread-only | |
get_market_moversread-only |
Top gainers, top losers and (Hyperliquid) top 24h volume across the active
broker's whole universe, ranked by daily price change. No Sentiment Score
is computed and no tokens are charged — use scan_market for score rankings.
Hyperliquid: rolling 24h change from the exchange's own reference price,
plus 24h notional volume. OANDA: current daily candle vs the prior close.
Args:
limit: rows per list (1-50, default 25).
liquid_only: Hyperliquid only — rank gainers/losers within the 100
most-traded markets by 24h notional so thin markets don't dominate.
timeframe: OANDA only — candle granularity for the change (default "D").
|
get_open_positionsread-only |
List open positions (Net Exposure per instrument).
Useful to see total Long/Short units and P&L per pair.
|
get_open_tradesread-only | List open trades. |
get_order_historyread-only |
Get OANDA order history (FILLED, CANCELLED, TRIGGERED, etc.).
state: "ALL", "PENDING", "FILLED", "TRIGGERED", "CANCELLED".
count: Max 500.
|
get_pending_ordersread-only |
List all PENDING orders (Limits, Stops, Entry Orders).
These are orders waiting to be filled.
|
get_performance_summaryread-only | Trading-performance aggregates: realized P&L net of fees, total
fees paid, perp funding paid/received, fill count, plus a daily
breakdown for the chart.
Args:
window: "7d" | "30d" | "90d" | "ytd" | "all" (default).
Filters fills + funding by their HL timestamp. Lifetime
totals are always returned alongside the windowed slice.
|
get_price_stream_urlread-only |
Return a short-lived URL for the raw price stream (SSE) for given instruments.
The URL expires after ~10 minutes.
|
get_sentiment_stream_urlread-only |
Return a short-lived URL for the sentiment stream (SSE) for given instruments and granularity.
The URL expires after ~10 minutes.
|
get_server_timeread-only |
Return the server's current UTC timestamp (ISO 8601).
|
get_spreadsread-only |
Checks the current liquidity and trading cost (spread) for an asset.
Useful for checking if a market is too expensive to trade right now.
Args:
asset: The asset symbol (e.g., "EUR_USD", "XAU_USD")
Returns:
Current spread, average spread, and cost in basis points.
|
get_token_balancesread-only |
Return the current user's token balances from Auth0 app_metadata.
Uses _safe_profile() so that the same values shown inside AI analysis
(token_quota, purchased_tokens, total_token_usage, last_reset, email, user_id)
are returned in a simple JSON structure.
|
get_trade_detailsread-only |
Get full details of a specific trade (Open or Closed).
Useful to investigate a trade that disappeared or to see its full history.
|
get_trading_accountread-only | Get trading account summary (balance, margin). |
get_watchlistread-only |
View the assets the user has SAVED to their persistent watchlist.
Use this when the user asks about their watchlist, e.g.:
- "show my watchlist"
- "what's on my watchlist"
- "list my watchlist"
- "what assets am I watching"
This is NOT the same as open positions / trades. The watchlist is a
saved list of asset SYMBOLS the user follows; it has no balance,
P&L, units, or entry-price data. For open positions use
get_open_positions; for open trades use get_open_trades. Do NOT
call get_open_positions or get_open_trades for watchlist queries —
you'd return position data that doesn't match what the user asked.
Returns:
{count, assets, status} — list of saved asset symbols and count.
|
healthread-only |
Comprehensive health and status check including optional upstream dependencies.
Args:
checkOpenAI: Verify OpenAI API connectivity
checkTradingView: Verify TradingView API connectivity
checkOANDA: Verify OANDA API connectivity
Returns:
Health status with environment info and dependency checks
|
help_tutorialread-only |
Master tutorial for MCP tools: usage tips, key parameters, and suggested flows.
|
is_market_openread-only | |
list_assetsread-only |
Return supported asset symbols for the active broker.
For OANDA containers: returns the OANDA universe (~120 instruments).
For Hyperliquid containers: returns the Hyperliquid perp universe
(~230 markets) with per-asset metadata (current price, max leverage,
funding rate, open interest, 24h volume, product_type, sector,
is_pre_launch, is_hip3). When ``include_spot=True`` (default), the
spot universe from ``/info{spotMeta}`` is appended — instruments
tagged ``product_type="spot"`` use ``_USDC`` suffix so they don't
collide with perp canonical names.
Optional:
• filter: substring (case-insensitive) to narrow the list
• asset: specific symbol to test membership
• include_spot: append HL spot markets (HL only; default True)
|
purchase_tokens_x402read-only |
Purchase premium tokens via X402 crypto payment.
Pay $20 USDC to receive 500,000 premium tokens (non-expiring).
These tokens can be used to access all ForexGPT tools and services.
Args:
payment_proof: X402 payment proof containing signature and payment details.
Must include: amount, token, network, nonce, v, r, s, from, to, validAfter, validBefore
Returns:
Success message with new token balance or payment required error.
Example payment_proof:
{
"type": "eip3009",
"amount": "20000000", # $20 USDC (6 decimals)
"token": "USDC",
"network": "eip155:84532", # Base Sepolia
"from": "0x...", # User's wallet
"to": "0x...", # Recipient (ForexGPT treasury)
"nonce": "0x...",
"validAfter": 1234567890,
"validBefore": 1234567890,
"v": 27,
"r": "0x...",
"s": "0x..."
}
|
purchase_tokens_x402_solanaread-only |
Purchase premium tokens via X402 payment on Solana.
Pay $20 USDC on Solana (devnet or mainnet) to receive 500,000 premium
tokens. Credits go to the same purchased_tokens balance used by the
Stripe and EVM rails — one balance, three rails.
Two accepted proof shapes:
signed_authorization (off-chain Ed25519 sig over a canonical message):
{
"type": "signed_authorization",
"network": "solana:devnet",
"token": "USDC",
"from": "<signer pubkey base58>",
"to": "<treasury pubkey base58>",
"amount": "20000000",
"nonce": "<random hex>",
"valid_before": <unix seconds>,
"signature": "<base58 ed25519 signature>"
}
settled_tx (confirmed SPL USDC transfer, fetched and diffed via RPC):
{
"type": "settled_tx",
"network": "solana:devnet",
"token": "USDC",
"from": "<signer pubkey base58>",
"to": "<treasury pubkey base58>",
"amount": "20000000",
"nonce": "<idempotency key>",
"tx_signature": "<base58 transaction signature>"
}
|
refresh_instrument_data |
Manually refresh instrument data from OANDA API.
Updates financing rates, margin requirements, and other parameters.
Requires: User must have saved OANDA credentials via save_oanda_credentials.
Returns:
- success: Boolean indicating if refresh succeeded
- message: Status message
- count: Number of instruments refreshed
- refreshedAt: Timestamp of refresh
Note: This fetches fresh data from OANDA's practice environment.
The cache is automatically refreshed on server startup if data is >24 hours old.
|
remove_from_watchlist |
Remove an asset from your persistent watchlist.
Args:
asset: Asset symbol to remove
|
replace_pending_orderdestructive |
Replace (Modify) an existing pending order.
Basically cancels the old one and places a new one atomically.
Args:
order_id: ID of the order to replace.
type: 'LIMIT' or 'STOP'.
client_nonce: Optional. 32-char hex idempotency token for the new
order. Pass the same value from a prior call's response to retry
safely. Server mints one if absent.
(All other args same as placement tools)
|
research_briefingread-only |
Generate a short AI briefing (one paragraph + three bullets) from the
terminal's current research context: watchlist Sentiment Scores, running
agents and their theses, open positions, upcoming events / headlines and
the latest research article. Charged to the user's tokens like any AI
analysis (1 token = 1 LLM token); refused when the balance can't cover it.
Args:
context: JSON assembled by the terminal — keys: pulse, agents,
positions, events, headlines, article, network, broker.
|
save_broker_credentialsdestructive |
Save broker credentials. Supports multiple brokers.
Args:
broker: The broker name - "oanda", "etoro", or "hyperliquid"
api_key: Your broker API key (OANDA/eToro). NOT used for Hyperliquid (see below).
account_id: Your broker account ID (required for OANDA)
user_key: Your eToro user key (required for eToro)
demo_mode: Use demo/virtual portfolio (eToro only, default True)
Note for Hyperliquid users: Hyperliquid does not use API keys. Instead
you connect a self-custody Web3 wallet and authorize a trading agent
via an on-chain EIP-712 signature. This MCP tool cannot perform that
signature — it requires a wallet popup in the FE. Calling this tool
with broker="hyperliquid" returns instructions instead of saving
anything. Use the FE flow at Settings → Hyperliquid → "Connect Wallet"
+ "Authorize Trading".
|
save_oanda_credentialsdestructive |
Save your OANDA API Key and Account ID securely.
These are required before you can trade.
|
scan_marketread-only |
Scans the FULL market universe (Forex, Crypto, Metals, Indices) and
returns the top trading opportunities ranked by sentiment score.
Use this when the user asks for a MULTI-ASSET survey or anything
that implies scanning / finding opportunities across the market.
Example user phrasings that should trigger scan_market:
- "scan the market"
- "scan market on daily for score of 85"
- "what's bullish on the H4?"
- "find me strong setups"
- "show top opportunities"
- "what looks bearish right now?"
- "any crypto setups?"
For deep analysis of a SINGLE specific asset the user names by
symbol, use analyze_asset instead. Do NOT call analyze_asset on
a single asset when the user asked for a scan — that produces
one deep dive instead of the ranked list they wanted.
Common arg parsing from user phrasings:
- "score of 85" / "min score 85" / "score >= 85" → min_score=85
- "on daily" / "on D" / "1d" → timeframes=["D"]
- "on 4-hour" / "H4" / "4h" → timeframes=["H4"]
- "top 10" / "top 5" → limit=10 / limit=5
- "bullish only" → sentiment="bullish"
- "crypto" / "stocks" → include_categories=["crypto"] / ["stocks"]
Args:
timeframes: List of timeframes to scan (e.g. ["H1", "H4", "D"]). Default is ["H8"].
min_score: Minimum absolute sentiment score (0-100) to include. Default 80 (Bullish/Bearish).
limit: Maximum number of results to return. Default 6.
include_categories: Optional list of category names to keep. Each name
matches the engine's `sector` (crypto/stocks/indices/commodities/fx)
OR `product_type` (perp/spot) OR special tokens "hip3"/"pre-launch".
Case-insensitive. Empty/None = include everything.
exclude_categories: Optional list of category names to exclude. Applied
AFTER include filter. Same vocabulary.
universe_scope: "top25" (default; rank by 24h volume then keep top 25)
or "all" (the 100 most-traded markets by 24h volume — a hard cap
that keeps scan time and the shared exchange rate budget bounded;
it is NOT the whole ~500-market universe). HL only — OANDA always
uses its static universe regardless.
min_volume_24h: Drop markets whose volume_24h is below this floor.
HL only; OANDA universe has no volume metadata to filter on.
Returns:
A list of the top opportunities ranked by sentiment strength.
|
searchread-only |
Search forex analysis results by asset name, timeframe, or keywords.
Returns a list of available analyses matching the search criteria.
Args:
query: Search query (e.g., "EUR_USD", "daily analysis", "gold", "bitcoin")
Returns:
Search results with IDs for fetching full analysis
|
trade_limit_orderdestructive |
Place a Limit Order.
price: The limit price to trigger the order.
take_profit: ABSOLUTE PRICE (e.g. 1.1250).
stop_loss: ABSOLUTE PRICE (e.g. 1.1100).
take_profit_distance: RELATIVE PIPS (e.g. 0.0050).
stop_loss_distance: RELATIVE PIPS (e.g. 0.0020).
trailing_stop_distance: RELATIVE DISTANCE for trailing stop.
guaranteed_stop_loss: True for GSLO.
expiry: ISO 8601 string (e.g. "2023-12-31T23:59:00Z"). Defaults to GTC if omitted.
client_nonce: Optional. 32-char hex idempotency token.
reduce_only: HL only. Order may only close existing position size.
tif: HL only. "Gtc" (default), "Alo" (post-only), or "Ioc".
payment_proof: Optional. HL mainnet only — pass {"confirmed": true}
to acknowledge orders whose notional exceeds
HYPERLIQUID_MAINNET_CONFIRM_USD ($500 default).
|
trade_market_orderdestructive |
Place a Market Order.
units: Positive for Buy, Negative for Sell
take_profit: ABSOLUTE PRICE (e.g. 1.1250).
stop_loss: ABSOLUTE PRICE (e.g. 1.1100).
take_profit_distance: RELATIVE PIPS (e.g. 0.0050). Use this OR absolute price.
stop_loss_distance: RELATIVE PIPS (e.g. 0.0020). Use this OR absolute price.
trailing_stop_distance: RELATIVE DISTANCE for trailing stop (e.g. 0.0020).
guaranteed_stop_loss: True to use GSLO (Premium, requires specific SL distance rule).
slippage: Hyperliquid-only — fraction (0–0.5) capping IOC price band. Ignored by OANDA/eToro.
client_nonce: Optional. 32-char hex idempotency token. Pass the same value
from a prior call's response.client_nonce to retry the exact same
order without risking a duplicate fill. Server mints one if absent.
payment_proof: Optional. HL mainnet only — pass {"confirmed": true}
to acknowledge orders whose notional exceeds
HYPERLIQUID_MAINNET_CONFIRM_USD ($500 default). UI shows a
confirmation modal first, then re-fires with this set.
|
trade_modify_tradedestructive |
Modify an existing trade's Stop Loss and Take Profit.
You can use absolute prices OR relative distances.
Only provided fields will be updated.
Args:
trade_id: The ID of the open trade to modify.
take_profit: New ABSOLUTE price.
stop_loss: New ABSOLUTE price.
take_profit_distance: New RELATIVE distance (e.g. 0.0050).
stop_loss_distance: New RELATIVE distance (e.g. 0.0020).
|
trade_stop_orderdestructive |
Place a Stop Order (Momentum/Breakout Entry).
Use this to Buy ABOVE market price or Sell BELOW market price.
Args:
instrument: Asset symbol (e.g. 'EUR_USD')
units: Positive for Buy, Negative for Sell
price: The STOP price to trigger the order.
expiry: ISO 8601 string (e.g. "2023-12-31T23:59:00Z"). Defaults to GTC if omitted.
take_profit: ABSOLUTE PRICE.
stop_loss: ABSOLUTE PRICE.
take_profit_distance: RELATIVE DISTANCE (e.g. 0.0050).
stop_loss_distance: RELATIVE DISTANCE (e.g. 0.0020).
trailing_stop_distance: RELATIVE DISTANCE for trailing stop.
guaranteed_stop_loss: True for GSLO.
client_nonce: Optional. 32-char hex idempotency token. Pass the same
value from a prior call's response.client_nonce to retry without
risking a duplicate order. Server mints one if absent.
|
x402_evm_configread-only |
Return the public EVM x402 config: recipient address, supported
networks (CAIP-2 keys → USDC contract + RPC URL + chain name),
and the token package.
Pairs with x402_solana_config so the WalletPaymentModal can render
a Solana | EVM tab switcher and let the user pay from whichever
wallet they have. No auth — every value is broadcast on-chain at
payment time anyway.
|
x402_solana_configread-only |
Return the public Solana x402 config: recipient pubkey, supported
networks (with USDC mints + RPC URLs), and the token package.
No authentication required — every value here is broadcast publicly
on-chain at payment time anyway. The frontend calls this on the
payment modal's mount so the build doesn't need its own VITE_SOLANA_*
env vars; one source of truth lives on the MCP container.
|
protogrid