basis
Registry code: 13a1cc2715ef41ff
Basis is a crypto market terminal. Through these tools you can read
live and historical market data from Binance, Bybit, OKX and Hyperliquid, compute any of two
- endpoint
- https://www.basischarts.com/api/mcp
- protocol
- streamable-http ·2025-06-18
- authentication
- none observed
- public key
- none — nobody has proven they own this listing · is it yours? claim it
- karma
- 0 · newcomer
- Is basis live?
- Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.
- Is basis free to use?
- Yes — the hub reached it with no key and no payment.
- What tools does basis have?
- 44 tools: market_relationships, screener_backtest, drawing_add, formula_evaluate, backtest_run, position_calculate, drawing_freehand, drawing_delete, ….
- Is basis safe to connect?
- The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
90 days 99%· all time 99%
last good check
of 44 tools
- degraded → live
- live → degraded· timeout after 20000ms
- down → live
- degraded → live
- live → degraded· timeout after 20000ms
- used for
- read live crypto market data
- compute technical indicators
- backtest a trading strategy
- build a shareable price chart
- screen crypto markets
- takes → gives
- text → data, web pages
- tools
- 14 reads11 changes data
Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.
through this hub
successful
what callers paid
Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.
founders_preview open 22h ago
What Basis Founders adds to this connection, and the live totals a non-member may see: how many screened Hyperliquid whales are tracked, their combined book and the coin most of them hold. Founders is an optional paid membership; this tool is free and always answers. Use it when a question needs whale positions, whale or gamma levels, more than 30 days of derivatives history, or a stock or commodity on Hyperliquid or Binance.
{ "type": "object", "properties": {} }arguments 4 linesnews_recent reads open 28h ago
Recent crypto headlines with an impact score and the assets each one touches. Impact is a keyword heuristic, not a judgement about the market. Pass hours for "today" or "the last 24 hours"; every headline says how old it is.
{ "type": "object", "properties": { "asset": { "type": "string", "description": "Base symbol, e.g. BTC. Omit for everything." }, "hours": { "type": "number", "description": "Only headlines published in the last N hours, 1 to 168." }, "limit": { "type": "number", "description": "Default 15, max 40." }, "minImpact": { "enum": [ "low", "normal", "high", "critical" ], "type": "string" } } }arguments 26 linescalendar_upcoming reads open 36h ago
Scheduled events ahead: FOMC rate decisions, US CPI and non-farm payrolls from the Fed's and BLS's published calendars, the next funding settlements for a contract, the Bitcoin halving projected from live block height, difficulty retargets, monthly options expiry and CME settlement. Every row states where its date came from — live, an official schedule, 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.
{ "type": "object", "properties": { "days": { "type": "number", "description": "Horizon ahead. Default 30, max 365." }, "limit": { "type": "number", "description": "Default 20, max 50." }, "impact": { "enum": [ "high", "medium", "low" ], "type": "string", "description": "Only events at or above this impact." }, "symbol": { "type": "string", "description": "Contract for funding settlements. Defaults to the charted symbol." } } }arguments 26 linesmarket_candles open 2d ago
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. lastClosedCandle is one exact OHLC bar; high/low are WHOLE-WINDOW wick extremes with highAt/lowAt timestamps; from/to are window boundaries, not swing anchors. bars includes a possible forming bar: request N+1 for N closed bars and check closedBars. Defaults to whatever is on the chart.
{ "type": "object", "properties": { "bars": { "type": "number", "description": "Default 1000, max 50000." }, "market": { "enum": [ "spot", "futures" ], "type": "string", "description": "Default: the chart." }, "symbol": { "type": "string", "description": "Default: the chart." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "timeframe": { "type": "string", "description": "e.g. 15m, 1h, 4h, 1d." }, "withDerivatives": { "type": "boolean", "description": "Also load funding, open interest and positioning for this contract." } } }arguments 38 linescrypto_quant_guide reads open 2d ago
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.
{ "type": "object", "required": [ "topic" ], "properties": { "topic": { "enum": [ "workflow", "market-structure", "chart-patterns", "indicator-meaning", "volatility-regime", "volume-orderflow", "derivatives", "whale-positioning", "strategy-research", "cross-market", "risk-execution" ], "type": "string" } } }arguments 24 linescatalog_search open 1h ago
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. This is a catalogue of chart objects, not callable agent functions: use tools_load for function groups. Exact counts are in the system prompt catalogue. Use this before assuming something does or does not exist — and always before drawing a new type, because a drawing tool id you guessed is refused. Reuse a type already verified in this conversation. An empty query lists a kind; no kind searches them all.
{ "type": "object", "properties": { "kind": { "type": "string", "description": "One of indicator, formula, strategy, variable, drawing, workflow, chartType." }, "limit": { "type": "number", "description": "Default 25, max 100." }, "query": { "type": "string", "description": "Free text; matches name, description and category." } } }arguments 17 lineshyperliquid_whale_read reads open 4h ago
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.
{ "type": "object", "properties": { "symbol": { "type": "string", "description": "Focus symbol; defaults to the charted symbol." }, "flowHours": { "type": "number", "description": "Recent-flow window. Default 24h, range 1-168h." }, "topSymbols": { "type": "number", "description": "Market-consensus rows to return. Default 10, max 15." }, "maxFlowWallets": { "type": "number", "description": "Wallets sampled for fills. Default/max 4." }, "includeRecentFlow": { "type": "boolean", "description": "Also inspect recent focus-symbol fills for at most four leading contributors." }, "minimumDayVolumeUsd": { "type": "number", "description": "24h Hyperliquid notional-volume floor. Default $5,000,000." } } }arguments 29 linesmarket_derivatives reads open 39h ago
Read current perpetual funding (fonlama/takas ücreti), open interest and positioning directly by symbol, without loading candles first. Optional ref reuses a fresh derivatives handle. Funding is a transfer between longs/shorts, NOT a maker/taker trading commission. Returns decimal and percentage rates, actual settlement interval and optional payment scenario.
{ "type": "object", "properties": { "ref": { "type": "string", "description": "Optional existing data handle." }, "side": { "enum": [ "long", "short" ], "type": "string", "description": "For payment estimate; default long." }, "market": { "enum": [ "spot", "futures" ], "type": "string", "description": "Default: the chart." }, "symbol": { "type": "string", "description": "Default chart symbol; perpetual funding is read on futures even when the chart is spot." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "timeframe": { "type": "string", "description": "Aggregation for OI/positioning; not the funding settlement interval." }, "notionalQuote": { "type": "number", "description": "Optional hypothetical position value in quote units to estimate one funding payment." } } }arguments 46 linesnews_history open 33h ago
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.
{ "type": "object", "properties": { "asset": { "type": "string", "description": "Base asset, e.g. BTC; supported asset tags only." }, "limit": { "type": "integer", "default": 20, "maximum": 40, "minimum": 1 }, "topic": { "enum": [ "markets", "regulation", "macro", "security", "etf", "stablecoins", "exchanges", "defi", "institutions", "mining" ], "type": "string" }, "before": { "type": "string", "description": "A date or timestamp, e.g. 2026-09-01 or 2026-09-01T00:00:00Z. UTC unless it says otherwise." } } }arguments 34 linestrade_experience_retrieve open 2d ago
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.
{ "type": "object", "properties": { "ref": { "type": "string", "description": "Optional market_candles handle for the query state." }, "bars": { "type": "number", "description": "History per symbol. Default 1500; min 300, max 3000." }, "side": { "enum": [ "long", "short" ], "type": "string" }, "limit": { "type": "number", "description": "Displayed analogues. Default 12; max 20." }, "setup": { "enum": [ "trend", "mean_reversion", "breakout" ], "type": "string" }, "feeBps": { "type": "number", "description": "Fee per side. Default 4 basis points." }, "market": { "enum": [ "spot", "futures" ], "type": "string" }, "stride": { "type": "number", "description": "Evaluate one signal point every N bars. Default 4." }, "symbol": { "type": "string", "description": "Query symbol; defaults to the chart." }, "symbols": { "type": "array", "items": { "type": "string" }, "maxItems": 8, "description": "Optional same-venue peer corpus. Query symbol is always included." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "timeframe": { "type": "string", "description": "Query timeframe; defaults to the chart." }, "slippageBps": { "type": "number", "description": "Adverse slippage per side. Default 1 basis point." } } }arguments 76 linesmarket_dominance reads open 44h ago
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.
{ "type": "object", "properties": {} }arguments 4 linesdaytrade_opportunity_scan reads open 47h ago
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. For a general scalp request use style:"scalp" and omit longRules/shortRules to use transparent RSI/EMA defaults. For explicit user filters use screener_run instead. Near misses never satisfy all rules.
{ "type": "object", "properties": { "name": { "type": "string" }, "quote": { "enum": [ "USDT", "USDC", "FDUSD", "BTC", "ETH", "ALL" ], "type": "string" }, "style": { "enum": [ "scalp", "daytrade" ], "type": "string", "description": "scalp defaults to 5m; daytrade to 15m. Explicit timeframe overrides this." }, "market": { "enum": [ "spot", "futures" ], "type": "string", "description": "Defaults to the chart. Perpetuals are futures." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string", "description": "Defaults to the chart." }, "lookback": { "enum": [ 300, 500, 1000, 1500 ], "type": "number", "description": "Default 300." }, "longRules": { "type": "array", "items": { "type": "object", "required": [ "left", "operator", "right" ], "properties": { "left": { "type": "object", "properties": { "kind": { "enum": [ "field", "indicator", "formula", "strategy" ], "type": "string" }, "name": { "type": "string" }, "field": { "enum": [ "open", "high", "low", "close", "volume", "quoteVolume", "trades", "change1", "change5", "rangePercent" ], "type": "string" }, "params": { "type": "object", "additionalProperties": { "type": [ "number", "string", "boolean" ] } }, "plotKey": { "type": "string", "description": "Optional; defaults to the first indicator output." }, "studyId": { "type": "string", "description": "Indicator id, e.g. rsi or ema." }, "expression": { "type": "string" }, "parameters": { "type": "object", "additionalProperties": { "type": "number" } }, "strategyId": { "type": "string" } }, "description": "e.g. {\"kind\":\"field\",\"field\":\"change5\"}, {\"kind\":\"indicator\",\"studyId\":\"rsi\",\"plotKey\":\"rsi\"}, or {\"kind\":\"formula\",\"name\":\"atrPct\",\"expression\":\"atr(14)/close*100\"}" }, "right": { "anyOf": [ { "type": "number" }, { "type": "object", "properties": { "kind": { "enum": [ "constant", "operand" ], "type": "string" }, "value": { "type": "number" }, "operand": { "type": "object", "properties": { "kind": { "enum": [ "field", "indicator", "formula", "strategy" ], "type": "string" }, "field": { "type": "string" }, "params": { "type": "object" }, "plotKey": { "type": "string" }, "studyId": { "type": "string" }, "expression": { "type": "string" }, "strategyId": { "type": "string" } } } } } ], "description": "Use a number for a threshold: RSI >50 is {left:{kind:\"indicator\",studyId:\"rsi\"},operator:\"above\",right:50}. To compare with an indicator use {kind:\"operand\",operand:{kind:\"indicator\",studyId:\"ema\",params:{period:20}}}." }, "operator": { "enum": [ "above", "atOrAbove", "below", "atOrBelow", "equal", "notEqual", "crossesAbove", "crossesBelow", "rising", "falling" ], "type": "string" } } } }, "timeframe": { "type": "string", "description": "Default 5m for scalp, otherwise 15m; does not inherit the open chart." }, "shortRules": { "type": "array", "items": { "type": "object", "required": [ "left", "operator", "right" ], "properties": { "left": { "type": "object", "properties": { "kind": { "enum": [ "field", "indicator", "formula", "strategy" ], "type": "string" }, "name": { "type": "string" }, "field": { "enum": [ "open", "high", "low", "close", "volume", "quoteVolume", "trades", "change1", "change5", "rangePercent" ], "type": "string" }, "params": { "type": "object", "additionalProperties": { "type": [ "number", "string", "boolean" ] } }, "plotKey": { "type": "string", "description": "Optional; defaults to the first indicator output." }, "studyId": { "type": "string", "description": "Indicator id, e.g. rsi or ema." }, "expression": { "type": "string" }, "parameters": { "type": "object", "additionalProperties": { "type": "number" } }, "strategyId": { "type": "string" } }, "description": "e.g. {\"kind\":\"field\",\"field\":\"change5\"}, {\"kind\":\"indicator\",\"studyId\":\"rsi\",\"plotKey\":\"rsi\"}, or {\"kind\":\"formula\",\"name\":\"atrPct\",\"expression\":\"atr(14)/close*100\"}" }, "right": { "anyOf": [ { "type": "number" }, { "type": "object", "properties": { "kind": { "enum": [ "constant", "operand" ], "type": "string" }, "value": { "type": "number" }, "operand": { "type": "object", "properties": { "kind": { "enum": [ "field", "indicator", "formula", "strategy" ], "type": "string" }, "field": { "type": "string" }, "params": { "type": "object" }, "plotKey": { "type": "string" }, "studyId": { "type": "string" }, "expression": { "type": "string" }, "strategyId": { "type": "string" } } } } } ], "description": "Use a number for a threshold: RSI >50 is {left:{kind:\"indicator\",studyId:\"rsi\"},operator:\"above\",right:50}. To compare with an indicator use {kind:\"operand\",operand:{kind:\"indicator\",studyId:\"ema\",params:{period:20}}}." }, "operator": { "enum": [ "above", "atOrAbove", "below", "atOrBelow", "equal", "notEqual", "crossesAbove", "crossesBelow", "rising", "falling" ], "type": "string" } } } }, "limitPerSide": { "type": "number", "description": "Candidates returned per direction. Default 10, max 25." }, "universeSize": { "enum": [ 20, 50, 100, 200 ], "type": "number", "description": "Default 100." }, "manualSymbols": { "type": "array", "items": { "type": "string" }, "description": "Optional symbols forced into the universe before current-volume ranking." } } }arguments 372 lineschart_state open 25h ago
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.
{ "type": "object", "properties": {} }arguments 4 linesstrategy_research open 11h ago
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.
{ "type": "object", "properties": { "bars": { "type": "number", "description": "Per symbol and timeframe. Default 3000, max 10000." }, "folds": { "type": "number", "description": "Selection subperiods, 2..8. Default 4." }, "feeBps": { "type": "number", "description": "Per side. Default 4." }, "market": { "enum": [ "spot", "futures" ], "type": "string", "description": "Default: the chart." }, "symbol": { "type": "string", "description": "Defaults to the charted symbol." }, "symbols": { "type": "array", "items": { "type": "string" }, "description": "Up to 8 instruments to search across, e.g. BTCUSDT, ETHUSDT. Every symbol is another trial and the deflated Sharpe accounts for it." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "direction": { "enum": [ "both", "long", "short" ], "type": "string" }, "timeframes": { "type": "array", "items": { "type": "string" }, "description": "Up to 6, e.g. 15m, 1h, 4h, 1d. Defaults to the chart timeframe." }, "embargoBars": { "type": "number", "description": "Gap before held-out data. Default 10." }, "slippageBps": { "type": "number", "description": "Per fill. Default 1." }, "strategyIds": { "type": "array", "items": { "type": "string" }, "description": "Built-in ids from catalog_search. Omit for the full library." }, "minimumTrades": { "type": "number", "description": "Reliability penalty threshold. Default 30." }, "inSampleFraction": { "type": "number", "description": "Selection share, 0.5..0.8. Default 0.7." } } }arguments 83 linesmarket_relationships unknown 31h ago
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.
{ "type": "object", "required": [ "symbols" ], "properties": { "bars": { "type": "number", "description": "Default 1500, max 10000 per market." }, "market": { "enum": [ "spot", "futures" ], "type": "string" }, "symbols": { "type": "array", "items": { "type": "string" }, "description": "2 to 10 markets, e.g. ETHUSDT, SOLUSDT. Benchmark is added if omitted." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "benchmark": { "type": "string", "description": "Default BTCUSDT." }, "timeframe": { "type": "string", "description": "Default chart timeframe." }, "rollingWindow": { "type": "number", "description": "Latest return observations. Default 90." } } }arguments 47 linesscreener_backtest unknown 14h ago
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.
{ "type": "object", "required": [ "rules" ], "properties": { "name": { "type": "string" }, "logic": { "enum": [ "all", "any" ], "type": "string", "description": "Default all." }, "quote": { "enum": [ "USDT", "USDC", "FDUSD", "BTC", "ETH", "ALL" ], "type": "string", "description": "Default USDC on Hyperliquid, USDT elsewhere." }, "rules": { "type": "array", "items": { "type": "object", "required": [ "left", "operator", "right" ], "properties": { "left": { "type": "object", "properties": { "kind": { "enum": [ "field", "indicator", "formula", "strategy" ], "type": "string" }, "name": { "type": "string" }, "field": { "enum": [ "open", "high", "low", "close", "volume", "quoteVolume", "trades", "change1", "change5", "rangePercent" ], "type": "string" }, "params": { "type": "object", "additionalProperties": { "type": [ "number", "string", "boolean" ] } }, "plotKey": { "type": "string", "description": "Optional; defaults to the first indicator output." }, "studyId": { "type": "string", "description": "Indicator id, e.g. rsi or ema." }, "expression": { "type": "string" }, "parameters": { "type": "object", "additionalProperties": { "type": "number" } }, "strategyId": { "type": "string" } }, "description": "e.g. {\"kind\":\"field\",\"field\":\"change5\"}, {\"kind\":\"indicator\",\"studyId\":\"rsi\",\"plotKey\":\"rsi\"}, or {\"kind\":\"formula\",\"name\":\"atrPct\",\"expression\":\"atr(14)/close*100\"}" }, "right": { "anyOf": [ { "type": "number" }, { "type": "object", "properties": { "kind": { "enum": [ "constant", "operand" ], "type": "string" }, "value": { "type": "number" }, "operand": { "type": "object", "properties": { "kind": { "enum": [ "field", "indicator", "formula", "strategy" ], "type": "string" }, "field": { "type": "string" }, "params": { "type": "object" }, "plotKey": { "type": "string" }, "studyId": { "type": "string" }, "expression": { "type": "string" }, "strategyId": { "type": "string" } } } } } ], "description": "Use a number for a threshold: RSI >50 is {left:{kind:\"indicator\",studyId:\"rsi\"},operator:\"above\",right:50}. To compare with an indicator use {kind:\"operand\",operand:{kind:\"indicator\",studyId:\"ema\",params:{period:20}}}." }, "operator": { "enum": [ "above", "atOrAbove", "below", "atOrBelow", "equal", "notEqual", "crossesAbove", "crossesBelow", "rising", "falling" ], "type": "string" } } } }, "feeBps": { "type": "number", "description": "Per side. Default 4." }, "market": { "enum": [ "spot", "futures" ], "type": "string", "description": "Defaults to the chart. Perpetuals are futures." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string", "description": "Defaults to the chart." }, "lookback": { "enum": [ 300, 500, 1000, 1500 ], "type": "number", "description": "Bars. Default 300." }, "direction": { "enum": [ "long", "short" ], "type": "string", "description": "Default long." }, "timeframe": { "type": "string", "description": "Defaults to the chart." }, "slippageBps": { "type": "number", "description": "Per side. Default 1." }, "maxPositions": { "type": "number", "description": "Equal-weight slots, 1 to 50. Default 10." }, "universeSize": { "enum": [ 20, 50, 100, 200 ], "type": "number", "description": "Default 50." }, "manualSymbols": { "type": "array", "items": { "type": "string" }, "description": "Optional symbols forced into the universe before current-volume ranking." } } }arguments 246 linesdrawing_add unknown never probed
Draw measured geometry or explain it with text, note, callout or emoji. 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. Measured anchors 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. A note/text position or callout second anchor is layout, not a measured price; place it in spare chart space. 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; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
{ "type": "object", "required": [ "tool", "points" ], "properties": { "ref": { "type": "string", "description": "A handle from market_candles. Measured anchors are checked against its window. A callout checks its first/event anchor; its second/label anchor and note/text positions are layout, not measured prices. Pass it whenever coordinates came from a computation." }, "fill": { "type": "string", "description": "Palette fill colour, or “none”." }, "text": { "type": "string", "description": "Required for text/note/callout: concise words, with \n for short lines. For emoji: one Unicode emoji, e.g. 👀 or ⚠️. Max 500 characters." }, "tool": { "type": "string", "description": "A tool id from catalog_search with kind \"drawing\" — e.g. text, note, callout, emoji, arrow, ellipse, priceZone, horizontalLine, trendLine, rectangle, fibRetracement, longPosition or shortPosition. Prefer position_draw_on_chart for an entry/stop/target box. Separators and capitalisation are forgiven; an id that names no tool is refused." }, "color": { "enum": [ "blue", "orange", "violet", "aqua", "yellow", "magenta", "neutral", "white", "up", "down" ], "type": "string", "description": "A palette name. “up” and “down” are the reserved green and red — they assert a bullish or bearish claim, so use them for position zones and not for a measurement." }, "width": { "type": "number", "description": "Stroke width in pixels, 1 to 6." }, "levels": { "type": "array", "items": { "type": "number" }, "description": "Custom Fibonacci ratios. Example: [0, 0.382, 0.5, 0.618, 0.786, 1, 1.272, 1.618]." }, "points": { "type": "array", "items": { "type": "object", "required": [ "time", "price" ], "properties": { "time": { "type": "number" }, "price": { "type": "number" } } } }, "symbol": { "type": "string", "description": "Defaults to the charted symbol." }, "opacity": { "type": "number", "description": "Strength of the whole drawing, 0.1 to 1. Fade a level that is context rather than the decision." }, "arrowEnd": { "type": "boolean" }, "fontSize": { "type": "number", "description": "Size 9–160px, normally 12–16 for readable text. Emoji render at twice this size." }, "textBold": { "type": "boolean" }, "wrapText": { "type": "boolean", "description": "Default true: wrap long annotation lines for readability. False only for an explicitly requested single-line label." }, "lineStyle": { "enum": [ "solid", "dashed", "dotted" ], "type": "string" }, "showStats": { "type": "boolean" }, "textColor": { "enum": [ "blue", "orange", "violet", "aqua", "yellow", "magenta", "neutral", "white", "up", "down" ], "type": "string" }, "arrowStart": { "type": "boolean" }, "extendLeft": { "type": "boolean" }, "showLabels": { "type": "boolean" }, "showPrices": { "type": "boolean" }, "showRatios": { "type": "boolean" }, "extendRight": { "type": "boolean" }, "fillOpacity": { "type": "number", "description": "Shape fill opacity from 0 to 1." }, "ratioFormat": { "enum": [ "value", "percent" ], "type": "string" }, "labelPosition": { "enum": [ "left", "center", "right" ], "type": "string" }, "labelVertical": { "enum": [ "above", "middle", "below" ], "type": "string" } } }arguments 163 linesformula_evaluate unknown 42h ago
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.
{ "type": "object", "required": [ "expression" ], "properties": { "ref": { "type": "string", "description": "Reuse a handle from market_candles instead of loading." }, "market": { "enum": [ "spot", "futures" ], "type": "string", "description": "Default: the chart." }, "reduce": { "enum": [ "last", "summary", "tail", "crossings" ], "type": "string" }, "symbol": { "type": "string", "description": "Default: the chart." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "timeframe": { "type": "string", "description": "e.g. 1h, 4h. Default: the chart." }, "expression": { "type": "string" }, "parameters": { "type": "object" }, "includeForming": { "type": "boolean" } } }arguments 55 linesbacktest_run reads unknown never probed
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.
{ "type": "object", "required": [ "strategyId" ], "properties": { "ref": { "type": "string", "description": "Reuse a handle from market_candles instead of loading." }, "feeBps": { "type": "number", "description": "Per side. Default 4." }, "market": { "enum": [ "spot", "futures" ], "type": "string", "description": "Default: the chart." }, "params": { "type": "object" }, "symbol": { "type": "string", "description": "Default: the chart." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "direction": { "enum": [ "both", "long", "short" ], "type": "string" }, "timeframe": { "type": "string", "description": "e.g. 1h, 4h. Default: the chart." }, "strategyId": { "type": "string" }, "maxBarsHeld": { "type": "number", "description": "Optional time stop in bars." }, "slippageBps": { "type": "number", "description": "Default 1." }, "stopLossPercent": { "type": "number", "description": "Optional protective stop percentage." }, "takeProfitPercent": { "type": "number", "description": "Optional profit target percentage." } } }arguments 71 linesposition_calculate unknown 17h ago
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.
{ "type": "object", "required": [ "side", "equity", "riskPercent", "entry", "stop" ], "properties": { "side": { "enum": [ "long", "short" ], "type": "string" }, "stop": { "type": "number" }, "entry": { "type": "number" }, "equity": { "type": "number", "description": "Account equity in quote currency." }, "feeBps": { "type": "number", "description": "Fee per side in basis points. Default 4." }, "targets": { "type": "array", "items": { "type": "object", "required": [ "price", "allocation" ], "properties": { "price": { "type": "number" }, "allocation": { "type": "number" } } }, "description": "Take-profit prices and the percentage closed at each. Allocations should total 100." }, "leverage": { "type": "number", "description": "Selected venue leverage. Default 1." }, "fundingRate": { "type": "number", "description": "Funding per settlement as a fraction, e.g. 0.0001." }, "riskPercent": { "type": "number", "description": "Equity risked if the stop fills, in percent." }, "holdingHours": { "type": "number", "description": "Expected holding time for the funding estimate." }, "fundingPerDay": { "type": "number", "description": "Funding settlements per day. Default 3." }, "maintenanceMarginRate": { "type": "number", "description": "Fraction used for approximate liquidation. Default 0.005." } } }arguments 76 linesdrawing_freehand changes data unknown never probed
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; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
{ "type": "object", "required": [ "strokes" ], "properties": { "ref": { "type": "string" }, "fill": { "type": "string", "description": "Palette fill colour, or “none”." }, "mode": { "enum": [ "brush", "highlighter" ], "type": "string" }, "text": { "type": "string", "description": "Required for text/note/callout: concise words, with \n for short lines. For emoji: one Unicode emoji, e.g. 👀 or ⚠️. Max 500 characters." }, "color": { "enum": [ "blue", "orange", "violet", "aqua", "yellow", "magenta", "neutral", "white", "up", "down" ], "type": "string", "description": "A palette name. “up” and “down” are the reserved green and red — they assert a bullish or bearish claim, so use them for position zones and not for a measurement." }, "width": { "type": "number", "description": "Stroke width in pixels, 1 to 6." }, "symbol": { "type": "string" }, "opacity": { "type": "number", "description": "Strength of the whole drawing, 0.1 to 1. Fade a level that is context rather than the decision." }, "strokes": { "type": "array", "items": { "type": "object", "required": [ "shape", "points" ], "properties": { "shape": { "enum": [ "stroke", "line", "ellipse", "rectangle" ], "type": "string" }, "points": { "type": "array", "items": { "type": "object", "required": [ "time", "price" ], "properties": { "time": { "type": "number" }, "price": { "type": "number" } } } } } } }, "arrowEnd": { "type": "boolean" }, "fontSize": { "type": "number", "description": "Size 9–160px, normally 12–16 for readable text. Emoji render at twice this size." }, "textBold": { "type": "boolean" }, "wrapText": { "type": "boolean", "description": "Default true: wrap long annotation lines for readability. False only for an explicitly requested single-line label." }, "lineStyle": { "enum": [ "solid", "dashed", "dotted" ], "type": "string" }, "showStats": { "type": "boolean" }, "textColor": { "enum": [ "blue", "orange", "violet", "aqua", "yellow", "magenta", "neutral", "white", "up", "down" ], "type": "string" }, "arrowStart": { "type": "boolean" }, "extendLeft": { "type": "boolean" }, "showLabels": { "type": "boolean" }, "showPrices": { "type": "boolean" }, "showRatios": { "type": "boolean" }, "extendRight": { "type": "boolean" }, "fillOpacity": { "type": "number", "description": "Shape fill opacity from 0 to 1." }, "ratioFormat": { "enum": [ "value", "percent" ], "type": "string" }, "labelPosition": { "enum": [ "left", "center", "right" ], "type": "string" }, "labelVertical": { "enum": [ "above", "middle", "below" ], "type": "string" } } }arguments 177 linesdrawing_delete changes data unknown never probed
Delete a drawing. This cannot be undone — the shape is not recoverable — so the user is asked first. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
{ "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string" }, "symbol": { "type": "string" } } }arguments 14 linesscreener_run reads unknown never probed
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 use exactly the requested filters. For "5 coins with RSI above 50", call rules: [{left:{kind:"indicator",studyId:"rsi"},operator:"above",right:50}], limit:5. Use above for a current state; crossesAbove only for a fresh crossing. limit controls returned matches, universeSize controls how many markets are searched.
{ "type": "object", "required": [ "rules" ], "properties": { "name": { "type": "string" }, "limit": { "type": "number", "description": "Matches to return. Default 25, max 60." }, "logic": { "enum": [ "all", "any" ], "type": "string", "description": "Default all." }, "order": { "enum": [ "desc", "asc" ], "type": "string", "description": "With sortBy. Default desc; asc for the biggest losers." }, "quote": { "enum": [ "USDT", "USDC", "FDUSD", "BTC", "ETH", "ALL" ], "type": "string", "description": "Default USDC on Hyperliquid, USDT elsewhere." }, "rules": { "type": "array", "items": { "type": "object", "required": [ "left", "operator", "right" ], "properties": { "left": { "type": "object", "properties": { "kind": { "enum": [ "field", "indicator", "formula", "strategy" ], "type": "string" }, "name": { "type": "string" }, "field": { "enum": [ "open", "high", "low", "close", "volume", "quoteVolume", "trades", "change1", "change5", "rangePercent" ], "type": "string" }, "params": { "type": "object", "additionalProperties": { "type": [ "number", "string", "boolean" ] } }, "plotKey": { "type": "string", "description": "Optional; defaults to the first indicator output." }, "studyId": { "type": "string", "description": "Indicator id, e.g. rsi or ema." }, "expression": { "type": "string" }, "parameters": { "type": "object", "additionalProperties": { "type": "number" } }, "strategyId": { "type": "string" } }, "description": "e.g. {\"kind\":\"field\",\"field\":\"change5\"}, {\"kind\":\"indicator\",\"studyId\":\"rsi\",\"plotKey\":\"rsi\"}, or {\"kind\":\"formula\",\"name\":\"atrPct\",\"expression\":\"atr(14)/close*100\"}" }, "right": { "anyOf": [ { "type": "number" }, { "type": "object", "properties": { "kind": { "enum": [ "constant", "operand" ], "type": "string" }, "value": { "type": "number" }, "operand": { "type": "object", "properties": { "kind": { "enum": [ "field", "indicator", "formula", "strategy" ], "type": "string" }, "field": { "type": "string" }, "params": { "type": "object" }, "plotKey": { "type": "string" }, "studyId": { "type": "string" }, "expression": { "type": "string" }, "strategyId": { "type": "string" } } } } } ], "description": "Use a number for a threshold: RSI >50 is {left:{kind:\"indicator\",studyId:\"rsi\"},operator:\"above\",right:50}. To compare with an indicator use {kind:\"operand\",operand:{kind:\"indicator\",studyId:\"ema\",params:{period:20}}}." }, "operator": { "enum": [ "above", "atOrAbove", "below", "atOrBelow", "equal", "notEqual", "crossesAbove", "crossesBelow", "rising", "falling" ], "type": "string" } } } }, "market": { "enum": [ "spot", "futures" ], "type": "string", "description": "Defaults to the chart. Perpetuals are futures." }, "sortBy": { "enum": [ "change24h", "volume24h" ], "type": "string", "description": "Order the matches before the limit, e.g. change24h for top movers. Default: universe order (volume)." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string", "description": "Defaults to the chart." }, "lookback": { "enum": [ 300, 500, 1000, 1500 ], "type": "number", "description": "Bars. Default 300." }, "timeframe": { "type": "string", "description": "Defaults to the chart." }, "universeSize": { "enum": [ 20, 50, 100, 200 ], "type": "number", "description": "Default 50." }, "manualSymbols": { "type": "array", "items": { "type": "string" }, "description": "Optional symbols forced into the universe before current-volume ranking." } } }arguments 246 linesorderflow_read reads unknown never probed
EXECUTED trades only, not resting orders. For current resting liquidity or walls use orderbook_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.
{ "type": "object", "properties": { "levels": { "type": "number", "description": "Price rows. Default 12, max 40." }, "market": { "enum": [ "spot", "futures" ], "type": "string", "description": "Default: the chart." }, "symbol": { "type": "string", "description": "Default: the chart." }, "endTime": { "type": "number", "description": "Window end, default now." }, "minutes": { "type": "number", "description": "Default 3 for a responsive recent read, max 60. Explicit windows are preserved." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "timeframe": { "type": "string", "description": "With candleTime. Defaults to the chart timeframe." }, "bucketSize": { "type": "number", "description": "Price bucket width. Omit unless matching a footprint on screen." }, "candleTime": { "type": "number", "description": "A bar open time, s or ms: reads that whole candle." }, "includeSignals": { "type": "boolean", "description": "Absorption and stacked imbalance. Default true." } } }arguments 54 linesanalysis_prepare unknown never probed
Prepare a PRIVATE sharing package of the current chart image, editable analysis and social caption. Only use when asked for something shareable. Returns a private review link, NOT a public link. The person must open it, edit/review and explicitly publish; you cannot publish or post on their behalf. Chart annotations are included. Do not include private account information.
{ "type": "object", "required": [ "title", "body", "caption" ], "properties": { "body": { "type": "string", "maxLength": 4000, "description": "Plain-text analysis: evidence, timeframe, venue, data timestamp, alternative scenario and invalidation. Only use verified tool results. Never include account balances, keys or private notes." }, "title": { "type": "string", "maxLength": 120, "description": "A specific, factual title. No return promises." }, "levels": { "type": "array", "items": { "anyOf": [ { "type": "number" }, { "type": "object" } ] }, "description": "Prices to mark as horizontal lines, or {price, label, color}." }, "market": { "enum": [ "spot", "futures" ], "type": "string" }, "symbol": { "type": "string", "description": "Optional: set the instrument in this call." }, "caption": { "type": "string", "maxLength": 1000, "description": "Editable social caption in the user’s language, ideally under 220 characters for X. Invite discussion, not a trade. Do not add a URL; the review page adds the public link after approval." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "timeframe": { "type": "string", "description": "Optional, e.g. 15m, 4h, 1d." }, "indicators": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "description": "Ids or common names (\"ema50\", \"rsi\", \"bollinger\"), or {studyId, params}." } } }arguments 77 lineschart_set_instrument unknown never probed
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.
{ "type": "object", "required": [ "symbol" ], "properties": { "market": { "enum": [ "spot", "futures" ], "type": "string" }, "symbol": { "type": "string" }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" } } }arguments 27 lineschart_link changes data unknown never probed
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.
{ "type": "object", "properties": { "note": { "type": "string", "description": "One line describing what this chart shows, for your own reply. Not stored and not shown on the chart." }, "levels": { "type": "array", "items": { "anyOf": [ { "type": "number" }, { "type": "object" } ] }, "description": "Prices to mark as horizontal lines, or {price, label, color}." }, "market": { "enum": [ "spot", "futures" ], "type": "string" }, "symbol": { "type": "string", "description": "Optional: set the instrument in this call." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "timeframe": { "type": "string", "description": "Optional, e.g. 15m, 4h, 1d." }, "indicators": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "description": "Ids or common names (\"ema50\", \"rsi\", \"bollinger\"), or {studyId, params}." } } }arguments 61 lineschart_image unknown never probed
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.
{ "type": "object", "properties": { "bars": { "type": "number", "description": "Bars to show, 20-500. Default 150, widened to include every drawing." }, "size": { "enum": [ "small", "medium", "large" ], "type": "string", "description": "small 800x480, medium 1200x720 (default), large 1600x960." }, "levels": { "type": "array", "items": { "anyOf": [ { "type": "number" }, { "type": "object" } ] }, "description": "Prices to mark as horizontal lines, or {price, label, color}." }, "market": { "enum": [ "spot", "futures" ], "type": "string" }, "symbol": { "type": "string", "description": "Optional: set the instrument in this call." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "timeframe": { "type": "string", "description": "Optional, e.g. 15m, 4h, 1d." }, "indicators": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "description": "Ids or common names (\"ema50\", \"rsi\", \"bollinger\"), or {studyId, params}." } } }arguments 70 lineschart_set_timeframe changes data unknown never probed
Change the chart timeframe, e.g. 15m, 1h, 4h, 1d. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
{ "type": "object", "required": [ "timeframe" ], "properties": { "timeframe": { "type": "string" } } }arguments 11 linesfibonacci_draw changes data unknown never probed
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. For a highest-high/lowest-low retracement use anchorMode high-to-low or low-to-high with ref and lookback: the tool selects exact CLOSED-candle wick coordinates. Do not substitute window start/end times. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
{ "type": "object", "required": [ "tool" ], "properties": { "ref": { "type": "string" }, "fill": { "type": "string", "description": "Palette fill colour, or “none”." }, "text": { "type": "string", "description": "Required for text/note/callout: concise words, with \n for short lines. For emoji: one Unicode emoji, e.g. 👀 or ⚠️. Max 500 characters." }, "tool": { "enum": [ "fibRetracement", "fibExtension", "fibChannel", "fibTimeZone", "fibSpeedFan", "fibTimeExtension", "fibCircles", "fibSpiral", "fibSpeedArcs", "fibWedge" ], "type": "string" }, "color": { "enum": [ "blue", "orange", "violet", "aqua", "yellow", "magenta", "neutral", "white", "up", "down" ], "type": "string", "description": "A palette name. “up” and “down” are the reserved green and red — they assert a bullish or bearish claim, so use them for position zones and not for a measurement." }, "width": { "type": "number", "description": "Stroke width in pixels, 1 to 6." }, "levels": { "type": "array", "items": { "type": "number" } }, "points": { "type": "array", "items": { "type": "object", "required": [ "time", "price" ], "properties": { "time": { "type": "number" }, "price": { "type": "number" } } } }, "symbol": { "type": "string" }, "opacity": { "type": "number", "description": "Strength of the whole drawing, 0.1 to 1. Fade a level that is context rather than the decision." }, "arrowEnd": { "type": "boolean" }, "fontSize": { "type": "number", "description": "Size 9–160px, normally 12–16 for readable text. Emoji render at twice this size." }, "lookback": { "type": "number", "maximum": 50000, "minimum": 2, "description": "Number of most recent CLOSED bars for automatic anchors. Load at least this many closed bars first." }, "textBold": { "type": "boolean" }, "wrapText": { "type": "boolean", "description": "Default true: wrap long annotation lines for readability. False only for an explicitly requested single-line label." }, "lineStyle": { "enum": [ "solid", "dashed", "dotted" ], "type": "string" }, "showStats": { "type": "boolean" }, "textColor": { "enum": [ "blue", "orange", "violet", "aqua", "yellow", "magenta", "neutral", "white", "up", "down" ], "type": "string" }, "anchorMode": { "enum": [ "explicit", "high-to-low", "low-to-high" ], "type": "string", "description": "Default explicit uses points. Automatic modes support fibRetracement only and require ref." }, "arrowStart": { "type": "boolean" }, "extendLeft": { "type": "boolean" }, "showLabels": { "type": "boolean" }, "showPrices": { "type": "boolean" }, "showRatios": { "type": "boolean" }, "extendRight": { "type": "boolean" }, "fillOpacity": { "type": "number", "description": "Shape fill opacity from 0 to 1." }, "ratioFormat": { "enum": [ "value", "percent" ], "type": "string" }, "labelPosition": { "enum": [ "left", "center", "right" ], "type": "string" }, "labelVertical": { "enum": [ "above", "middle", "below" ], "type": "string" } } }arguments 185 linesalert_link reads unknown never probed
Prepare a price, indicator, chart-drawing, news, calendar or Founder whale-group 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.
{ "type": "object", "properties": { "name": { "type": "string", "description": "What the person sees when it fires. Chosen for you if omitted." }, "when": { "enum": [ "crossesAbove", "crossesBelow", "above", "below" ], "type": "string", "description": "With price. Omit to pick the crossing from where price is now." }, "match": { "enum": [ "all", "any" ], "type": "string", "description": "How conditions combine. Default all." }, "price": { "type": "number", "description": "Shorthand for a price-level alert." }, "market": { "enum": [ "spot", "futures" ], "type": "string" }, "symbol": { "type": "string", "description": "e.g. BTCUSDT. Defaults to the chart you are building." }, "message": { "type": "string", "description": "Optional note carried into the notification." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "drawingId": { "type": "string", "description": "ID returned by drawing_add. Supports horizontalLine, horizontalRay, trendLine, ray and extendedLine." }, "frequency": { "enum": [ "once", "oncePerBar", "cooldown" ], "type": "string", "description": "Default once: fires, then switches itself off." }, "timeframe": { "type": "string", "description": "Bars the alert is checked on. Free presets: 1m, 3m, 5m, 10m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M. Founder-only custom intervals: 1–1440 minutes (17m), 1–168 hours (7h), 1–365 days (2d)." }, "conditions": { "type": "array", "items": { "type": "object", "required": [ "left", "operator" ], "properties": { "left": {}, "right": {}, "operator": { "enum": [ "crossesAbove", "crossesBelow", "above", "below", "equal", "rising", "falling", "changeUpPercent", "changeDownPercent" ], "type": "string" } } }, "description": "Instead of price. Each {left, operator, right}. An operand is a number, a price field (\"close\"), an indicator name (\"rsi\", \"ema50\"), or {\"type\":\"indicator\",\"studyId\":\"macd\",\"plotKey\":\"histogram\",\"params\":{}}. rising and falling need no right; changeUpPercent and changeDownPercent take a percent." }, "eventTrigger": { "type": "object", "required": [ "type" ], "properties": { "side": { "enum": [ "any", "long", "short" ], "type": "string" }, "type": { "enum": [ "news", "calendar", "whale" ], "type": "string" }, "coins": { "type": "array", "items": { "type": "string" }, "description": "Whale: exact Hyperliquid coins, preserving HIP-3 prefixes." }, "assets": { "type": "array", "items": { "type": "string" }, "description": "News asset symbols, e.g. BTC, ETH." }, "minUsd": { "type": "number", "description": "Whale minimum absolute position change notional; default 50000." }, "topics": { "type": "array", "items": { "enum": [ "regulation", "macro", "security", "etf", "stablecoins", "exchanges", "defi", "institutions", "mining", "markets" ], "type": "string" } }, "whales": { "type": "array", "items": { "type": "string" }, "maxItems": 6, "minItems": 1, "description": "Founders only: opaque account IDs from founder_whales or founder_whale_research." }, "actions": { "type": "array", "items": { "enum": [ "opened", "added", "reduced", "closed", "flipped" ], "type": "string" } }, "sources": { "type": "array", "items": { "type": "string" } }, "keywords": { "type": "array", "items": { "type": "string" }, "description": "News: literal phrases in title or summary." }, "together": { "type": "integer", "description": "Distinct accounts moving on the same coin and side. Default 1." }, "minImpact": { "description": "News: 0-100 score. Calendar: low, medium or high." }, "titleMode": { "enum": [ "all", "any" ], "type": "string" }, "categories": { "type": "array", "items": { "enum": [ "macro", "network", "derivatives" ], "type": "string" } }, "keywordMode": { "enum": [ "all", "any" ], "type": "string" }, "leadMinutes": { "type": "number", "description": "Calendar: notify this many minutes before the event." }, "titleContains": { "type": "array", "items": { "type": "string" }, "description": "Calendar: literal title/description phrases." }, "windowMinutes": { "type": "integer", "description": "Whale concurrence window, 5–1440; default 60." } }, "description": "Instead of market conditions. A news, Basis calendar or Founder whale-group event filter." }, "cooldownMinutes": { "type": "number", "description": "With frequency cooldown." } } }arguments 248 lineschart_toggle_indicator changes data unknown never probed
Hide or show an indicator without removing it — useful for comparing a chart with and without something. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
{ "type": "object", "required": [ "instanceId" ], "properties": { "instanceId": { "type": "string" } } }arguments 11 linescalendar_history unknown 20h ago
Past calendar dates: FOMC rate decisions, US CPI and non-farm payroll releases from the Fed's and BLS's published calendars (February 2025 on), plus reconstructed conventions (options expiry, CME settlement). Dates only: NOT actual, forecast or previous economic values. No historical funding or halving feed. Use calendar_upcoming for future events.
{ "type": "object", "required": [ "from" ], "properties": { "to": { "type": "string", "description": "A date or timestamp, e.g. 2026-09-01 or 2026-09-01T00:00:00Z. UTC unless it says otherwise." }, "from": { "type": "string", "description": "A date or timestamp, e.g. 2026-09-01 or 2026-09-01T00:00:00Z. UTC unless it says otherwise." } } }arguments 16 linesnews_detect_assets reads unknown never probed
Which crypto assets a piece of text refers to. Word-bounded, so "button" does not match TON and "operation" does not match OP.
{ "type": "object", "required": [ "text" ], "properties": { "text": { "type": "string" } } }arguments 11 lineschart_set_type changes data unknown never probed
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; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
{ "type": "object", "required": [ "chartType" ], "properties": { "chartType": { "type": "string" } } }arguments 11 lineschart_add_indicator changes data unknown never probed
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; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
{ "type": "object", "required": [ "studyId" ], "properties": { "params": { "type": "object" }, "studyId": { "type": "string" } } }arguments 14 lineschart_update_indicator unknown never probed
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; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
{ "type": "object", "required": [ "instanceId", "params" ], "properties": { "params": { "type": "object" }, "instanceId": { "type": "string" } } }arguments 15 lineschart_remove_indicator changes data unknown never probed
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; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
{ "type": "object", "required": [ "instanceId" ], "properties": { "instanceId": { "type": "string" } } }arguments 11 linesposition_draw_on_chart changes data unknown never probed
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. Without explicit timestamps the illustrative box spans recent closed candles for visibility, not future bars or an executed historical trade. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
{ "type": "object", "required": [ "side", "entry", "stop", "target" ], "properties": { "side": { "enum": [ "long", "short" ], "type": "string" }, "stop": { "type": "number" }, "entry": { "type": "number" }, "symbol": { "type": "string" }, "target": { "type": "number" }, "toTime": { "type": "number", "description": "Optional end timestamp in seconds." }, "barsWide": { "type": "number", "description": "Width when timestamps are omitted. Default 20 bars." }, "fromTime": { "type": "number", "description": "Optional start timestamp in seconds." }, "timeframe": { "type": "string" } } }arguments 45 linesposition_plan_on_chart changes data unknown never probed
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. Without explicit timestamps this illustrative scenario spans recent closed candles for visibility, not an executed historical trade. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
{ "type": "object", "required": [ "side", "equity", "riskPercent", "entry", "stop", "targets" ], "properties": { "note": { "type": "string" }, "side": { "enum": [ "long", "short" ], "type": "string" }, "stop": { "type": "number" }, "entry": { "type": "number" }, "equity": { "type": "number", "description": "Account equity in quote currency." }, "feeBps": { "type": "number", "description": "Fee per side in basis points. Default 4." }, "symbol": { "type": "string" }, "toTime": { "type": "number", "description": "Optional end timestamp in seconds." }, "targets": { "type": "array", "items": { "type": "object", "required": [ "price", "allocation" ], "properties": { "price": { "type": "number" }, "allocation": { "type": "number" } } }, "description": "Take-profit prices and the percentage closed at each. Allocations should total 100." }, "barsWide": { "type": "number", "description": "Width when timestamps are omitted. Default 20 bars." }, "fromTime": { "type": "number", "description": "Optional start timestamp in seconds." }, "leverage": { "type": "number", "description": "Selected venue leverage. Default 1." }, "timeframe": { "type": "string" }, "fundingRate": { "type": "number", "description": "Funding per settlement as a fraction, e.g. 0.0001." }, "riskPercent": { "type": "number", "description": "Equity risked if the stop fills, in percent." }, "holdingHours": { "type": "number", "description": "Expected holding time for the funding estimate." }, "fundingPerDay": { "type": "number", "description": "Funding settlements per day. Default 3." }, "strategyProgramId": { "type": "string", "description": "Optional sandbox program linked to this plan." }, "maintenanceMarginRate": { "type": "number", "description": "Fraction used for approximate liquidation. Default 0.005." } } }arguments 102 linesdrawing_style unknown never probed
Edit only the requested properties of an existing drawing; all others are preserved. For a text edit send just {id,text,fontSize}; never copy the entire stored style or its hex colours. 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; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
{ "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "From chart_state." }, "fill": { "type": "string", "description": "Palette fill colour, or “none”." }, "text": { "type": "string", "description": "Required for text/note/callout: concise words, with \n for short lines. For emoji: one Unicode emoji, e.g. 👀 or ⚠️. Max 500 characters." }, "color": { "enum": [ "blue", "orange", "violet", "aqua", "yellow", "magenta", "neutral", "white", "up", "down" ], "type": "string", "description": "A palette name. “up” and “down” are the reserved green and red — they assert a bullish or bearish claim, so use them for position zones and not for a measurement." }, "width": { "type": "number", "description": "Stroke width in pixels, 1 to 6." }, "symbol": { "type": "string", "description": "Defaults to the charted symbol." }, "opacity": { "type": "number", "description": "Strength of the whole drawing, 0.1 to 1. Fade a level that is context rather than the decision." }, "arrowEnd": { "type": "boolean" }, "fontSize": { "type": "number", "description": "Size 9–160px, normally 12–16 for readable text. Emoji render at twice this size." }, "textBold": { "type": "boolean" }, "wrapText": { "type": "boolean", "description": "Default true: wrap long annotation lines for readability. False only for an explicitly requested single-line label." }, "lineStyle": { "enum": [ "solid", "dashed", "dotted" ], "type": "string" }, "showStats": { "type": "boolean" }, "textColor": { "enum": [ "blue", "orange", "violet", "aqua", "yellow", "magenta", "neutral", "white", "up", "down" ], "type": "string" }, "arrowStart": { "type": "boolean" }, "extendLeft": { "type": "boolean" }, "showLabels": { "type": "boolean" }, "showPrices": { "type": "boolean" }, "showRatios": { "type": "boolean" }, "extendRight": { "type": "boolean" }, "fillOpacity": { "type": "number", "description": "Shape fill opacity from 0 to 1." }, "ratioFormat": { "enum": [ "value", "percent" ], "type": "string" }, "labelPosition": { "enum": [ "left", "center", "right" ], "type": "string" }, "labelVertical": { "enum": [ "above", "middle", "below" ], "type": "string" } } }arguments 133 linesorderbook_read unknown never probed
Read current displayed resting bid/ask limit orders on Binance, Bybit, OKX or Hyperliquid perpetuals. Use for resting liquidity, order book/DOM and buy/sell walls, NOT orderflow_read, which reads executed trades. Returns timestamp, spread, largest displayed levels and bounded depth coverage. Not historical depth, hidden stops or guaranteed support.
{ "type": "object", "properties": { "levels": { "type": "integer", "maximum": 20, "minimum": 1, "description": "Returned largest levels per side. Default 8." }, "market": { "enum": [ "spot", "futures" ], "type": "string", "description": "Default: the chart." }, "symbol": { "type": "string", "description": "Default: chart symbol." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "notionalQuote": { "type": "number", "description": "Optional hypothetical order size in quote currency for depth-based VWAP/slippage. Excludes fees and funding." } } }arguments 36 linescatalog_describe reads unknown 7h ago
Full detail for one catalogue entry: an indicator's parameters and defaults, a formula function's signature, a strategy's parameters, or drawing anchor order/text/style. Call this before passing parameters you have not seen.
{ "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string" }, "kind": { "type": "string", "description": "indicator, formula, strategy or drawing. Optional." } } }arguments 15 linesindicator_compute reads unknown never probed
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.
{ "type": "object", "required": [ "studyId" ], "properties": { "ref": { "type": "string", "description": "Reuse a handle from market_candles instead of loading." }, "plot": { "type": "string", "description": "One output only. Usually omit: the others give the reading meaning." }, "market": { "enum": [ "spot", "futures" ], "type": "string", "description": "Default: the chart." }, "params": { "type": "object", "description": "Defaults are used for anything omitted." }, "reduce": { "enum": [ "last", "summary", "tail", "crossings" ], "type": "string" }, "symbol": { "type": "string", "description": "Default: the chart." }, "studyId": { "type": "string", "description": "From catalog_search." }, "dataMode": { "enum": [ "latest", "snapshot" ], "type": "string", "description": "Latest refreshes old handles. Snapshot preserves historical data, never live evidence." }, "exchange": { "enum": [ "binance", "bybit", "okx", "hyperliquid" ], "type": "string" }, "timeframe": { "type": "string", "description": "e.g. 1h, 4h. Default: the chart." }, "includeForming": { "type": "boolean" } } }arguments 69 lines
This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.
Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.
- Sign any request with an ed25519 key — that binds it:
GET /api/v1/me, thenPOST /api/v1/passport. - Prove it is yours. Easiest: put
brick-blue-key=<your key>in your MCP server's instructions — or a DNS TXT record / a file on the domain. - Ask the hub to check:
POST /api/v1/passport/claim-endpointwith this listing's id13a1cc2715ef41ff.
Every step, filled in for this listing: https://brick.blue/api/v1/agents/13a1cc2715ef41ff/claim.
Over MCP: the claim_endpoint tool.
[](https://brick.blue/agent/13a1cc2715ef41ff?ref=badge)
The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.
An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.
MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.
Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.
- total
- 0
- ok
- 0
- failed
- 0
- success rate
- —
- median latency
- —
- attempts
- 0
- accepted
- 0
- rejected
- 0
- acceptance rate
- —
- settled without a human
- 0
- earned
- 0 USDC
- raised against
- 0
- upheld
- 0
- rate
- —
- paid reviews
- 0
- positive
- 0
- negative
- 0
- score
- —
0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.