Server definition
- Hash
- sha256:ea6400beb9092fd4684df37c45812fb968aff3914265a7d14a13576202564717
- What it is
- What a remote MCP server returned when asked what it offers: 25 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "SERVER-EXECUTED, read-only: ask the JEV decision model for a typed verdict (verdict + agreement% + snapshot age). Pass family (cex | dex_perps | prediction) + venue + symbol. The server builds multi-timeframe candles itself for CEX (venue+symbol only); dex_perps needs snapshot.timeframes [{tf, candles:[{o,h,l,c,v?}]}]; prediction needs snapshot.brief ONLY — 2–6 research notes YOU assemble ({title, snippet, url, at} with real URLs you can vouch for): the server fetches the live book itself and grounds the call, so never paste prices as snapshot.market (a model-supplied market is ignored). Call this BEFORE any trade proposal and cite the verdict (agree/disagree + why) in the proposal thesis — uncertain/mixed verdicts mean no trade. NEVER narrate instead of calling it.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"exchange": {
"description": "Alias of venue (chat compat).",
"type": "string"
},
"family": {
"description": "Market family matching the planned trade.",
"enum": [
"cex",
"dex_perps",
"prediction"
],
"type": "string"
},
"pair": {
"description": "Alias of symbol (chat compat).",
"type": "string"
},
"snapshot": {
"description": "Optional override: { timeframes: [{tf, candles: [{o,h,l,c,v?}]}] } for cex/dex_perps, { market, brief: [{title, snippet, url, at}] } for prediction. Omit for CEX — the server builds candles itself; dex_perps/prediction need the snapshot shapes above.",
"type": "object"
},
"symbol": {
"description": "Pair, ticker, or condition id (e.g. BTC/USDT). Required for cex unless the snapshot already carries timeframes; prediction takes the Polymarket conditionId/slug or Opinion market id.",
"type": "string"
},
"venue": {
"description": "Venue slug (e.g. binance, kucoin, polymarket). Required for cex unless the snapshot already carries timeframes; prediction defaults to polymarket.",
"type": "string"
}
},
"required": [
"family"
],
"type": "object"
},
"name": "analyze_market",
"outputSchema": null
},
{
"description": "Cancel an open CEX order by order id. Needs trade:execute. CANCELS ARE NEVER BLOCKED BY THE KILL SWITCH (D4): a cancel always passes, even with the switch on or autonomy=propose_only — the switch stops NEW positions only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"connectionId": {
"description": "CEX connection id (see list_connections). Takes precedence over exchange.",
"type": "string"
},
"exchange": {
"description": "CEX slug, e.g. kucoin",
"type": "string"
},
"market": {
"description": "Optional market scope. Omit to search both.",
"enum": [
"spot",
"futures"
],
"type": "string"
},
"orderId": {
"description": "Venue order id to cancel",
"type": "string"
},
"pair": {
"description": "e.g. BTC/USDT (helps venue routing)",
"type": "string"
}
},
"required": [
"exchange",
"orderId"
],
"type": "object"
},
"name": "cancel_order",
"outputSchema": null
},
{
"description": "Close an open CEX futures position (or reduce it) with a reduce-only market order. Real money. Needs the trade:execute scope. EXITS ARE NEVER BLOCKED BY THE KILL SWITCH (owner decision D4): a close, a reduce-only order and a cancel always pass, and the switch plus autonomy=propose_only stop only NEW positions. NEVER touch positions the user marked manual unless explicitly asked.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"connectionId": {
"description": "CEX connection id (see list_connections). Takes precedence over exchange.",
"type": "string"
},
"exchange": {
"description": "CEX slug, e.g. kucoin",
"type": "string"
},
"pair": {
"description": "e.g. BTC/USDT",
"type": "string"
},
"side": {
"description": "Side of the OPEN position",
"enum": [
"long",
"short"
],
"type": "string"
},
"size": {
"description": "Size to close, in the unit the positions tool reported for this venue — contracts on OKX swaps, the contract's own size on Kraken, base units elsewhere. Omit to close the whole leg on the named side: okx, binance, bybit, bitget, gateio, kucoin, bingx and kraken close it, mexc and coinbase refuse (no close path). Or pass a smaller amount to reduce partially",
"type": "string"
}
},
"required": [
"exchange",
"pair",
"side"
],
"type": "object"
},
"name": "close_position",
"outputSchema": null
},
{
"description": "Build the morning brief (risk header, positions, 5-venue funding/OI, liquidation proxy, macro 24h, regime, JEV bias per name) and record it as the day's 'Daily analysis' in the diary. Reads need mcp:read; the diary write needs trade:propose (or pass write:false for a dry run). Sections carry [DATA]/[PROXY]/[UNAVAILABLE] tags — gaps are never synthesized.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"day": {
"description": "YYYY-MM-DD (default today UTC)",
"type": "string"
},
"write": {
"description": "Record into diary_day_notes (default true)",
"type": "boolean"
}
},
"type": "object"
},
"name": "daily_prep",
"outputSchema": null
},
{
"description": "Execute a live CEX order immediately (real money) via stored exchange keys. Needs the trade:execute scope AND user YOLO eligibility (kill switch off, autonomy != propose_only) — entries are the one class the switch blocks; closes, cancels and exit legs always pass (D4). Caps enforced per order. Fee-aware: pass stop to refuse stops that cannot survive round-trip fees (min-move gate), or risk_usd to size from risk (needs stop, else an ATR stop from venue klines). Returns the fee estimate + min-move in the result. CEX spot/futures only — never on-chain.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"actor": {
"description": "WHO is placing the order. 'machine' for the trading machine; 'owner' for the account owner's own manual trading. The account is SHARED, so this is what tells the machine's trades from the owner's when a closed trade is reconciled against the machine's daily loss cap. Defaults to 'owner'.",
"enum": [
"machine",
"owner"
],
"type": "string"
},
"agentId": {
"description": "Optional agent id this session is bound to (max 64 chars). Forwarded to cex-proxy, which verifies it belongs to you and applies that agent's per-agent caps/kill switch; a foreign or forged id is refused (403). Omit it to trade under the account's own caps.",
"type": "string"
},
"amount": {
"description": "Base units, e.g. 0.05 (omit when risk_usd sizes the order)",
"type": "string"
},
"clientOid": {
"description": "Optional caller-supplied identity tag for the order (max 36 chars, [A-Za-z0-9_-]). A later session uses it to attribute the order to its owner instead of classifying it as foreign/unknown-origin. Omit it and the server generates a random UUID.",
"type": "string"
},
"connectionId": {
"description": "CEX connection id (see list_connections). Takes precedence over exchange.",
"type": "string"
},
"exchange": {
"description": "CEX slug, e.g. kucoin",
"type": "string"
},
"idempotency_key": {
"description": "Optional per-INTENT key. Two submits with the same key are the same intent: the second is deduped and never dispatched again. Use it when a submission may be retried (a timeout, a reconnect) so a retry cannot double-fill.",
"type": "string"
},
"leverage": {
"description": "Futures only; rides the order (KuCoin has no venue-level setting)",
"type": "number"
},
"marginMode": {
"description": "Futures only; isolated bounds max loss to position margin (default cross)",
"enum": [
"cross",
"isolated"
],
"type": "string"
},
"market": {
"description": "Which market to trade (default spot)",
"enum": [
"spot",
"futures"
],
"type": "string"
},
"pair": {
"description": "e.g. BTC/USDT",
"type": "string"
},
"price": {
"description": "Limit price. OMIT for a market order. When the order type is 'market' the price is only a reference for sizing and is NOT sent to the venue — a resting limit has no position to protect, so the exit legs cannot attach to it.",
"type": "string"
},
"referencePrice": {
"description": "For a MARKET order only: the price the exit legs were derived from. The venue may fill the entry at a different price, and the server REBASES the stop and target onto the actual fill (each keeps its distance from this reference). Omit it and the legs are placed at their original absolute prices, which can land on the wrong side of the fill.",
"type": "string"
},
"risk_usd": {
"description": "Max USD loss at the stop — sizes the order as risk_usd / stop distance (needs stop, else ATR stop from venue klines; capped by max_position_usd + lot step).",
"type": "number"
},
"side": {
"description": "Order side: buy|sell",
"enum": [
"buy",
"sell"
],
"type": "string"
},
"stop": {
"description": "Protective stop price (> 0). Gated server-side: stops inside round-trip fees x factor are refused with the shortfall spelled out, and armed as a venue-native SL exit leg after the entry across all CEX venues.",
"type": "number"
},
"tp": {
"description": "Take-profit price (> 0) armed with the entry as a single 100%-share venue-native TP exit leg across all CEX venues. Must sit on the profit side of the entry (long: above, short: below).",
"type": "number"
},
"tpLegs": {
"description": "Optional 1-3 split take-profit legs ({ price, share }, where share is 1..100 percent of entry size) armed as venue-native TP orders after the entry.",
"items": {
"additionalProperties": false,
"properties": {
"price": {
"description": "Take-profit trigger price (> 0)",
"type": "number"
},
"share": {
"description": "Share of the entry to close at this leg, 1..100 percent",
"type": "number"
}
},
"required": [
"price",
"share"
],
"type": "object"
},
"type": "array"
},
"tpPrice": {
"description": "Deprecated alias of tp.",
"type": "number"
},
"type": {
"description": "Order type. Defaults to 'limit' when a price is given, else 'market'. Use 'market' for a live entry: the exit legs are venue-native conditionals that attach to a POSITION, so a RESTING LIMIT has no position to protect and rests on the book unprotected until it fills.",
"enum": [
"market",
"limit"
],
"type": "string"
}
},
"required": [
"exchange",
"pair",
"side"
],
"type": "object"
},
"name": "execute_trade",
"outputSchema": null
},
{
"description": "READ-ONLY: one-shot summary of the user's Insights page — market regime (BTC/ETH price + 24h, total market cap, Fear & Greed, ETF 7d net flow, stablecoin supply), cross-venue funding extremes, the fee-aware carry board, DEX perp volume share, the caller's own fee drag from the Diary, headlines, and a deterministic brief. Values may be null/unknown; missing blocks are listed in `gaps` and are never synthesized. Cite as 'observed at <time>'. Optional args: days (1-90, default 30), notional_usd (default 10000), fee_bps (default 5). Never trades, never writes.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"days": {
"description": "Lookback in days for the rollup, 1..90 (default 30).",
"maximum": 90,
"minimum": 1,
"type": "number"
},
"fee_bps": {
"description": "Round-trip fee assumption in basis points, 0..100 (default 5).",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"notional_usd": {
"description": "Notional in USD used to price the carry board and the fee drag, > 0 (default 10000).",
"minimum": 1,
"type": "number"
}
},
"type": "object"
},
"name": "get_insights",
"outputSchema": null
},
{
"description": "READ-ONLY: list the user's connected CEX venues (id, exchange slug, label, status, markets) so follow-up reads can target a connectionId. `markets` is spot|futures|both as verified at save (Kraken dual keys; KuCoin/Bitget futures scope) — a row with markets=both covers perpetuals, so prefer it for positions reads. Returns metadata only, never keys or secrets. Call this first when the user asks about positions, balances, or anything per-exchange.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_connections",
"outputSchema": null
},
{
"description": "READ-ONLY: list recent execution fills on a CEX connection (individual order executions with price/qty/fee, spot + futures). Never moves funds, never writes Diary rows — fills are Activity history (see read_closed_pnl for realized PnL). Unimplemented venues return an empty list; a venue walk that exceeds its time budget fails loud, never truncated-as-empty.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"connectionId": {
"description": "CEX connection id (see list_connections). Takes precedence over exchange.",
"type": "string"
},
"days": {
"description": "Lookback in days, 1..90 (default 30)",
"type": "number"
},
"exchange": {
"description": "CEX slug, e.g. kucoin (resolved to an active connection; connectionId wins when both are given)",
"type": "string"
},
"limit": {
"description": "Max rows, newest-first, 1..500 (default 100)",
"type": "number"
},
"market": {
"description": "Which fills to read (default all)",
"enum": [
"spot",
"futures",
"all"
],
"type": "string"
},
"pair": {
"description": "Optional filter, e.g. BTC/USDT",
"type": "string"
}
},
"type": "object"
},
"name": "list_fills",
"outputSchema": null
},
{
"description": "READ-ONLY: resting open orders across the user's CEX connections (spot + futures) — the same per-venue envelope as agent-chat kind=open_orders ({kind, observedAt, venues:[{connectionId, exchange, label, ok, orders, count}]}). Narrow with exchange and/or connectionId, filter one market with pair; omit all three to fan out across every active connection. An empty book reads as no resting orders, never as a flat position.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"connectionId": {
"description": "CEX connection id (see list_connections). Takes precedence over exchange. Omit to read every active connection.",
"type": "string"
},
"exchange": {
"description": "CEX slug, e.g. kucoin (resolved to active connection(s); connectionId wins when both are given). Omit to read every active connection.",
"type": "string"
},
"pair": {
"description": "Optional filter, e.g. BTC/USDT",
"type": "string"
}
},
"type": "object"
},
"name": "list_open_orders",
"outputSchema": null
},
{
"description": "APPROVAL CARD ONLY — NEVER auto-executed: propose one atomic bracket (entry + protective stop + 1–3 OCO take-profits) for in-app approval. Recorded as a proposed setup row (Diary → setups → Send to ticket). Never executes, never moves funds. Needs the trade:propose scope (PAT).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"amount": {
"description": "Base amount, e.g. 0.05. Must be > 0.",
"type": "string"
},
"entry_price": {
"description": "Required when entry_type=limit. Must be > 0.",
"type": "number"
},
"entry_type": {
"description": "market = fill now; limit = resting entry at entry_price",
"enum": [
"market",
"limit"
],
"type": "string"
},
"exchange": {
"description": "CEX slug, e.g. kucoin",
"type": "string"
},
"fee_usd": {
"description": "All-in fee in USD. Omit or null if unknown — never 0-substituted.",
"type": "number"
},
"pair": {
"description": "e.g. BTC/USDT",
"type": "string"
},
"rationale": {
"description": "One-sentence why-now",
"type": "string"
},
"side": {
"description": "buy = long, sell = short",
"enum": [
"buy",
"sell",
"long",
"short"
],
"type": "string"
},
"stop_price": {
"description": "Protective stop. Long: below entry; short: above. Must be > 0.",
"type": "number"
},
"take_profits": {
"description": "1–3 take-profit legs {price > 0, weight (or fraction) 0..1 of position}. Weights should sum to ~1.",
"type": "array"
}
},
"required": [
"exchange",
"pair",
"side",
"entry_type",
"amount",
"stop_price",
"take_profits",
"rationale"
],
"type": "object"
},
"name": "propose_bracket",
"outputSchema": null
},
{
"description": "APPROVAL CARD ONLY — NEVER auto-executed: propose flattening EVERY open position at once (or one venue/pair scope) for in-app approval. Records the proposal only — no order is placed, nothing is cancelled. Needs the trade:propose scope (PAT).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"exchange": {
"description": "Optional CEX slug to flatten one venue only. Omit for every connected venue.",
"type": "string"
},
"limit_price": {
"description": "Required for order_type=limit.",
"type": "string"
},
"order_type": {
"description": "Default market.",
"enum": [
"market",
"limit"
],
"type": "string"
},
"pair": {
"description": "Optional pair filter (e.g. BTC/USDT) — flatten only this market. Omit for everything.",
"type": "string"
},
"rationale": {
"description": "Why flatten now",
"type": "string"
}
},
"required": [
"rationale"
],
"type": "object"
},
"name": "propose_close_all_positions",
"outputSchema": null
},
{
"description": "Append (default) or replace a markdown note on one diary day (diary_day_notes upsert — the same append/replace write the agent-chat approval path and daily_prep perform). Diary-only: never executes a trade, never moves funds. Needs the trade:propose scope (PAT).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"body_md": {
"description": "Markdown note content, 1..4000 chars (longer bodies are cut)",
"type": "string"
},
"day": {
"description": "Day in YYYY-MM-DD format (default today UTC)",
"type": "string"
},
"mode": {
"description": "append (default) or replace the day's note",
"enum": [
"append",
"replace"
],
"type": "string"
}
},
"required": [
"body_md"
],
"type": "object"
},
"name": "propose_diary_note",
"outputSchema": null
},
{
"description": "APPROVAL CARD ONLY — NEVER auto-executed: propose a prediction-market trade for in-app approval. JEV-gated: pass the consult_jev family=prediction verdict (run analyze_market first) — a call without one is refused. Recorded as a proposal trail row. Never executes, never moves funds. Needs the trade:propose scope (PAT).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"amount": {
"description": "Optional pUSD amount to spend (must be > 0 when provided)",
"type": "number"
},
"confidence": {
"description": "Optional agreement-weighted conviction 0–1",
"type": "number"
},
"jev_verdict": {
"description": "The consult_jev family=prediction verdict (run analyze_market first) — required",
"type": "string"
},
"market_id": {
"description": "Polymarket conditionId or slug, or Opinion market id",
"type": "string"
},
"question": {
"description": "Optional human-readable question, for UI display",
"type": "string"
},
"rationale": {
"description": "Why this market and side now",
"type": "string"
},
"side": {
"description": "Outcome to buy",
"enum": [
"yes",
"no"
],
"type": "string"
},
"venue": {
"description": "Default polymarket (executable). opinion is proposal-only.",
"enum": [
"polymarket",
"opinion"
],
"type": "string"
}
},
"required": [
"market_id",
"side",
"rationale",
"jev_verdict"
],
"type": "object"
},
"name": "propose_predict_market",
"outputSchema": null
},
{
"description": "APPROVAL CARD ONLY — NEVER auto-executed: propose a trade setup for the user to approve in-app (Diary → setups → Send to ticket). Never executes, never moves funds. Needs the trade:propose scope (PAT).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"asset": {
"description": "Base symbol, e.g. BTC",
"type": "string"
},
"entry": {
"description": "Entry price, must be > 0",
"type": "number"
},
"invalidation": {
"description": "Optional invalidation note captured alongside the proposal",
"type": "string"
},
"jev_verdict": {
"description": "Optional caller-supplied JEV verdict captured alongside the proposal",
"type": "string"
},
"kronos_captured_at": {
"description": "Optional ISO timestamp of the Kronos vote",
"type": "string"
},
"kronos_direction": {
"description": "Optional Kronos oracle vote direction",
"enum": [
"up",
"down",
"flat"
],
"type": "string"
},
"kronos_expected_move_pct": {
"description": "Optional Kronos expected move in percent",
"type": "number"
},
"kronos_horizon": {
"description": "Optional Kronos horizon (positive integer)",
"type": "number"
},
"pair": {
"description": "e.g. BTC/USDT",
"type": "string"
},
"side": {
"description": "Side to propose: buy|sell (long|short accepted as aliases, normalized to buy|sell)",
"enum": [
"buy",
"sell",
"long",
"short"
],
"type": "string"
},
"size_usd": {
"description": "Suggested size in USD, must be > 0",
"type": "number"
},
"stop": {
"description": "Stop-loss price, must be > 0",
"type": "number"
},
"thesis": {
"description": "One-paragraph rationale",
"type": "string"
},
"timeframe": {
"description": "e.g. 4h",
"type": "string"
},
"venue": {
"description": "CEX slug or perps venue",
"type": "string"
}
},
"required": [
"pair",
"side",
"entry",
"stop"
],
"type": "object"
},
"name": "propose_trade",
"outputSchema": null
},
{
"description": "APPROVAL CARD ONLY — NEVER auto-executed: propose 1–3 personalized trade opportunities (best-first) for in-app approval. Each idea is recorded as a proposed setup row (Diary → setups → Send to ticket) plus one batch trail row. Never executes, never moves funds. Needs the trade:propose scope (PAT).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"ideas": {
"description": "1–3 trade ideas, best-first. Each: pair (e.g. BTC/USDT), side buy|sell (long|short accepted as aliases), entry > 0, stop > 0 (long: stop<entry, short: stop>entry), targets 1–3x {price>0, weight (or fraction) 0..1}, thesis (required).",
"type": "array"
},
"jev_verdict": {
"description": "Optional caller-supplied JEV verdict captured alongside the batch (run analyze_market first for a fresh one)",
"type": "string"
},
"rationale": {
"description": "One-sentence why-now for the batch",
"type": "string"
}
},
"required": [
"ideas",
"rationale"
],
"type": "object"
},
"name": "propose_trade_ideas",
"outputSchema": null
},
{
"description": "READ-ONLY: realized/closed-PnL history on a CEX connection (one row per closed position carrying net pnl + fees, for diary sync). Never moves funds. Rows whose venue reports no side stay null — side is never inferred from the PnL sign; Binance rows carry entryPrice 0 = unknown (the income feed has no entry price) and exitPrice is the paired closing fill when one was found.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"connectionId": {
"description": "CEX connection id (see list_connections). Takes precedence over exchange.",
"type": "string"
},
"days": {
"description": "Lookback in days, 1..90 (default 30)",
"type": "number"
},
"exchange": {
"description": "CEX slug, e.g. kucoin (resolved to an active connection; connectionId wins when both are given)",
"type": "string"
},
"limit": {
"description": "Max rows, newest-first, 1..500 (default 100)",
"type": "number"
},
"pair": {
"description": "Optional filter, e.g. BTC/USDT",
"type": "string"
}
},
"type": "object"
},
"name": "read_closed_pnl",
"outputSchema": null
},
{
"description": "READ-ONLY: read one diary day (trades, setups, analyses, actions) or an explicit day RANGE. Never writes — saving a note stays a propose_diary_note approval card. Pass an explicit day (YYYY-MM-DD) or an explicit start_day + end_day range (inclusive, max 31 days) — there is no today default, so ask the user when no day is given. Returns the most recent rows first with totals; quote it as observed diary state, not a live venue read.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"day": {
"description": "One day in YYYY-MM-DD format (required when no range is given; no default — ask the user).",
"type": "string"
},
"end_day": {
"description": "Range end in YYYY-MM-DD format, inclusive. Requires start_day; the range caps at 31 days.",
"type": "string"
},
"start_day": {
"description": "Range start in YYYY-MM-DD format, inclusive. Requires end_day; the range caps at 31 days.",
"type": "string"
}
},
"type": "object"
},
"name": "read_diary_day",
"outputSchema": null
},
{
"description": "READ-ONLY: fetch ONE specific live datum on demand (open positions, account balances, or a market quote) instead of waiting for the context snapshot. Never moves funds, never places an order, never widens the context on its own — ask for exactly the datum you need. Returns numbers WITH the venue and a fetch timestamp; report them as 'observed at <time> on <venue>'. If the result has no fetched number, say the value is unavailable — NEVER invent a placeholder. Present positions/balances/order reads as an inline markdown table in your reply text (never 'shown above'); when empty, say 'No open positions' explicitly. Not for writing anything; use a propose_* tool when the user wants an action.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"category": {
"description": "Optional market scope for kind=order|open_orders: spot|linear. Omit to search both on perp venues.",
"type": "string"
},
"chains": {
"description": "Optional comma list to filter kind=onchain, e.g. ethereum,solana.",
"type": "string"
},
"connectionId": {
"description": "CEX connection id for positions|balances|open_orders (see list_connections). Omit to read every active connection. REQUIRED for kind=order (an order id is connection-scoped).",
"type": "string"
},
"exchange": {
"description": "Venue slug for kind=market and kind=screener (e.g. binance). For positions|balances|open_orders, narrows to one venue; omit to read every connection.",
"type": "string"
},
"kind": {
"description": "Which datum to read. positions = open derivatives positions with mark/liq/leverage (rows also carry their resting venue-native exit legs as exits[] with TP/SL triggers across all CEX venues, or exitsUnknown:true when the stops book could not be read — quote those, never invent exits). balances = per-connection account balances. open_orders = resting OPEN orders across connections (optional connectionId/exchange narrow, optional symbol pair filter + category spot|linear; empty list means no resting orders, never a flat position). market = a live quote for one symbol. screener = top-by-volume 24h movers on one CEX (pass exchange=<exchange slug>, e.g. binance). onchain = wallet balances across the user's server-resolved wallets (addresses only, never keys; optional chains=<csv> filter, e.g. ethereum,solana). order = ONE order's status by venue order id (open|filled|unknown with observedAt; needs connectionId + orderId, optional symbol + category spot|linear). predictions = prediction-market reads across Polymarket + Opinion (default scope=markets: the most liquid open markets with yes/no prices, volume, liquidity, endDate, conditionId; scope=positions|orders reads the user's wallet-scoped positions and resting orders on both venues; scope=quote returns a live quote for one market/token: Polymarket orderbook + tick-size + taker-delay, Opinion latest price + quote tokens). The first leg of any prediction hunt is scope=markets; price before proposing from scope=quote.",
"enum": [
"positions",
"balances",
"open_orders",
"market",
"screener",
"onchain",
"order",
"predictions"
],
"type": "string"
},
"market_id": {
"description": "Prediction market selector for kind=predictions scope=orders|quote (and to narrow positions): Polymarket conditionId (0x…), slug, or numeric id; Opinion market id.",
"type": "string"
},
"orderId": {
"description": "Venue order id for kind=order (e.g. the orderId a placeOrder/YOLO fill returned).",
"type": "string"
},
"scope": {
"description": "Prediction read scope for kind=predictions (default markets). markets = liquid open markets scan; positions = the user's open prediction positions (wallet-scoped, needs connected creds or wallets=); orders = resting prediction orders; quote = live quote for one market (needs market_id and/or token_id).",
"enum": [
"markets",
"positions",
"orders",
"quote"
],
"type": "string"
},
"status": {
"description": "Optional position-status filter for kind=predictions scope=positions: OPEN|REDEEMABLE|REDEEMABLE_LOST|CLOSED|MERGEABLE (default OPEN, Polymarket; Opinion returns its open positions).",
"type": "string"
},
"symbol": {
"description": "Required for kind=market (e.g. BTC/USDT). Optional pair filter for kind=open_orders (e.g. BTC/USDT narrows the resting book).",
"type": "string"
},
"tag": {
"description": "Optional tag pill to filter kind=predictions scope=markets: politics|crypto|sports|economy|ai|tech (Polymarket tag_slug; Opinion matches its category labels best-effort). Omit for the most liquid open markets overall.",
"type": "string"
},
"token_id": {
"description": "Outcome token id for kind=predictions scope=quote: Polymarket CTF clobTokenId (orderbook + tick-size + taker-delay) or Opinion token id (latest price).",
"type": "string"
},
"venue": {
"description": "Prediction venue for kind=predictions: polymarket|opinion|all. Scan (scope=markets) defaults to polymarket; positions|orders read both venues unless narrowed; quote defaults to polymarket unless the token/market id is Opinion-shaped.",
"type": "string"
},
"wallets": {
"description": "Optional csv of 0x wallet addresses for kind=predictions scope=positions (merged with the stored Polymarket funder; capped at 10). Omit to read the connected wallets only.",
"type": "string"
},
"withExits": {
"description": "Accepted for backward compatibility (older CLI versions send it): positions reads always carry their resting venue-native exit legs as exits[] with TP/SL triggers across all CEX venues, or exitsUnknown:true when the stops book could not be read. Other venues ignore it.",
"type": "boolean"
}
},
"required": [
"kind"
],
"type": "object"
},
"name": "read_live_datum",
"outputSchema": null
},
{
"description": "READ-ONLY: fetch the latest crypto headlines as keyword-matched news clusters for fundamentals analysis (ETF flows, unlocks, macro, hacks — read the headlines here, act through a propose_* tool). Optional pair (BTC, ETH, or SOL — also accepts BTC/USDT or BTC-USD forms) narrows to that asset's keywords; omit it for all three. Returns the top clusters newest-first with per-item source links and recency (publishedAt + ageHrs) plus a fetch timestamp; quote them as 'observed at <time> from <source>'. If no headlines match, say so — NEVER invent a headline.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "Max items kept per asset cluster, 1..12 (default 6).",
"type": "integer"
},
"pair": {
"description": "Optional asset filter: BTC, ETH, or SOL (BTC/USDT and BTC-USD forms accepted). Omit for all three.",
"type": "string"
},
"source": {
"description": "optional publisher filter, free text (e.g. CoinDesk); omit for every publisher",
"type": "string"
},
"window_hrs": {
"description": "Harvest window in hours, 1..168 (default 48).",
"type": "number"
}
},
"required": [],
"type": "object"
},
"name": "read_news_brief",
"outputSchema": null
},
{
"description": "DEPRECATED — use read_live_datum kind=onchain: this alias runs the exact same reader and returns the same shape, and it stays only for older CLI versions. Read-only onchain wallet balances across EVM/Solana/TON/Tron/BTC via the balance cache + public RPCs. Server resolves the user's wallet addresses itself (addresses only, never keys). The chains filter uses canonical slugs and matches non-EVM chains exactly — `sol` never matches `solana`, `bitcoin` reads as `btc`; one linked EVM address is readable on any requested EVM chain. TON matches by chain slug, not address form — raw (0:…), bounceable (EQ…) and non-bounceable (UQ…) versions of one wallet resolve to the same balance. Every linked wallet and every requested chain gets an explicit row in `reads` (ok | empty | invalid-address | no-wallet): lowercased Solana/Tron rows surface as invalid-address with a re-link hint instead of vanishing.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"chains": {
"description": "Optional comma list of canonical chain slugs, e.g. ethereum,solana. Non-EVM slugs (solana, ton, tron, btc) match exactly — no aliases or substrings; ton covers every TON address version. EVM slugs expand: one linked EVM address reads on any requested EVM chain.",
"type": "string"
}
},
"type": "object"
},
"name": "read_onchain_balances",
"outputSchema": null
},
{
"description": "READ-ONLY: read the user's risk posture (kill switch, autonomy level, caps, daily usage). Never edits limits — the agent must check this before proposing live size.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "read_risk_limits",
"outputSchema": null
},
{
"description": "READ-ONLY: venue-held funds per linked wallet address — Hyperliquid (mode-aware total), Aster (keyless per-asset), dYdX (subaccount equity), Pacifica (account by Solana address), Polymarket (spendable pUSD + positions value). Reads are public and keyless against the EXPLICIT owner address (never an agent address); each row names the address it read. A failed venue nulls its leg — never a coerced 0. Omit venue to read every linked venue; totalUsd sums the legs that answered and partial:true names every leg that did not.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"venue": {
"description": "Venue to read: dydx|hyperliquid|polymarket|aster|pacifica, or all (default). `hl` is accepted as an alias of hyperliquid. One row per venue per linked address; totalUsd sums the legs that answered.",
"enum": [
"dydx",
"hyperliquid",
"polymarket",
"aster",
"pacifica",
"hl",
"all"
],
"type": "string"
}
},
"type": "object"
},
"name": "read_venue_balances",
"outputSchema": null
},
{
"description": "Counts the venue's realized LOSSES against the daily risk counters. A trade closed by the VENUE's own stop never goes through the close path, so without this the daily loss cap can never fire on it. Idempotent: each venue trade is counted exactly once, tracked in the realized-PnL ledger. Never moves funds, never places an order. Returns how many trades were counted, the loss recorded, and what was skipped and why.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"connectionId": {
"description": "CEX connection id (see list_connections). Takes precedence over exchange.",
"type": "string"
},
"days": {
"description": "How far back to reconcile, in days, 1..30 (default 2)",
"type": "number"
},
"exchange": {
"description": "CEX slug, e.g. kucoin (resolved to an active connection; connectionId wins when both are given)",
"type": "string"
}
},
"type": "object"
},
"name": "reconcile_realized_pnl",
"outputSchema": null
},
{
"description": "KuCoin reserve sweep (real money on live fire): keeps `keep` units of `currency` in the futures wallet and moves the excess futures -> main -> trade in two legs carrying the same amount. Dry-run by default (plan only, zero bytes to the venue, no YOLO gate). Live fire (dryRun:false) needs the trade:execute scope AND user YOLO eligibility (kill switch off, autonomy != propose_only) — a sweep moves funds, so it mirrors transferReserve and stays gated while exits and cancels never are. KuCoin only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"connectionId": {
"description": "CEX connection id (see list_connections). Takes precedence over exchange.",
"type": "string"
},
"currency": {
"description": "Settlement asset to sweep: USDT, USDC, BTC or ETH (XBT accepted as BTC; default USDT)",
"type": "string"
},
"dryRun": {
"description": "Plan only, moves nothing (default true). Pass false to fire both transfer legs.",
"type": "boolean"
},
"exchange": {
"description": "CEX slug — kucoin only (resolved to an active connection; connectionId wins when both are given)",
"type": "string"
},
"keep": {
"description": "Units of currency to leave in futures (default 10)",
"type": "number"
}
},
"required": [
"exchange"
],
"type": "object"
},
"name": "reserve_sweep",
"outputSchema": null
},
{
"description": "Arm or replace venue-native SL and/or TP on an open CEX position. Spot legs work on every venue; a LINEAR (futures) leg only on binance, bybit, okx, kucoin, gateio, bitget, bingx and kraken — mexc and coinbase have no linear exit path and refuse one. Clears existing stops on the pair and arms the new legs sized against the live position. Needs the trade:execute scope AND the per-call kill-switch/autonomy check (kill switch off and autonomy != propose_only). set_exits is NOT a D4-relaxed exit yet: the exit-leg builder still ignores the account's position mode, so on a hedge or long-short account it cannot prove a leg is a close rather than an open. close_position and cancel_order are the tools that pass a tripped switch; this one stays gated until the builder fix ships.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"connectionId": {
"description": "CEX connection id (see list_connections). Takes precedence over exchange.",
"type": "string"
},
"exchange": {
"description": "CEX slug, e.g. binance, bybit, okx, kucoin, gateio, mexc, bitget, bingx, coinbase, kraken",
"type": "string"
},
"market": {
"description": "Which market the open position is on (default futures). Spot needs quantity.",
"enum": [
"spot",
"futures"
],
"type": "string"
},
"pair": {
"description": "e.g. BTC/USDT",
"type": "string"
},
"quantity": {
"description": "Spot only: position size in base units (the venue reports no spot position to size against)",
"type": "number"
},
"referencePrice": {
"description": "The price the stop and take-profit were DERIVED FROM. The server rebases both legs onto the position's ACTUAL entry price, keeping their distances, so a fill that came in better than the reference cannot leave a take-profit on the wrong side of the entry (where its trigger is already satisfied and it would close the position instantly for a fee).",
"type": "number"
},
"slPrice": {
"description": "Stop-loss trigger. Must sit on the loss side of the entry (long: below, short: above).",
"type": "number"
},
"tpPrice": {
"description": "Take-profit trigger. Must sit on the profit side of the entry (long: above, short: below).",
"type": "number"
}
},
"required": [
"exchange",
"pair"
],
"type": "object"
},
"name": "set_exits",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:ea6400beb9092fd4684df37c45812fb968aff3914265a7d14a13576202564717 | sha256sum