Analysis tools.
get_derivatives_positioning
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.
| Parameter | Type | Description | Constraints |
symbol required | string | Ticker 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.
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.
| Parameter | Type | Description | Constraints |
accountSize required | number | Account equity in USD. | > 0 |
entry required | number | — | > 0 |
feePct | number | Taker fee per side in percent (0.05 = 0.05%). | default 0.05, ≥ 0, ≤ 1 |
leverage | number | — | default 1, ≥ 1, ≤ 200 |
maintenanceMarginPct | number | Venue maintenance margin in percent. | default 0.5, ≥ 0, ≤ 10 |
riskPct | number | Percent of the account lost if the stop is hit. | default 1, > 0, ≤ 100 |
side required | "long" | "short" | — | — |
stop required | number | — | > 0 |
targets | array of objects | Up to 5 take-profit levels. Give allocationPct on all (summing to 100) or none (split evenly). | max 5 items |
targets[].allocationPct | number | — | > 0, ≤ 100 |
targets[].price required | number | — | > 0 |
winProbability | number | Estimated 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.
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.
| Parameter | Type | Description | Constraints |
coins required | array of string | CoinGecko coin IDs, lowercase and hyphenated: bitcoin, ethereum, solana, avalanche-2. | min 1 item, max 3 items |
costs | object | Execution costs as fractions (0.003 = 0.3%). Defaults: fee 0.003, slippage 0.001, gas 2 USD per trade. | — |
days | integer | — | default 180, ≥ 30, ≤ 365 |
initialCapital | number | — | default 10000, ≥ 100, ≤ 100000000 |
rebalanceFrequency | "daily" | "weekly" | "monthly" | Cadence for dca and rebalance strategies. | default "weekly" |
strategy required | object | Signal 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.
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.
| Parameter | Type | Description | Constraints |
token required | string | Token symbol or contract address. | max length 100 |
chain | string | Chain 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.
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.
| Parameter | Type | Description | Constraints |
buyToken required | string | Token to buy: symbol (SPA, ETH, BONK) or contract address. | max length 100 |
chain | string | Chain of buyToken, such as arbitrum, base or solana. Inferred when omitted. | max length 40 |
amountUsd | number | USD value to spend (1-100000). Give this or sellAmount. | ≥ 1, ≤ 100000 |
sellAmount | number | Amount of sellToken in token units. Give this or amountUsd. | > 0 |
sellToken | string | Token to pay with. Defaults to USDC on the sell chain. | max length 100 |
sellChain | string | Chain sellToken is paid from when it differs from the buy chain. | max length 40 |
slippagePct | number | Maximum slippage in percent (0.5 = 0.5%). | default 0.5, ≥ 0.05, ≤ 5 |
Returns structured content with: best, buy, crossChain, quotes, sell, sources, spreadPct.
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.
| Parameter | Type | Description | Constraints |
address required | string | Wallet address: 0x EVM address or Solana base58 address. | max length 64 |
includeStress | boolean | Include the crisis stress test of the holdings. | default true |
Returns structured content with: address, approvals, chainType, concentration, findings, holdings, safety, stress, totalValueUsd, verdict.
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.
| Parameter | Type | Description | Constraints |
holdings required | array of objects | Positions by ticker and USD value, e.g. [{symbol:"BTC",valueUsd:5000}]. | min 1 item, max 500 items |
holdings[].symbol required | string | — | min length 1, max length 32 |
holdings[].valueUsd required | number | — | ≥ 0 |
includeRisk | boolean | Add VaR, CVaR, volatility and per-asset risk contribution. | — |
scenarioIds | array 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.
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.
| Parameter | Type | Description | Constraints |
symbol required | string | Ticker 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.
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.
| Parameter | Type | Description | Constraints |
days | integer | Number of days of history to return, 1-30 (default 7). | ≥ 1, ≤ 30 |
Returns structured content with: data, title, truncated.
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.
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
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.
| Parameter | Type | Description | Constraints |
symbol required | string | Yahoo 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.
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.
| Parameter | Type | Description | Constraints |
symbols | string | Comma-separated stock tickers (default COIN,MSTR,HOOD,IBIT). | max length 100, pattern ^[A-Za-z0-9., -]+$ |
Returns structured content with: data, title, truncated.
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.
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.
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.
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.
| Parameter | Type | Description | Constraints |
limit | integer | Number 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.
Use this when the user asks what coins are trending or getting attention right now. Returns trending coins on CoinGecko and trending DEX pairs.
No parameters.
Returns structured content with: data, title, truncated.
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.
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
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.
| Parameter | Type | Description | Constraints |
chain | string | Chain of the wallets, e.g. ethereum, base or arbitrum (default ethereum). | max length 32, pattern ^[A-Za-z0-9-]+$ |
wallets required | string | Comma-separated wallet addresses, up to 10. | max length 500, pattern ^[A-Za-z0-9, ]+$ |
Returns structured content with: data, title, truncated.
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
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.
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.
| Parameter | Type | Description | Constraints |
chain | string | Chain slug, e.g. solana, base, ethereum or bsc. Omit for all chains. | max length 32, pattern ^[A-Za-z0-9-]+$ |
limit | integer | Number of listings to return, 1-100 (default 25). | ≥ 1, ≤ 100 |
Returns structured content with: data, title, truncated.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Use this when the user asks for the largest DeFi protocols. Returns protocols ranked by total value locked with category, chains and change.
| Parameter | Type | Description | Constraints |
limit | integer | Number of protocols to return, 1-100 (default 25). | ≥ 1, ≤ 100 |
Returns structured content with: data, title, truncated.
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.
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.
| Parameter | Type | Description | Constraints |
limit | integer | Number of pools to return, 1-100 (default 25). | ≥ 1, ≤ 100 |
Returns structured content with: data, title, truncated.
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.
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.
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.
Use this when the user asks about DAO votes or governance proposals. Returns active governance proposals across major protocols.
| Parameter | Type | Description | Constraints |
limit | integer | Number of proposals to return, 1-50 (default 20). | ≥ 1, ≤ 50 |
Returns structured content with: data, title, truncated.
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.
| Parameter | Type | Description | Constraints |
chain | string | Chain name, e.g. base or ethereum. Omit for all supported chains. | max length 32, pattern ^[A-Za-z0-9-]+$ |
limit | integer | Number of agents to return, 1-50 (default 20). | ≥ 1, ≤ 50 |
Returns structured content with: data, title, truncated.
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.
| Parameter | Type | Description | Constraints |
category | "all" | "defi" | "general" | "market" | "nft" | "regulation" | News category (default all). | — |
limit | integer | Number of articles to return, 1-50 (default 20). | ≥ 1, ≤ 50 |
symbol | string | Ticker 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
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.
| Parameter | Type | Description | Constraints |
wallet | string | Optional Arbitrum address (0x…) to include its USDs auto-yield earnings. | pattern ^0x[a-fA-F0-9]{40}$ |
Returns structured content with: data, title, truncated.