Basis

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.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "indicator",
        "formula",
        "strategy",
        "variable",
        "drawing",
        "workflow"
      ]
    },
    "query": {
      "type": "string",
      "description": "Free text; matches name, description and category."
    },
    "limit": {
      "type": "number",
      "description": "Default 25, max 100."
    }
  },
  "required": [
    "kind"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "indicator",
        "formula",
        "strategy"
      ]
    },
    "id": {
      "type": "string"
    }
  },
  "required": [
    "kind",
    "id"
  ]
}

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",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "workflow",
        "market-structure",
        "chart-patterns",
        "indicator-meaning",
        "volatility-regime",
        "volume-orderflow",
        "derivatives",
        "whale-positioning",
        "strategy-research",
        "cross-market",
        "risk-execution"
      ]
    }
  },
  "required": [
    "topic"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Default: the chart."
    },
    "timeframe": {
      "type": "string",
      "description": "e.g. 15m, 1h, 4h, 1d."
    },
    "market": {
      "type": "string",
      "enum": [
        "spot",
        "futures"
      ],
      "description": "Default: the chart."
    },
    "exchange": {
      "type": "string",
      "enum": [
        "binance",
        "bybit",
        "okx",
        "hyperliquid"
      ]
    },
    "bars": {
      "type": "number",
      "description": "Default 1000, max 50000."
    },
    "withDerivatives": {
      "type": "boolean",
      "description": "Also load funding, open interest and positioning for this contract."
    }
  }
}

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",
  "properties": {
    "symbols": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "2 to 10 markets, e.g. ETHUSDT, SOLUSDT. Benchmark is added if omitted."
    },
    "benchmark": {
      "type": "string",
      "description": "Default BTCUSDT."
    },
    "timeframe": {
      "type": "string",
      "description": "Default chart timeframe."
    },
    "bars": {
      "type": "number",
      "description": "Default 1500, max 10000 per market."
    },
    "rollingWindow": {
      "type": "number",
      "description": "Latest return observations. Default 90."
    },
    "exchange": {
      "type": "string",
      "enum": [
        "binance",
        "bybit",
        "okx",
        "hyperliquid"
      ]
    },
    "market": {
      "type": "string",
      "enum": [
        "spot",
        "futures"
      ]
    }
  },
  "required": [
    "symbols"
  ]
}

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": {}
}

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.

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string"
    }
  },
  "required": [
    "ref"
  ]
}

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."
    },
    "topSymbols": {
      "type": "number",
      "description": "Market-consensus rows to return. Default 10, max 15."
    },
    "minimumDayVolumeUsd": {
      "type": "number",
      "description": "24h Hyperliquid notional-volume floor. Default $5,000,000."
    },
    "includeRecentFlow": {
      "type": "boolean",
      "description": "Also inspect recent focus-symbol fills for at most four leading contributors."
    },
    "flowHours": {
      "type": "number",
      "description": "Recent-flow window. Default 24h, range 1-168h."
    },
    "maxFlowWallets": {
      "type": "number",
      "description": "Wallets sampled for fills. Default/max 4."
    }
  }
}

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",
  "properties": {
    "studyId": {
      "type": "string",
      "description": "From catalog_search."
    },
    "symbol": {
      "type": "string",
      "description": "Default: the chart."
    },
    "timeframe": {
      "type": "string",
      "description": "e.g. 1h, 4h. Default: the chart."
    },
    "market": {
      "type": "string",
      "enum": [
        "spot",
        "futures"
      ],
      "description": "Default: the chart."
    },
    "exchange": {
      "type": "string",
      "enum": [
        "binance",
        "bybit",
        "okx",
        "hyperliquid"
      ]
    },
    "ref": {
      "type": "string",
      "description": "Reuse a handle from market_candles instead of loading."
    },
    "params": {
      "type": "object",
      "description": "Defaults are used for anything omitted."
    },
    "plot": {
      "type": "string",
      "description": "One output only. Usually omit: the others give the reading meaning."
    },
    "reduce": {
      "type": "string",
      "enum": [
        "last",
        "summary",
        "tail",
        "crossings"
      ]
    },
    "includeForming": {
      "type": "boolean"
    }
  },
  "required": [
    "studyId"
  ]
}

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",
  "properties": {
    "expression": {
      "type": "string"
    },
    "symbol": {
      "type": "string",
      "description": "Default: the chart."
    },
    "timeframe": {
      "type": "string",
      "description": "e.g. 1h, 4h. Default: the chart."
    },
    "market": {
      "type": "string",
      "enum": [
        "spot",
        "futures"
      ],
      "description": "Default: the chart."
    },
    "exchange": {
      "type": "string",
      "enum": [
        "binance",
        "bybit",
        "okx",
        "hyperliquid"
      ]
    },
    "ref": {
      "type": "string",
      "description": "Reuse a handle from market_candles instead of loading."
    },
    "parameters": {
      "type": "object"
    },
    "reduce": {
      "type": "string",
      "enum": [
        "last",
        "summary",
        "tail",
        "crossings"
      ]
    },
    "includeForming": {
      "type": "boolean"
    }
  },
  "required": [
    "expression"
  ]
}

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",
  "properties": {
    "strategyId": {
      "type": "string"
    },
    "symbol": {
      "type": "string",
      "description": "Default: the chart."
    },
    "timeframe": {
      "type": "string",
      "description": "e.g. 1h, 4h. Default: the chart."
    },
    "market": {
      "type": "string",
      "enum": [
        "spot",
        "futures"
      ],
      "description": "Default: the chart."
    },
    "exchange": {
      "type": "string",
      "enum": [
        "binance",
        "bybit",
        "okx",
        "hyperliquid"
      ]
    },
    "ref": {
      "type": "string",
      "description": "Reuse a handle from market_candles instead of loading."
    },
    "params": {
      "type": "object"
    },
    "feeBps": {
      "type": "number",
      "description": "Per side. Default 4."
    },
    "slippageBps": {
      "type": "number",
      "description": "Default 1."
    },
    "direction": {
      "type": "string",
      "enum": [
        "both",
        "long",
        "short"
      ]
    },
    "stopLossPercent": {
      "type": "number",
      "description": "Optional protective stop percentage."
    },
    "takeProfitPercent": {
      "type": "number",
      "description": "Optional profit target percentage."
    },
    "maxBarsHeld": {
      "type": "number",
      "description": "Optional time stop in bars."
    }
  },
  "required": [
    "strategyId"
  ]
}

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": {
    "strategyIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Built-in ids from catalog_search. Omit for the full library."
    },
    "timeframes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Up to 6, e.g. 15m, 1h, 4h, 1d. Defaults to the chart timeframe."
    },
    "symbol": {
      "type": "string",
      "description": "Defaults to the charted symbol."
    },
    "market": {
      "type": "string",
      "enum": [
        "spot",
        "futures"
      ],
      "description": "Default: the chart."
    },
    "exchange": {
      "type": "string",
      "enum": [
        "binance",
        "bybit",
        "okx",
        "hyperliquid"
      ]
    },
    "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."
    },
    "bars": {
      "type": "number",
      "description": "Per symbol and timeframe. Default 3000, max 10000."
    },
    "inSampleFraction": {
      "type": "number",
      "description": "Selection share, 0.5..0.8. Default 0.7."
    },
    "embargoBars": {
      "type": "number",
      "description": "Gap before held-out data. Default 10."
    },
    "folds": {
      "type": "number",
      "description": "Selection subperiods, 2..8. Default 4."
    },
    "minimumTrades": {
      "type": "number",
      "description": "Reliability penalty threshold. Default 30."
    },
    "feeBps": {
      "type": "number",
      "description": "Per side. Default 4."
    },
    "slippageBps": {
      "type": "number",
      "description": "Per fill. Default 1."
    },
    "direction": {
      "type": "string",
      "enum": [
        "both",
        "long",
        "short"
      ]
    }
  }
}

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",
  "properties": {
    "side": {
      "type": "string",
      "enum": [
        "long",
        "short"
      ]
    },
    "equity": {
      "type": "number",
      "description": "Account equity in quote currency."
    },
    "riskPercent": {
      "type": "number",
      "description": "Equity risked if the stop fills, in percent."
    },
    "entry": {
      "type": "number"
    },
    "stop": {
      "type": "number"
    },
    "targets": {
      "type": "array",
      "description": "Take-profit prices and the percentage closed at each. Allocations should total 100.",
      "items": {
        "type": "object",
        "properties": {
          "price": {
            "type": "number"
          },
          "allocation": {
            "type": "number"
          }
        },
        "required": [
          "price",
          "allocation"
        ]
      }
    },
    "leverage": {
      "type": "number",
      "description": "Selected venue leverage. Default 1."
    },
    "feeBps": {
      "type": "number",
      "description": "Fee per side in basis points. Default 4."
    },
    "fundingRate": {
      "type": "number",
      "description": "Funding per settlement as a fraction, e.g. 0.0001."
    },
    "fundingPerDay": {
      "type": "number",
      "description": "Funding settlements per day. Default 3."
    },
    "holdingHours": {
      "type": "number",
      "description": "Expected holding time for the funding estimate."
    },
    "maintenanceMarginRate": {
      "type": "number",
      "description": "Fraction used for approximate liquidation. Default 0.005."
    }
  },
  "required": [
    "side",
    "equity",
    "riskPercent",
    "entry",
    "stop",
    "targets"
  ]
}

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."
    },
    "symbol": {
      "type": "string",
      "description": "Query symbol; defaults to the chart."
    },
    "timeframe": {
      "type": "string",
      "description": "Query timeframe; defaults to the chart."
    },
    "exchange": {
      "type": "string",
      "enum": [
        "binance",
        "bybit",
        "okx",
        "hyperliquid"
      ]
    },
    "market": {
      "type": "string",
      "enum": [
        "spot",
        "futures"
      ]
    },
    "symbols": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 8,
      "description": "Optional same-venue peer corpus. Query symbol is always included."
    },
    "setup": {
      "type": "string",
      "enum": [
        "trend",
        "mean_reversion",
        "breakout"
      ]
    },
    "side": {
      "type": "string",
      "enum": [
        "long",
        "short"
      ]
    },
    "bars": {
      "type": "number",
      "description": "History per symbol. Default 1500; min 300, max 3000."
    },
    "stride": {
      "type": "number",
      "description": "Evaluate one signal point every N bars. Default 4."
    },
    "limit": {
      "type": "number",
      "description": "Displayed analogues. Default 12; max 20."
    },
    "feeBps": {
      "type": "number",
      "description": "Fee per side. Default 4 basis points."
    },
    "slippageBps": {
      "type": "number",
      "description": "Adverse slippage per side. Default 1 basis point."
    }
  }
}

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

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "description": "Base symbol, e.g. BTC. Omit for everything."
    },
    "minImpact": {
      "type": "string",
      "enum": [
        "low",
        "normal",
        "high",
        "critical"
      ]
    },
    "limit": {
      "type": "number",
      "description": "Default 15, max 40."
    }
  }
}

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",
  "properties": {
    "text": {
      "type": "string"
    }
  },
  "required": [
    "text"
  ]
}

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": {}
}

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",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "market": {
      "type": "string",
      "enum": [
        "spot",
        "futures"
      ]
    },
    "exchange": {
      "type": "string",
      "enum": [
        "binance",
        "bybit",
        "okx",
        "hyperliquid"
      ]
    }
  },
  "required": [
    "symbol"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "timeframe": {
      "type": "string"
    }
  },
  "required": [
    "timeframe"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "chartType": {
      "type": "string"
    }
  },
  "required": [
    "chartType"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "studyId": {
      "type": "string"
    },
    "params": {
      "type": "object"
    }
  },
  "required": [
    "studyId"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "instanceId": {
      "type": "string"
    },
    "params": {
      "type": "object"
    }
  },
  "required": [
    "instanceId",
    "params"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "instanceId": {
      "type": "string"
    }
  },
  "required": [
    "instanceId"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "instanceId": {
      "type": "string"
    }
  },
  "required": [
    "instanceId"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string",
      "description": "A tool id from catalog_search with kind \"drawing\" — e.g. 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."
    },
    "points": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "time": {
            "type": "number"
          },
          "price": {
            "type": "number"
          }
        },
        "required": [
          "time",
          "price"
        ]
      }
    },
    "symbol": {
      "type": "string",
      "description": "Defaults to the charted symbol."
    },
    "ref": {
      "type": "string",
      "description": "A handle from market_candles. Given one, the points are checked against the window it covers and a drawing that would land outside it is refused. Pass it whenever the coordinates came from a computation."
    },
    "color": {
      "type": "string",
      "enum": [
        "blue",
        "orange",
        "violet",
        "aqua",
        "yellow",
        "magenta",
        "neutral",
        "white",
        "up",
        "down"
      ],
      "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."
    },
    "lineStyle": {
      "type": "string",
      "enum": [
        "solid",
        "dashed",
        "dotted"
      ]
    },
    "fill": {
      "type": "string",
      "description": "Palette fill colour, or “none”."
    },
    "fillOpacity": {
      "type": "number",
      "description": "Shape fill opacity from 0 to 1."
    },
    "opacity": {
      "type": "number",
      "description": "Strength of the whole drawing, 0.1 to 1. Fade a level that is context rather than the decision."
    },
    "extendLeft": {
      "type": "boolean"
    },
    "extendRight": {
      "type": "boolean"
    },
    "showLabels": {
      "type": "boolean"
    },
    "showStats": {
      "type": "boolean"
    },
    "fontSize": {
      "type": "number",
      "description": "Label/text size from 8 to 28."
    },
    "text": {
      "type": "string",
      "description": "Text for annotation tools."
    },
    "arrowStart": {
      "type": "boolean"
    },
    "arrowEnd": {
      "type": "boolean"
    },
    "levels": {
      "type": "array",
      "description": "Custom Fibonacci ratios. Example: [0, 0.382, 0.5, 0.618, 0.786, 1, 1.272, 1.618].",
      "items": {
        "type": "number"
      }
    }
  },
  "required": [
    "tool",
    "points"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string",
      "enum": [
        "fibRetracement",
        "fibExtension",
        "fibChannel",
        "fibTimeZone",
        "fibSpeedFan",
        "fibTimeExtension",
        "fibCircles",
        "fibSpiral",
        "fibSpeedArcs",
        "fibWedge"
      ]
    },
    "points": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "time": {
            "type": "number"
          },
          "price": {
            "type": "number"
          }
        },
        "required": [
          "time",
          "price"
        ]
      }
    },
    "levels": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "symbol": {
      "type": "string"
    },
    "ref": {
      "type": "string"
    },
    "color": {
      "type": "string",
      "enum": [
        "blue",
        "orange",
        "violet",
        "aqua",
        "yellow",
        "magenta",
        "neutral",
        "white",
        "up",
        "down"
      ],
      "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."
    },
    "lineStyle": {
      "type": "string",
      "enum": [
        "solid",
        "dashed",
        "dotted"
      ]
    },
    "fill": {
      "type": "string",
      "description": "Palette fill colour, or “none”."
    },
    "fillOpacity": {
      "type": "number",
      "description": "Shape fill opacity from 0 to 1."
    },
    "opacity": {
      "type": "number",
      "description": "Strength of the whole drawing, 0.1 to 1. Fade a level that is context rather than the decision."
    },
    "extendLeft": {
      "type": "boolean"
    },
    "extendRight": {
      "type": "boolean"
    },
    "showLabels": {
      "type": "boolean"
    },
    "showStats": {
      "type": "boolean"
    },
    "fontSize": {
      "type": "number",
      "description": "Label/text size from 8 to 28."
    },
    "text": {
      "type": "string",
      "description": "Text for annotation tools."
    },
    "arrowStart": {
      "type": "boolean"
    },
    "arrowEnd": {
      "type": "boolean"
    }
  },
  "required": [
    "tool",
    "points"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "strokes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "shape": {
            "type": "string",
            "enum": [
              "stroke",
              "line",
              "ellipse",
              "rectangle"
            ]
          },
          "points": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "time": {
                  "type": "number"
                },
                "price": {
                  "type": "number"
                }
              },
              "required": [
                "time",
                "price"
              ]
            }
          }
        },
        "required": [
          "shape",
          "points"
        ]
      }
    },
    "mode": {
      "type": "string",
      "enum": [
        "brush",
        "highlighter"
      ]
    },
    "symbol": {
      "type": "string"
    },
    "ref": {
      "type": "string"
    },
    "color": {
      "type": "string",
      "enum": [
        "blue",
        "orange",
        "violet",
        "aqua",
        "yellow",
        "magenta",
        "neutral",
        "white",
        "up",
        "down"
      ],
      "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."
    },
    "lineStyle": {
      "type": "string",
      "enum": [
        "solid",
        "dashed",
        "dotted"
      ]
    },
    "fill": {
      "type": "string",
      "description": "Palette fill colour, or “none”."
    },
    "fillOpacity": {
      "type": "number",
      "description": "Shape fill opacity from 0 to 1."
    },
    "opacity": {
      "type": "number",
      "description": "Strength of the whole drawing, 0.1 to 1. Fade a level that is context rather than the decision."
    },
    "extendLeft": {
      "type": "boolean"
    },
    "extendRight": {
      "type": "boolean"
    },
    "showLabels": {
      "type": "boolean"
    },
    "showStats": {
      "type": "boolean"
    },
    "fontSize": {
      "type": "number",
      "description": "Label/text size from 8 to 28."
    },
    "text": {
      "type": "string",
      "description": "Text for annotation tools."
    },
    "arrowStart": {
      "type": "boolean"
    },
    "arrowEnd": {
      "type": "boolean"
    }
  },
  "required": [
    "strokes"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "side": {
      "type": "string",
      "enum": [
        "long",
        "short"
      ]
    },
    "entry": {
      "type": "number"
    },
    "stop": {
      "type": "number"
    },
    "target": {
      "type": "number"
    },
    "symbol": {
      "type": "string"
    },
    "timeframe": {
      "type": "string"
    },
    "fromTime": {
      "type": "number",
      "description": "Optional start timestamp in seconds."
    },
    "toTime": {
      "type": "number",
      "description": "Optional end timestamp in seconds."
    },
    "barsWide": {
      "type": "number",
      "description": "Width when timestamps are omitted. Default 20 bars."
    }
  },
  "required": [
    "side",
    "entry",
    "stop",
    "target"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "side": {
      "type": "string",
      "enum": [
        "long",
        "short"
      ]
    },
    "equity": {
      "type": "number",
      "description": "Account equity in quote currency."
    },
    "riskPercent": {
      "type": "number",
      "description": "Equity risked if the stop fills, in percent."
    },
    "entry": {
      "type": "number"
    },
    "stop": {
      "type": "number"
    },
    "targets": {
      "type": "array",
      "description": "Take-profit prices and the percentage closed at each. Allocations should total 100.",
      "items": {
        "type": "object",
        "properties": {
          "price": {
            "type": "number"
          },
          "allocation": {
            "type": "number"
          }
        },
        "required": [
          "price",
          "allocation"
        ]
      }
    },
    "leverage": {
      "type": "number",
      "description": "Selected venue leverage. Default 1."
    },
    "feeBps": {
      "type": "number",
      "description": "Fee per side in basis points. Default 4."
    },
    "fundingRate": {
      "type": "number",
      "description": "Funding per settlement as a fraction, e.g. 0.0001."
    },
    "fundingPerDay": {
      "type": "number",
      "description": "Funding settlements per day. Default 3."
    },
    "holdingHours": {
      "type": "number",
      "description": "Expected holding time for the funding estimate."
    },
    "maintenanceMarginRate": {
      "type": "number",
      "description": "Fraction used for approximate liquidation. Default 0.005."
    },
    "symbol": {
      "type": "string"
    },
    "timeframe": {
      "type": "string"
    },
    "fromTime": {
      "type": "number",
      "description": "Optional start timestamp in seconds."
    },
    "toTime": {
      "type": "number",
      "description": "Optional end timestamp in seconds."
    },
    "barsWide": {
      "type": "number",
      "description": "Width when timestamps are omitted. Default 20 bars."
    },
    "strategyProgramId": {
      "type": "string",
      "description": "Optional sandbox program linked to this plan."
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "side",
    "equity",
    "riskPercent",
    "entry",
    "stop",
    "targets"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "From chart_state."
    },
    "symbol": {
      "type": "string",
      "description": "Defaults to the charted symbol."
    },
    "color": {
      "type": "string",
      "enum": [
        "blue",
        "orange",
        "violet",
        "aqua",
        "yellow",
        "magenta",
        "neutral",
        "white",
        "up",
        "down"
      ],
      "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."
    },
    "lineStyle": {
      "type": "string",
      "enum": [
        "solid",
        "dashed",
        "dotted"
      ]
    },
    "fill": {
      "type": "string",
      "description": "Palette fill colour, or “none”."
    },
    "fillOpacity": {
      "type": "number",
      "description": "Shape fill opacity from 0 to 1."
    },
    "opacity": {
      "type": "number",
      "description": "Strength of the whole drawing, 0.1 to 1. Fade a level that is context rather than the decision."
    },
    "extendLeft": {
      "type": "boolean"
    },
    "extendRight": {
      "type": "boolean"
    },
    "showLabels": {
      "type": "boolean"
    },
    "showStats": {
      "type": "boolean"
    },
    "fontSize": {
      "type": "number",
      "description": "Label/text size from 8 to 28."
    },
    "text": {
      "type": "string",
      "description": "Text for annotation tools."
    },
    "arrowStart": {
      "type": "boolean"
    },
    "arrowEnd": {
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "symbol": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "logic": {
      "type": "string",
      "enum": [
        "all",
        "any"
      ],
      "description": "Default all."
    },
    "rules": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "left": {
            "type": "object",
            "description": "e.g. {\"kind\":\"field\",\"field\":\"change5\"}, {\"kind\":\"indicator\",\"studyId\":\"rsi\",\"plotKey\":\"rsi\"}, or {\"kind\":\"formula\",\"name\":\"atrPct\",\"expression\":\"atr(14)/close*100\"}"
          },
          "operator": {
            "type": "string",
            "enum": [
              "above",
              "atOrAbove",
              "below",
              "atOrBelow",
              "equal",
              "notEqual",
              "crossesAbove",
              "crossesBelow",
              "rising",
              "falling"
            ]
          },
          "right": {
            "type": "object",
            "description": "{\"kind\":\"constant\",\"value\":30} or {\"kind\":\"operand\",\"operand\":{…}}"
          }
        },
        "required": [
          "left",
          "operator",
          "right"
        ]
      }
    },
    "timeframe": {
      "type": "string",
      "description": "Defaults to the chart."
    },
    "universeSize": {
      "type": "number",
      "enum": [
        20,
        50,
        100,
        200
      ],
      "description": "Default 50."
    },
    "lookback": {
      "type": "number",
      "enum": [
        300,
        500,
        1000,
        1500
      ],
      "description": "Bars. Default 300."
    },
    "quote": {
      "type": "string",
      "enum": [
        "USDT",
        "USDC",
        "FDUSD",
        "BTC",
        "ETH",
        "ALL"
      ],
      "description": "Default USDT."
    },
    "manualSymbols": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional symbols forced into the universe before current-volume ranking."
    },
    "limit": {
      "type": "number",
      "description": "Matches to return. Default 25, max 60."
    }
  },
  "required": [
    "rules"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "longRules": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "left": {
            "type": "object",
            "description": "e.g. {\"kind\":\"field\",\"field\":\"change5\"}, {\"kind\":\"indicator\",\"studyId\":\"rsi\",\"plotKey\":\"rsi\"}, or {\"kind\":\"formula\",\"name\":\"atrPct\",\"expression\":\"atr(14)/close*100\"}"
          },
          "operator": {
            "type": "string",
            "enum": [
              "above",
              "atOrAbove",
              "below",
              "atOrBelow",
              "equal",
              "notEqual",
              "crossesAbove",
              "crossesBelow",
              "rising",
              "falling"
            ]
          },
          "right": {
            "type": "object",
            "description": "{\"kind\":\"constant\",\"value\":30} or {\"kind\":\"operand\",\"operand\":{…}}"
          }
        },
        "required": [
          "left",
          "operator",
          "right"
        ]
      }
    },
    "shortRules": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "left": {
            "type": "object",
            "description": "e.g. {\"kind\":\"field\",\"field\":\"change5\"}, {\"kind\":\"indicator\",\"studyId\":\"rsi\",\"plotKey\":\"rsi\"}, or {\"kind\":\"formula\",\"name\":\"atrPct\",\"expression\":\"atr(14)/close*100\"}"
          },
          "operator": {
            "type": "string",
            "enum": [
              "above",
              "atOrAbove",
              "below",
              "atOrBelow",
              "equal",
              "notEqual",
              "crossesAbove",
              "crossesBelow",
              "rising",
              "falling"
            ]
          },
          "right": {
            "type": "object",
            "description": "{\"kind\":\"constant\",\"value\":30} or {\"kind\":\"operand\",\"operand\":{…}}"
          }
        },
        "required": [
          "left",
          "operator",
          "right"
        ]
      }
    },
    "timeframe": {
      "type": "string",
      "description": "Discovery timeframe; normally 15m or 1h."
    },
    "universeSize": {
      "type": "number",
      "enum": [
        20,
        50,
        100,
        200
      ],
      "description": "Default 100."
    },
    "lookback": {
      "type": "number",
      "enum": [
        300,
        500,
        1000,
        1500
      ],
      "description": "Default 300."
    },
    "quote": {
      "type": "string",
      "enum": [
        "USDT",
        "USDC",
        "FDUSD",
        "BTC",
        "ETH",
        "ALL"
      ]
    },
    "manualSymbols": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional symbols forced into the universe before current-volume ranking."
    },
    "limitPerSide": {
      "type": "number",
      "description": "Candidates returned per direction. Default 10, max 25."
    }
  },
  "required": [
    "longRules",
    "shortRules"
  ]
}

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",
  "properties": {
    "name": {
      "type": "string"
    },
    "logic": {
      "type": "string",
      "enum": [
        "all",
        "any"
      ],
      "description": "Default all."
    },
    "rules": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "left": {
            "type": "object",
            "description": "e.g. {\"kind\":\"field\",\"field\":\"change5\"}, {\"kind\":\"indicator\",\"studyId\":\"rsi\",\"plotKey\":\"rsi\"}, or {\"kind\":\"formula\",\"name\":\"atrPct\",\"expression\":\"atr(14)/close*100\"}"
          },
          "operator": {
            "type": "string",
            "enum": [
              "above",
              "atOrAbove",
              "below",
              "atOrBelow",
              "equal",
              "notEqual",
              "crossesAbove",
              "crossesBelow",
              "rising",
              "falling"
            ]
          },
          "right": {
            "type": "object",
            "description": "{\"kind\":\"constant\",\"value\":30} or {\"kind\":\"operand\",\"operand\":{…}}"
          }
        },
        "required": [
          "left",
          "operator",
          "right"
        ]
      }
    },
    "timeframe": {
      "type": "string",
      "description": "Defaults to the chart."
    },
    "universeSize": {
      "type": "number",
      "enum": [
        20,
        50,
        100,
        200
      ],
      "description": "Default 50."
    },
    "lookback": {
      "type": "number",
      "enum": [
        300,
        500,
        1000,
        1500
      ],
      "description": "Bars. Default 300."
    },
    "quote": {
      "type": "string",
      "enum": [
        "USDT",
        "USDC",
        "FDUSD",
        "BTC",
        "ETH",
        "ALL"
      ],
      "description": "Default USDT."
    },
    "manualSymbols": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional symbols forced into the universe before current-volume ranking."
    },
    "direction": {
      "type": "string",
      "enum": [
        "long",
        "short"
      ],
      "description": "Default long."
    },
    "maxPositions": {
      "type": "number",
      "description": "Equal-weight slots, 1 to 50. Default 10."
    },
    "feeBps": {
      "type": "number",
      "description": "Per side. Default 4."
    },
    "slippageBps": {
      "type": "number",
      "description": "Per side. Default 1."
    }
  },
  "required": [
    "rules"
  ]
}

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.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Contract for funding settlements. Defaults to the charted symbol."
    },
    "days": {
      "type": "number",
      "description": "Horizon ahead. Default 30, max 365."
    },
    "impact": {
      "type": "string",
      "enum": [
        "high",
        "medium",
        "low"
      ],
      "description": "Only events at or above this impact."
    },
    "limit": {
      "type": "number",
      "description": "Default 20, max 50."
    }
  }
}

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": {
    "symbol": {
      "type": "string",
      "description": "Default: the chart."
    },
    "market": {
      "type": "string",
      "enum": [
        "spot",
        "futures"
      ],
      "description": "Default: the chart."
    },
    "exchange": {
      "type": "string",
      "enum": [
        "binance",
        "bybit",
        "okx",
        "hyperliquid"
      ]
    },
    "minutes": {
      "type": "number",
      "description": "Default 15, max 60."
    },
    "endTime": {
      "type": "number",
      "description": "Window end, default now."
    },
    "candleTime": {
      "type": "number",
      "description": "A bar open time, s or ms: reads that whole candle."
    },
    "timeframe": {
      "type": "string",
      "description": "With candleTime. Defaults to the chart timeframe."
    },
    "levels": {
      "type": "number",
      "description": "Price rows. Default 12, max 40."
    },
    "bucketSize": {
      "type": "number",
      "description": "Price bucket width. Omit unless matching a footprint on screen."
    },
    "includeSignals": {
      "type": "boolean",
      "description": "Absorption and stacked imbalance. Default true."
    }
  }
}

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": {
    "before": {
      "type": "string",
      "description": "ISO 8601 timestamp with timezone, e.g. 2026-09-01T00:00:00Z."
    },
    "asset": {
      "type": "string",
      "description": "Base asset, e.g. BTC; supported asset tags only."
    },
    "topic": {
      "type": "string",
      "enum": [
        "markets",
        "regulation",
        "macro",
        "security",
        "etf",
        "stablecoins",
        "exchanges",
        "defi",
        "institutions",
        "mining"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "default": 20
    }
  }
}

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.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "ISO 8601 timestamp with timezone, e.g. 2026-09-01T00:00:00Z."
    },
    "to": {
      "type": "string",
      "description": "ISO 8601 timestamp with timezone, e.g. 2026-09-01T00:00:00Z."
    }
  },
  "required": [
    "from",
    "to"
  ]
}

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."
    },
    "symbol": {
      "type": "string",
      "description": "Optional: set the instrument in this call."
    },
    "market": {
      "type": "string",
      "enum": [
        "spot",
        "futures"
      ]
    },
    "exchange": {
      "type": "string",
      "enum": [
        "binance",
        "bybit",
        "okx",
        "hyperliquid"
      ]
    },
    "timeframe": {
      "type": "string",
      "description": "Optional, e.g. 15m, 4h, 1d."
    },
    "indicators": {
      "type": "array",
      "description": "Ids or common names (\"ema50\", \"rsi\", \"bollinger\"), or {studyId, params}.",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "object"
          }
        ]
      }
    },
    "levels": {
      "type": "array",
      "description": "Prices to mark as horizontal lines, or {price, label, color}.",
      "items": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "object"
          }
        ]
      }
    }
  }
}

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": {
    "symbol": {
      "type": "string",
      "description": "Optional: set the instrument in this call."
    },
    "market": {
      "type": "string",
      "enum": [
        "spot",
        "futures"
      ]
    },
    "exchange": {
      "type": "string",
      "enum": [
        "binance",
        "bybit",
        "okx",
        "hyperliquid"
      ]
    },
    "timeframe": {
      "type": "string",
      "description": "Optional, e.g. 15m, 4h, 1d."
    },
    "indicators": {
      "type": "array",
      "description": "Ids or common names (\"ema50\", \"rsi\", \"bollinger\"), or {studyId, params}.",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "object"
          }
        ]
      }
    },
    "levels": {
      "type": "array",
      "description": "Prices to mark as horizontal lines, or {price, label, color}.",
      "items": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "object"
          }
        ]
      }
    },
    "bars": {
      "type": "number",
      "description": "Bars to show, 20-500. Default 150, widened to include every drawing."
    },
    "size": {
      "type": "string",
      "enum": [
        "small",
        "medium",
        "large"
      ],
      "description": "small 800x480, medium 1200x720 (default), large 1600x960."
    }
  }
}

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.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "e.g. BTCUSDT. Defaults to the chart you are building."
    },
    "exchange": {
      "type": "string",
      "enum": [
        "binance",
        "bybit",
        "okx",
        "hyperliquid"
      ]
    },
    "market": {
      "type": "string",
      "enum": [
        "spot",
        "futures"
      ]
    },
    "timeframe": {
      "type": "string",
      "description": "Bars the alert is checked on, e.g. 15m, 1h, 4h. One of 1m, 3m, 5m, 10m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M."
    },
    "price": {
      "type": "number",
      "description": "Shorthand for a price-level alert."
    },
    "when": {
      "type": "string",
      "enum": [
        "crossesAbove",
        "crossesBelow",
        "above",
        "below"
      ],
      "description": "With price. Omit to pick the crossing from where price is now."
    },
    "drawingId": {
      "type": "string",
      "description": "ID returned by drawing_add. Supports horizontalLine, horizontalRay, trendLine, ray and extendedLine."
    },
    "eventTrigger": {
      "type": "object",
      "description": "Instead of market conditions. A news or Basis calendar event filter.",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "news",
            "calendar"
          ]
        },
        "keywords": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "News: literal phrases in title or summary."
        },
        "keywordMode": {
          "type": "string",
          "enum": [
            "all",
            "any"
          ]
        },
        "assets": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "News asset symbols, e.g. BTC, ETH."
        },
        "topics": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "regulation",
              "macro",
              "security",
              "etf",
              "stablecoins",
              "exchanges",
              "defi",
              "institutions",
              "mining",
              "markets"
            ]
          }
        },
        "sources": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "minImpact": {
          "description": "News: 0-100 score. Calendar: low, medium or high."
        },
        "titleContains": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Calendar: literal title/description phrases."
        },
        "titleMode": {
          "type": "string",
          "enum": [
            "all",
            "any"
          ]
        },
        "categories": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "macro",
              "network",
              "derivatives"
            ]
          }
        },
        "leadMinutes": {
          "type": "number",
          "description": "Calendar: notify this many minutes before the event."
        }
      },
      "required": [
        "type"
      ]
    },
    "conditions": {
      "type": "array",
      "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.",
      "items": {
        "type": "object",
        "properties": {
          "left": {},
          "operator": {
            "type": "string",
            "enum": [
              "crossesAbove",
              "crossesBelow",
              "above",
              "below",
              "equal",
              "rising",
              "falling",
              "changeUpPercent",
              "changeDownPercent"
            ]
          },
          "right": {}
        },
        "required": [
          "left",
          "operator"
        ]
      }
    },
    "match": {
      "type": "string",
      "enum": [
        "all",
        "any"
      ],
      "description": "How conditions combine. Default all."
    },
    "frequency": {
      "type": "string",
      "enum": [
        "once",
        "oncePerBar",
        "cooldown"
      ],
      "description": "Default once: fires, then switches itself off."
    },
    "cooldownMinutes": {
      "type": "number",
      "description": "With frequency cooldown."
    },
    "name": {
      "type": "string",
      "description": "What the person sees when it fires. Chosen for you if omitted."
    },
    "message": {
      "type": "string",
      "description": "Optional note carried into the notification."
    }
  }
}