com.basischarts/basis

Tools

• alert_link

  Prepare a price, indicator, chart-drawing, news or calendar alert and get a link that sets it in Basis in one click. Use it whenever the person wants to be told when something happens -- a level breaks, RSI crosses 70, price crosses a trend line, a high-impact ETF headline lands, or an event approaches. Pass exactly one of price, conditions, drawingId or eventTrigger. Give the URL as a link and say in one line what it watches. Nothing is armed until they open it and confirm. Market alerts can run in an open tab; background and event alerts require a signed-in Basis account. The link lasts seven days.

  shallow
• backtest_run

  Backtest one built-in strategy with one set of parameters. Fills happen at the next bar's open and costs are charged per side. Returns risk-adjusted metrics alongside the raw return — judge on those, not on total return.

  shallow
• calendar_history

  Reconstruct historical calendar conventions (options expiry, CME settlement, payroll schedule). NOT an archive of confirmed releases or actual economic values. Holiday exceptions may differ. No historical funding, halving, FOMC or CPI feed. Use calendar_upcoming for future events.

  shallow
• calendar_upcoming

  Scheduled events ahead: the next funding settlements for a contract, the Bitcoin halving projected from live block height, difficulty retargets, monthly options expiry, CME settlement and non-farm payrolls. Every row states where its date came from — live, a published rule, an estimate, or the user — because a halving projected from block arrival and an expiry fixed by convention are not equally certain. Use it before saying anything about what happens next; nothing else here looks forward. FOMC and CPI are absent on purpose: their dates are announced rather than derivable, so this does not have them.

  shallow
• catalog_describe

  Full detail for one catalogue entry: an indicator's parameters and defaults, a formula function's signature, or a strategy's parameters. Call this before passing parameters you have not seen.

  shallow
• catalog_search

  Search what Basis can do: indicators, formula functions, built-in strategies, the extra series available inside strategy expressions, and the drawing tools with the number of anchors each one takes. Exact counts are in the system prompt catalogue. Use this before assuming something does or does not exist — and always before drawing, because a drawing tool id you guessed is refused. Leave the query empty to list everything of a kind.

  shallow
• chart_add_indicator

  Put an indicator on the chart. studyId is an id or a common name ("ema20", "bollinger"); catalog_describe lists parameters. Omitted ones use the default. Changes the chart you are building; call chart_link when you are done so the person can open it.

  shallow
• chart_image

  See the chart you are building: returns a PNG of it -- candles, volume, every indicator and drawing -- rendered the way Basis draws it, plus the exact figures it shows. Use it to check structure, levels and what you drew before you describe them. Build first with the chart tools, or pass symbol, timeframe, indicators and levels to build and look in one call. Pixels are for shape; quote numbers from the figures or the data tools.

  shallow
• chart_link

  Publish the chart and get a URL the person can open in Basis. Call it at the end of any answer about a market: the chart is half the answer. Either build first with the chart tools, or pass symbol, timeframe, indicators and levels here to build and publish in one call. Give the URL as a link and say in one line what it shows. No account needed; the link lasts seven days.

  shallow
• chart_remove_indicator

  Delete an indicator instance from the chart. Use chart_state to find its instance id. To temporarily hide it instead, use chart_toggle_indicator. Changes the chart you are building; call chart_link when you are done so the person can open it.

  shallow
• chart_set_instrument

  Point the chart at a market. Venue and symbol as the exchange writes them, e.g. BTCUSDT on binance. This changes the chart you are building, which the person opens through chart_link.

  shallow
• chart_set_timeframe

  Change the chart timeframe, e.g. 15m, 1h, 4h, 1d. Changes the chart you are building; call chart_link when you are done so the person can open it.

  shallow
• chart_set_type

  Change how price is drawn — candles, heikin ashi, line, renko, footprint and others. A wrong id is refused, and the refusal lists every one that works. Changes the chart you are building; call chart_link when you are done so the person can open it.

  shallow
• chart_state

  The chart you are building for this person: venue, symbol, timeframe, chart type, every indicator with its instance id and parameters, and every drawing. Start here when you need an instance id, and call it again after changes to confirm what landed. Finish with chart_link to give the person something to open.

  shallow
• chart_toggle_indicator

  Hide or show an indicator without removing it — useful for comparing a chart with and without something. Changes the chart you are building; call chart_link when you are done so the person can open it.

  shallow
• chart_update_indicator

  Edit the parameters of an existing indicator instance. First call chart_state to get its instance id; use catalog_describe for supported parameters. To delete use chart_remove_indicator, to hide/show use chart_toggle_indicator. Changes the chart you are building; call chart_link when you are done so the person can open it.

  shallow
• crypto_quant_guide

  Domain knowledge for a crypto analysis: the constraints of the topic, the Basis tool chain, and — the part worth calling for — findings Basis has actually measured, each with its sample and verdict, plus the conventional readings it has NOT measured, marked as such. Call it before analysing a chart pattern, interpreting an indicator level, designing a strategy or judging a result that looks strong. It carries no live market data.

  shallow
• daytrade_opportunity_scan

  Run one symmetric long/short scan over the same top-volume universe and return rule-independent breadth, 24h liquidity semantics and ranked directional candidates. Use this first for comprehensive day-trade or scalp discovery; then deep-dive only the shortlist with derivatives/order-flow tools. A low match count is never reported as breadth.

  shallow
• drawing_add

  Draw on the chart. Points are {time, price} in chart coordinates — time in seconds, matching the candle timestamps a data handle reports. A horizontal line needs one point; a trendline or box needs two. Both numbers must be copied from a tool result — a summary's max with its maxAt, a crossing with its time — never read off your own prose or carried over from a different computation. The result echoes back what was drawn: check it against the figures you are about to quote, because a line that disagrees with the paragraph beside it is worse than no line. Changes the chart you are building; call chart_link when you are done so the person can open it.

  shallow
• drawing_delete

  Delete a drawing. This cannot be undone — the shape is not recoverable — so the user is asked first. Changes the chart you are building; call chart_link when you are done so the person can open it.

  shallow
• drawing_freehand

  Create one or more precise freehand strokes as a single undoable composition. A stroke accepts arbitrary chart points; line accepts two endpoints; ellipse and rectangle accept two opposite corners and are generated smoothly. Use highlighter for translucent emphasis and brush for circles, paths and marks. Changes the chart you are building; call chart_link when you are done so the person can open it.

  shallow
• drawing_style

  Change how an existing drawing looks. Get the id from chart_state. Use it to keep several drawings apart — a measured level and a projected one should not be the same colour, and a reader has only the picture to tell them by. Changes the chart you are building; call chart_link when you are done so the person can open it.

  shallow
• fibonacci_draw

  Draw a Fibonacci study directly on the chart with exact candle coordinates and optional custom ratios. Supports retracement, extension, channel, time, fan, circle, spiral, arc and wedge variants. Prefer swing timestamps/prices returned by market_candles computations rather than visual guesses. Changes the chart you are building; call chart_link when you are done so the person can open it.

  shallow
• formula_evaluate

  Evaluate a Basis formula expression over a loaded window. Functions are listed by catalog_search kind=formula; series named open, high, low, close, volume, returns and more. Multi-line with `let` bindings is supported; the last expression is the result.

  shallow
• hyperliquid_whale_read

  Read current public Hyperliquid positions for a frozen, research-screened whale cohort. Returns account-normalized consensus, participation, agreement, effective-wallet count, single-wallet concentration, liquidity and optional recent fills for the focus symbol. Use this for whale/smart-money positioning as one evidence family, never as a standalone signal.

  shallow
• indicator_compute

  Run any indicator in the catalogue. Returns EVERY output series it has — Donchian gives three bands, MACD gives line, signal and histogram — each reduced, plus the indicator's own conventional levels so the reading can be interpreted against its actual scale. Pass a symbol to load and compute in one call, or a handle to reuse data. The forming bar is excluded unless you ask for it.

  shallow
• market_candles

  Load price history and return a handle to it, plus a summary. The bars themselves are deliberately not returned — pass the handle to the compute tools instead. Defaults to whatever is on the chart.

  shallow
• market_derivatives

  Funding, open interest, positioning and taker flow for a loaded contract. Venues publish different subsets; anything a venue does not publish comes back as unavailable rather than zero.

  shallow
• market_dominance

  Current crypto market-cap structure from a server-cached aggregate source: real BTC and ETH dominance, total market cap/volume, tracked stablecoin share and leading asset shares with source and timestamps. Use this for BTC.D/rotation context. This is a current snapshot, not a historical dominance backtest series.

  shallow
• market_relationships

  Professional multi-asset relationship analysis on timestamp-aligned closed-bar log returns. Returns a correlation matrix plus rolling correlation, OLS beta/alpha, R-squared, upside/downside correlation, relative performance, one-bar lead/lag diagnostics and a rolling log-price spread z-score versus a benchmark. Use this for BTC correlation, beta, pairs and relative-strength work; price-level correlation is deliberately not reported.

  shallow
• news_detect_assets

  Which crypto assets a piece of text refers to. Word-bounded, so "button" does not match TON and "operation" does not match OP.

  shallow
• news_history

  Read archived crypto headlines, newest first, with source links. Use news_recent for live headlines. Paginate with nextBefore (ISO timestamp). Archive coverage starts when Basis began collecting; an empty page does not prove no news occurred. No full article text.

  shallow
• news_recent

  Recent crypto headlines with an impact score and the assets each one touches. Impact is a keyword heuristic, not a judgement about the market.

  shallow
• orderflow_read

  Aggressor-side order flow: buy and sell volume separated by who crossed the spread, delta, the footprint by price level, the point of control, and absorption or stacked imbalance. Measured from the venue aggressor tag, not inferred from bar direction — use it when the question is who is being aggressive, which candles cannot answer. For one candle pass candleTime, which reads exactly that bar; otherwise it reads the last `minutes`. Report coveredMinutes, not the minutes asked for.

  shallow
• position_calculate

  Risk-first position sizing with quantity, notional, margin, effective leverage, fees, funding, breakeven, liquidation estimate, target R multiples and warnings. Use position_plan_on_chart instead when the user should see the plan on the chart.

  shallow
• position_draw_on_chart

  The chart-only long/short position drawing tool. Draw an entry, stop and target box immediately when those price levels are known. It needs no account equity or risk percentage, performs no position sizing and places no order. Use position_plan_on_chart instead only when the user also wants quantity and risk calculations. Changes the chart you are building; call chart_link when you are done so the person can open it.

  shallow
• position_plan_on_chart

  Calculate a risk-first long/short position and draw the entry, stop and first target directly on the live chart. The drawing retains quantity, notional, margin, costs, liquidation estimate, targets, warnings and an optional sandbox program id so later analysis reads the same plan the user sees. Changes the chart you are building; call chart_link when you are done so the person can open it.

  shallow
• screener_backtest

  Historically replay a cross-sectional screen at every bar. Matching instruments form an equal-weight long or short portfolio, entered at the next bar open and held to the following bar open, then re-screened. Use this when the question is whether repeatedly trading screener matches worked — a single-symbol backtest of coins that match today is not a substitute. Costs follow actual portfolio turnover, so an unchanged holding is not charged as a fresh round trip.

  shallow
• screener_run

  Scan the venue's listed instruments for ones matching conditions, instead of looking at the open chart. Rules combine price fields, any indicator plot, or a formula expression, with ALL/ANY matching. This is the tool for "which coins are doing X right now". It fetches history for every instrument in the universe, so it is slow and worth asking for once with the right conditions rather than repeatedly with narrower ones.

  shallow
• strategy_research

  Run one chronological research experiment across many built-in strategies, instruments and timeframes. Use this for broad discovery instead of many backtest_run calls — and in particular instead of testing one strategy on coin after coin, which is a search whether or not it is called one. It ranks only on a selection window, checks several subperiods, leaves an embargo, reveals held-out performance, doubles costs as a stress test, compares buy-and-hold, and corrects the selected Sharpe for every strategy/symbol/timeframe combination tried.

  shallow
• trade_experience_retrieve

  Retrieve compact historical trade analogues for the current market state. Plans are deterministic synthetic templates, while fills, stop/target ordering, MAE/MFE and outcomes are settled on later historical candles with costs. Use it to compare similar wins and failures, never as proof of an edge.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/5c27a784-587a-4ce1-9850-84c28a52181c/badge.svg)](https://vouch.tools/servers/5c27a784-587a-4ce1-9850-84c28a52181c)