Tool reference

43 read-only tools.

Generated from tools/list on the live endpoint (server 2.1.23, MCP 2025-06-18) on 2026-11-19. Every tool is read-only and needs no auth.

Analysis tools.

Get derivatives positioning

get_derivatives_positioning
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about leverage, funding, open interest, crowding or squeeze risk for a crypto perpetual. Returns OKX and Hyperliquid funding (8h and annualized), open interest and its 24h change, global and top-trader long/short ratios, and a crowding, open-interest-regime and squeeze-risk read. Only covers tickers listed as USDT perpetuals on OKX or as perpetuals on Hyperliquid; it does not cover spot-only tokens, options or other venues.

ParameterTypeDescriptionConstraints
symbol requiredstringTicker symbol such as BTC, ETH or SOL (letters and digits only).min length 1, max length 15, pattern ^[A-Za-z0-9]+$

Returns structured content with: hyperliquid, okx, positioning, symbol.

Build trade plan

build_trade_plan
  • Read-only
  • Non-destructive
  • Idempotent
  • Computed locally

Use this when the user has a trade idea with an entry and a stop and needs a position size, or asks how much to buy, what leverage is safe, or whether a setup is worth taking. Returns the size that loses exactly riskPct of the account at the stop with fees included, notional and margin, the R-multiple and net P&L of each target, the breakeven win rate, expectancy and half-Kelly when winProbability is given, and whether leverage would liquidate the position before the stop. It is arithmetic on the numbers supplied: it does not fetch prices, judge the setup or place orders.

ParameterTypeDescriptionConstraints
accountSize requirednumberAccount equity in USD.> 0
entry requirednumber—> 0
feePctnumberTaker fee per side in percent (0.05 = 0.05%).default 0.05, ≥ 0, ≤ 1
leveragenumber—default 1, ≥ 1, ≤ 200
maintenanceMarginPctnumberVenue maintenance margin in percent.default 0.5, ≥ 0, ≤ 10
riskPctnumberPercent of the account lost if the stop is hit.default 1, > 0, ≤ 100
side required"long" | "short"——
stop requirednumber—> 0
targetsarray of objectsUp to 5 take-profit levels. Give allocationPct on all (summing to 100) or none (split evenly).max 5 items
targets[].allocationPctnumber—> 0, ≤ 100
targets[].price requirednumber—> 0
winProbabilitynumberEstimated chance of reaching the targets, between 0 and 1 (exclusive).> 0, < 1

Returns structured content with: blendedR, breakevenWinRatePct, expectancy, liquidation, marginUsd, notionalUsd, riskUsd, side, stopDistancePct, targets, units, warnings.

Backtest signal strategy

backtest_signal_strategy
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user proposes a rule-based strategy (RSI, moving-average, MACD or Bollinger conditions) and wants to know how it would have performed. Simulates the strategy on 1-3 coins over 30-365 days of daily prices with fees, slippage and gas, and returns total and annualized return, max drawdown, Sharpe, win rate, profit factor, recent trades, a sampled equity curve and buy-and-hold and BTC benchmarks. Daily candles only: it cannot test intraday rules, order-book effects or leverage, and past performance does not predict future results.

ParameterTypeDescriptionConstraints
coins requiredarray of stringCoinGecko coin IDs, lowercase and hyphenated: bitcoin, ethereum, solana, avalanche-2.min 1 item, max 3 items
costsobjectExecution costs as fractions (0.003 = 0.3%). Defaults: fee 0.003, slippage 0.001, gas 2 USD per trade.—
daysinteger—default 180, ≥ 30, ≤ 365
initialCapitalnumber—default 10000, ≥ 100, ≤ 100000000
rebalanceFrequency"daily" | "weekly" | "monthly"Cadence for dca and rebalance strategies.default "weekly"
strategy requiredobjectSignal spec. Entry fires when all entryConditions hold, exit when any exitCondition holds. Example RSI dip-buy: indicators [{id:"RSI_14",type:"RSI",params:[14]}], entry [{indicator:"RSI",operator:"<",params:[14],value:30}], exit [{indicator:"RSI",operator:">",params:[14],value:70}].—

Returns structured content with: benchmarks, equityCurve, metrics, period, recentTrades, strategy.

Scan token safety

scan_token
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks whether a token is safe, or mentions a small cap, new launch or unfamiliar contract. Works by symbol or contract on any EVM chain or Solana and checks honeypot, buy and sell tax, mint and owner powers, holder concentration, liquidity and pair age, returning a safe, caution or danger verdict with flags.

ParameterTypeDescriptionConstraints
token requiredstringToken symbol or contract address.max length 100
chainstringChain of the token, such as ethereum, base, bsc or solana. Inferred when omitted.max length 40

Returns structured content with: address, chain, flags, market, metrics, summary, symbol, verdict.

Compare swap quotes

compare_swap_quotes
  • Read-only
  • Non-destructive
  • Live external data
  • Interactive card in ChatGPT

Use this when the user wants to compare swap rates for a token pair across DEX aggregators. Fetches live quotes from LI.FI, KyberSwap and Jupiter for any token on any chain and ranks them by output, with USD value, price impact, gas and the gap to the top quote. Give exactly one of amountUsd or sellAmount. Read-only: returns quotes, not transactions or links.

ParameterTypeDescriptionConstraints
buyToken requiredstringToken to buy: symbol (SPA, ETH, BONK) or contract address.max length 100
chainstringChain of buyToken, such as arbitrum, base or solana. Inferred when omitted.max length 40
amountUsdnumberUSD value to spend (1-100000). Give this or sellAmount.≥ 1, ≤ 100000
sellAmountnumberAmount of sellToken in token units. Give this or amountUsd.> 0
sellTokenstringToken to pay with. Defaults to USDC on the sell chain.max length 100
sellChainstringChain sellToken is paid from when it differs from the buy chain.max length 40
slippagePctnumberMaximum slippage in percent (0.5 = 0.5%).default 0.5, ≥ 0.05, ≤ 5

Returns structured content with: best, buy, crossChain, quotes, sell, sources, spreadPct.

Review wallet

review_wallet
  • Read-only
  • Non-destructive
  • Live external data
  • Interactive card in ChatGPT

Use this when the user shares a wallet address or asks whether their wallet or portfolio is in good shape. Reviews an EVM or Solana wallet: holdings and concentration, risky token approvals with revoke links, safety scans of held tokens and crisis-scenario drawdowns, ranked into findings with a healthy, attention or at_risk verdict. Read-only; it never touches funds.

ParameterTypeDescriptionConstraints
address requiredstringWallet address: 0x EVM address or Solana base58 address.max length 64
includeStressbooleanInclude the crisis stress test of the holdings.default true

Returns structured content with: address, approvals, chainType, concentration, findings, holdings, safety, stress, totalValueUsd, verdict.

Stress test portfolio

stress_test_portfolio
  • Read-only
  • Non-destructive
  • Live external data
  • Interactive card in ChatGPT

Use this when the user asks how bad a portfolio could get, wants a crash or crisis test, or asks about portfolio risk. Replays the holdings through real crypto crises (2025 tariff shock, yen carry unwind, SVB and USDC depeg, FTX, LUNA, May 2021 deleveraging, COVID crash) and returns drawdown, dollar loss and top losers per scenario, plus optional VaR, CVaR and risk contribution.

ParameterTypeDescriptionConstraints
holdings requiredarray of objectsPositions by ticker and USD value, e.g. [{symbol:"BTC",valueUsd:5000}].min 1 item, max 500 items
holdings[].symbol requiredstring—min length 1, max length 32
holdings[].valueUsd requirednumber—≥ 0
includeRiskbooleanAdd VaR, CVaR, volatility and per-asset risk contribution.—
scenarioIdsarray of "tariff-shock-2025" | "yen-carry-unwind" | "svb-usdc-depeg" | "ftx-collapse" | "luna-collapse" | "may-2021-deleveraging" | "covid-crash"Limit to these scenarios. Omit for all.min 1 item, items: "tariff-shock-2025", "yen-carry-unwind", "svb-usdc-depeg", "ftx-collapse", "luna-collapse", "may-2021-deleveraging", "covid-crash"

Returns structured content with: analysed, risk, scenarios, totalValueUsd, worst.

Analyze coin

analyze_coin
  • Read-only
  • Non-destructive
  • Live external data
  • Interactive card in ChatGPT

Use this when the user asks what a coin's chart looks like, whether it is bullish or bearish, or where to enter, stop or take profit. Returns EMA 20/50/200 trend, RSI, MACD, ATR, swing support and resistance, volume and perp positioning folded into a verdict with reasons and a plan seed (entry, ATR stop, targets) to pass to build_trade_plan. Covers coins with OKX USDT or Hyperliquid markets; it is one technical input, not a signal or advice.

ParameterTypeDescriptionConstraints
symbol requiredstringTicker symbol, e.g. BTC, ETH, SOL.min length 1, max length 15, pattern ^[A-Za-z0-9]+$
interval"1d" | "4h"Candle interval.default "1d"

Returns structured content with: candles, levels, momentum, planSeed, positioning, price, reasons, score, stops, symbol, trend, verdict, volume.

Market feed tools.

Get Fear & Greed Index

get_fear_greed_index
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about the Crypto Fear & Greed Index or overall market mood. Returns the current 0-100 index with its label and daily history.

ParameterTypeDescriptionConstraints
daysintegerNumber of days of history to return, 1-30 (default 7).≥ 1, ≤ 30

Returns structured content with: data, title, truncated.

Get market regime

get_market_regime
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks whether the broad crypto market is risk-on or risk-off. Returns seven macro signals (liquidity, ETF flows, trend, hashrate, mining cost, sentiment) with a composite regime read, plus Fear & Greed and global market cap.

No parameters.

Returns structured content with: data, title, truncated.

Get macro dashboard

get_macro_dashboard
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks how macro conditions affect crypto. Returns the dollar index, Treasury yields, equity indices, gold and oil with their correlation to crypto.

No parameters.

Returns structured content with: data, title, truncated.

Get traditional market chart

get_traditional_market_chart
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about the price history of a stock index, ETF, commodity or volatility index such as SPY, ^VIX or gold. Returns three months of daily prices from Yahoo Finance.

ParameterTypeDescriptionConstraints
symbol requiredstringYahoo Finance symbol, e.g. SPY, QQQ, ^VIX, DX-Y.NYB or GC=F.max length 20, pattern ^[A-Za-z0-9^=.-]+$

Returns structured content with: data, title, truncated.

Get crypto stock quotes

get_crypto_stock_quotes
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about crypto-related stocks such as Coinbase, MicroStrategy, Robinhood or the IBIT ETF. Returns real-time quotes with daily change from Finnhub.

ParameterTypeDescriptionConstraints
symbolsstringComma-separated stock tickers (default COIN,MSTR,HOOD,IBIT).max length 100, pattern ^[A-Za-z0-9., -]+$

Returns structured content with: data, title, truncated.

Get market intelligence

get_market_intelligence
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks which narratives or sectors are moving in crypto. Returns a digest of narratives, sector rotation and notable moves.

No parameters.

Returns structured content with: data, title, truncated.

Get market sentiment

get_market_sentiment
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about sentiment toward Bitcoin, Ethereum or other major coins. Returns a sentiment read per coin aggregated from news and social sources.

No parameters.

Returns structured content with: data, title, truncated.

Get global market stats

get_global_market_stats
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about total crypto market cap, trading volume or Bitcoin and Ethereum dominance. Returns global market totals with 24h change.

No parameters.

Returns structured content with: data, title, truncated.

Get top coins

get_top_coins
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks for the largest coins, a market overview or the top movers by market cap or volume. Returns ranked coins with price, market cap, volume and 1h, 24h and 7d change.

ParameterTypeDescriptionConstraints
limitintegerNumber of coins to return, 1-250 (default 50).≥ 1, ≤ 250
sort"market_cap_desc" | "volume_desc"Ranking order: market_cap_desc (default) or volume_desc.—

Returns structured content with: data, title, truncated.

Get whale alerts

get_whale_alerts
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about whale activity or large crypto transfers. Returns recent large on-chain transfers and exchange deposits and withdrawals.

No parameters.

Returns structured content with: data, title, truncated.

Get exchange flows

get_exchange_flows
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks whether Bitcoin or Ether is flowing into or out of exchanges. Returns exchange net flows for BTC and ETH.

No parameters.

Returns structured content with: data, title, truncated.

Get tracked wallet activity

get_tracked_wallet_activity
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user wants to follow the recent activity of several wallet addresses at once. Returns recent transactions and holdings for up to 10 wallets on one chain. For a full review of a single wallet use review_wallet.

ParameterTypeDescriptionConstraints
chainstringChain of the wallets, e.g. ethereum, base or arbitrum (default ethereum).max length 32, pattern ^[A-Za-z0-9-]+$
wallets requiredstringComma-separated wallet addresses, up to 10.max length 500, pattern ^[A-Za-z0-9, ]+$

Returns structured content with: data, title, truncated.

Get gas prices

get_gas_prices
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about gas fees or transaction costs on Ethereum or its layer 2 networks. Returns current gas prices per network.

No parameters.

Returns structured content with: data, title, truncated.

Get Bitcoin network stats

get_bitcoin_network_stats
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about the Bitcoin network: mempool fees, the latest block, hashrate or the next difficulty adjustment. Returns those network stats with the BTC price.

No parameters.

Returns structured content with: data, title, truncated.

Get new DEX listings

get_new_dex_listings
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about newly launched tokens or new DEX pairs. Returns recent DEX listings with liquidity and price momentum. New listings are high risk; check any of them with scan_token.

ParameterTypeDescriptionConstraints
chainstringChain slug, e.g. solana, base, ethereum or bsc. Omit for all chains.max length 32, pattern ^[A-Za-z0-9-]+$
limitintegerNumber of listings to return, 1-100 (default 25).≥ 1, ≤ 100

Returns structured content with: data, title, truncated.

Get funding rates

get_funding_rates
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks how funding rates compare across major coins and exchanges. Returns perpetual funding rates per coin and exchange. For one coin in depth use get_derivatives_positioning.

No parameters.

Returns structured content with: data, title, truncated.

Get open interest

get_open_interest
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about open interest across the crypto futures market. Returns open interest by coin and exchange with 24h change.

No parameters.

Returns structured content with: data, title, truncated.

Get liquidations

get_liquidations
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about recent liquidations or a liquidation cascade. Returns recent long and short liquidations by coin and exchange.

No parameters.

Returns structured content with: data, title, truncated.

Get long/short ratios

get_long_short_ratios
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks whether traders are mostly long or short across the market. Returns long/short account ratios per coin and exchange.

No parameters.

Returns structured content with: data, title, truncated.

Get options overview

get_options_overview
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about Bitcoin or Ether options. Returns options open interest, put/call ratio, max pain and implied volatility.

No parameters.

Returns structured content with: data, title, truncated.

Get ETF flows

get_etf_flows
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about spot Bitcoin or Ether ETF flows. Returns daily net flows and holdings by ETF issuer.

No parameters.

Returns structured content with: data, title, truncated.

Get DEX volumes

get_dex_volumes
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about decentralized exchange trading volume. Returns DEX volume by protocol and chain with 24h and 7d change.

No parameters.

Returns structured content with: data, title, truncated.

Get DeFi overview

get_defi_overview
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about the overall size of DeFi. Returns total value locked across DeFi with dominance and 24h change.

No parameters.

Returns structured content with: data, title, truncated.

Get TVL by chain

get_chain_tvl
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks which blockchains hold the most value or where capital is moving between chains. Returns total value locked per chain with change.

No parameters.

Returns structured content with: data, title, truncated.

Get top DeFi protocols

get_top_defi_protocols
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks for the largest DeFi protocols. Returns protocols ranked by total value locked with category, chains and change.

ParameterTypeDescriptionConstraints
limitintegerNumber of protocols to return, 1-100 (default 25).≥ 1, ≤ 100

Returns structured content with: data, title, truncated.

Get protocol revenue

get_protocol_revenue
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks which DeFi protocols earn the most fees or revenue. Returns protocol fee and revenue rankings.

No parameters.

Returns structured content with: data, title, truncated.

Get DeFi yields

get_defi_yields
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about DeFi yields or APY on lending, liquidity or vault pools. Returns pools ranked by APY with TVL, chain and project, above a TVL floor. Yields are variable and carry smart-contract risk.

ParameterTypeDescriptionConstraints
limitintegerNumber of pools to return, 1-100 (default 25).≥ 1, ≤ 100

Returns structured content with: data, title, truncated.

Get stablecoin stats

get_stablecoin_stats
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about stablecoin supply, market share or peg stability. Returns stablecoin supply, dominance, chain distribution and peg health.

No parameters.

Returns structured content with: data, title, truncated.

Get bridge flows

get_bridge_flows
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about cross-chain bridge activity or which chains are gaining capital. Returns bridge volumes and net flows per chain.

No parameters.

Returns structured content with: data, title, truncated.

Get token unlocks

get_token_unlocks
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about upcoming token unlocks or vesting releases. Returns unlocks scheduled in the next 30 days, ranked by value.

No parameters.

Returns structured content with: data, title, truncated.

Get governance proposals

get_governance_proposals
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about DAO votes or governance proposals. Returns active governance proposals across major protocols.

ParameterTypeDescriptionConstraints
limitintegerNumber of proposals to return, 1-50 (default 20).≥ 1, ≤ 50

Returns structured content with: data, title, truncated.

Get on-chain AI agents

get_onchain_ai_agents
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about on-chain AI agents registered under ERC-8004, the Ethereum standard for agent identity and reputation. Returns registered agents with their identity and reputation data.

ParameterTypeDescriptionConstraints
chainstringChain name, e.g. base or ethereum. Omit for all supported chains.max length 32, pattern ^[A-Za-z0-9-]+$
limitintegerNumber of agents to return, 1-50 (default 20).≥ 1, ≤ 50

Returns structured content with: data, title, truncated.

Get crypto news

get_crypto_news
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks for crypto news or headlines, optionally about one coin or category. Returns recent articles with source, time and summary.

ParameterTypeDescriptionConstraints
category"all" | "defi" | "general" | "market" | "nft" | "regulation"News category (default all).—
limitintegerNumber of articles to return, 1-50 (default 20).≥ 1, ≤ 50
symbolstringTicker to filter headlines by, e.g. BTC or SPA.max length 15, pattern ^[A-Za-z0-9]+$

Returns structured content with: data, title, truncated.

Get Sperax protocol stats

get_sperax_protocol_stats
  • Read-only
  • Non-destructive
  • Live external data

Use this when the user asks about the Sperax protocol, USDs, SPA, veSPA, xSPA or Demeter farms. Returns USDs supply, peg and auto-yield APY, SPA price, staking, farms and buybacks, and optionally one wallet’s USDs earnings.

ParameterTypeDescriptionConstraints
walletstringOptional Arbitrum address (0x…) to include its USDs auto-yield earnings.pattern ^0x[a-fA-F0-9]{40}$

Returns structured content with: data, title, truncated.