Servers Playground How we check Add a server Log in

Rubin Exchange

Working · 2.1 s

trade.rubin/exchangev1.0.2 Domain verified

Rubin: self-custody DEX for crypto perpetuals & spot - trade, read positions, orders, balances.

Crypto & Web3

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.mainnet.rubin.trade/mcp

Authorization (required)

Bearer MCP token - mint one on the Rubin exchange at rubin.trade (Trading Keys -> MCP Token).

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

batch_cancel Destructive

Cancel multiple SHORT_TERM orders in one tx. SHORT_TERM only (chain limitation) — for stateful/mixed use cancel_all_orders.

marketstring, required

clientIdsarray, required

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Rubin Exchange MCP server | mcptry

Tools (33)

batch_cancel

Cancel multiple SHORT_TERM orders in one tx. SHORT_TERM only (chain limitation) — for stateful/mixed use cancel_all_orders.

destructive

Argument	Type	Description
market*	string
clientIds*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "market",
    "clientIds"
  ],
  "properties": {
    "market": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,20}-[A-Z0-9]{1,20}$"
    },
    "clientIds": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0
      },
      "maxItems": 100,
      "minItems": 1
    }
  },
  "additionalProperties": false
}

cancel_all_orders

Cancel every OPEN order for the subaccount in a market (handles SHORT_TERM and LONG_TERM automatically). Returns `confirmation.remainingOpen` — orders still OPEN after the cancel (0 = all gone); if > 0, retry.

destructive

Argument	Type	Description
market*	string
confirm	boolean	After canceling, verify no orders remain OPEN via the indexer (default true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "market"
  ],
  "properties": {
    "market": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,20}-[A-Z0-9]{1,20}$"
    },
    "confirm": {
      "type": "boolean",
      "description": "After canceling, verify no orders remain OPEN via the indexer (default true)."
    }
  },
  "additionalProperties": false
}

cancel_order

Cancel a single order by clientId. For SHORT_TERM pass goodTilBlock; for LONG_TERM/CONDITIONAL pass goodTilTimeSeconds (the original good-til value, available from get_open_orders). Returns `confirmation` with the verified result (canceled / still_open / filled / pending): `code: 0` only means the cancel was broadcast. If `still_open`, the goodTil value likely did not match the original — retry.

destructive

Argument	Type	Description
market*	string
confirm	boolean	Verify the cancel actually took via the indexer (default true).
clientId*	integer
orderFlags*	string
goodTilBlock	integer
goodTilTimeSeconds	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "market",
    "clientId",
    "orderFlags"
  ],
  "properties": {
    "market": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,20}-[A-Z0-9]{1,20}$"
    },
    "confirm": {
      "type": "boolean",
      "description": "Verify the cancel actually took via the indexer (default true)."
    },
    "clientId": {
      "type": "integer",
      "minimum": 0
    },
    "orderFlags": {
      "enum": [
        "SHORT_TERM",
        "LONG_TERM",
        "CONDITIONAL"
      ],
      "type": "string"
    },
    "goodTilBlock": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "goodTilTimeSeconds": {
      "type": "integer",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

close_all_positions

Flatten EVERY open perpetual position with reduce-only MARKET orders (one per market). Respects the operator market allowlist (disallowed markets are skipped and reported). Each close is bounded at oracle ± slippageBps mirrored by side (default 500 bps = 5%). Returns a per-market result array — for any market reporting unfilled/partially_filled, re-run with a larger slippageBps.

Argument	Type	Description
confirm	boolean
slippageBps	number	Max slippage vs oracle, in bps (default 500). Raise to sweep thin books.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "confirm": {
      "type": "boolean"
    },
    "slippageBps": {
      "type": "number",
      "maximum": 10000,
      "minimum": 0,
      "description": "Max slippage vs oracle, in bps (default 500). Raise to sweep thin books."
    }
  },
  "additionalProperties": false
}

close_position

Close all or part of an open perpetual position with a reduce-only MARKET order. Reads the current position, flips the side automatically (LONG→SELL, SHORT→BUY) and sizes the close. percent defaults to 100 (full close); a partial close is floored to the market step size. The close is bounded at oracle ± slippageBps mirrored by side (closing a SHORT buys up to oracle×(1+slip), closing a LONG sells down to oracle×(1−slip); default 500 bps = 5%). Returns the verified `confirmation` outcome — if it is `unfilled` or `partially_filled`, the book was thinner than the cap: re-run with a larger slippageBps to sweep deeper. Errors NOT_FOUND if there is no open position in the market.

Argument	Type	Description
market*	string	Market ticker, e.g. BTC-USD
confirm	boolean
percent	number	Portion of the position to close (default 100).
slippageBps	number	Max slippage vs oracle, in bps (default 500). Raise to sweep a thin book.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "market"
  ],
  "properties": {
    "market": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,20}-[A-Z0-9]{1,20}$",
      "description": "Market ticker, e.g. BTC-USD"
    },
    "confirm": {
      "type": "boolean"
    },
    "percent": {
      "type": "number",
      "maximum": 100,
      "description": "Portion of the position to close (default 100).",
      "exclusiveMinimum": 0
    },
    "slippageBps": {
      "type": "number",
      "maximum": 10000,
      "minimum": 0,
      "description": "Max slippage vs oracle, in bps (default 500). Raise to sweep a thin book."
    }
  },
  "additionalProperties": false
}

deposit_to_subaccount

Deposit USDC from the account's WALLET into its trading SUBACCOUNT so it becomes collateral. Without amountUsd it moves everything above the $0.95 gas reserve (what the web app does); with amountUsd it moves exactly that much, as long as $0.95 stays in the wallet. Funds never leave the account — this is an internal transfer the trading key is allowed to make. Use it when the user has sent money to the account and the subaccount collateral is 0 or too low to trade.

Argument	Type	Description
amountUsd	number	USDC to move. Omit to move everything above the $0.95 gas reserve.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "amountUsd": {
      "type": "number",
      "description": "USDC to move. Omit to move everything above the $0.95 gas reserve.",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

get_balance

Get the subaccount collateral (USDC asset position) and the on-chain wallet bank balances. Collateral is what backs trading; the WALLET balance is where money sent to the account lands and is NOT collateral until deposited. `funding` summarizes it: depositableUsdc (wallet minus the $0.95 gas reserve) and a suggestedAction — deposit_to_subaccount when the wallet holds spare USDC, top_up_gas when gas is low.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_block_height

Return the latest chain block height. Useful for SHORT_TERM order goodTilBlock math.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_candles

Get OHLCV candles for a market at a given resolution. Useful for trend/volatility analysis.

read-only

Argument	Type	Description
limit	integer
toISO	string	ISO 8601 end time
market*	string	Market ticker, e.g. BTC-USD
fromISO	string	ISO 8601 start time
resolution*	string	Candle resolution

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "market",
    "resolution"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "exclusiveMinimum": 0
    },
    "toISO": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?)?(Z|[+-]\\d{2}:?\\d{2})?$",
      "description": "ISO 8601 end time"
    },
    "market": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,20}-[A-Z0-9]{1,20}$",
      "description": "Market ticker, e.g. BTC-USD"
    },
    "fromISO": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?)?(Z|[+-]\\d{2}:?\\d{2})?$",
      "description": "ISO 8601 start time"
    },
    "resolution": {
      "enum": [
        "1MIN",
        "5MINS",
        "15MINS",
        "30MINS",
        "1HOUR",
        "4HOURS",
        "1DAY"
      ],
      "type": "string",
      "description": "Candle resolution"
    }
  },
  "additionalProperties": false
}

get_candles_multi

Get recent OHLCV candles for a market across MULTIPLE resolutions in one call — by default ALL indexer resolutions (1MIN, 5MINS, 15MINS, 30MINS, 1HOUR, 4HOURS, 1DAY) — so the agent can read the trend across timeframes at once. Returns { candles: { <resolution>: [...] } }, newest first. Lower `limit` (e.g. 20) or pass a `resolutions` subset to keep the payload small.

read-only

Argument	Type	Description
limit	integer	Candles per resolution (default 50, most recent).
market*	string	Market ticker, e.g. BTC-USD
resolutions	array	Subset of resolutions (default: all indexer resolutions).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "market"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "description": "Candles per resolution (default 50, most recent).",
      "exclusiveMinimum": 0
    },
    "market": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,20}-[A-Z0-9]{1,20}$",
      "description": "Market ticker, e.g. BTC-USD"
    },
    "resolutions": {
      "type": "array",
      "items": {
        "enum": [
          "1MIN",
          "5MINS",
          "15MINS",
          "30MINS",
          "1HOUR",
          "4HOURS",
          "1DAY"
        ],
        "type": "string"
      },
      "description": "Subset of resolutions (default: all indexer resolutions)."
    }
  },
  "additionalProperties": false
}

get_equity

Get the subaccount summary: equity, freeCollateral, marginEnabled, open perpetual positions and asset positions.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_fee_tier

This account's current trading fee tier and conditions: maker/taker fee (% of notional; a negative maker fee is a rebate), the 30-day maker/taker volume it is judged on, any staking discount, the next tier and how much more 30d volume it takes, plus the full fee-tier table. Referred users start at the program's minimum fee tier (see get_referral_program).

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_fills

Get executed fills for the subaccount, including price, size, fee and maker/taker liquidity.

read-only

Argument	Type	Description
page	integer
limit	integer
market	string	Market ticker filter, e.g. BTC-USD

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "exclusiveMinimum": 0
    },
    "market": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,20}-[A-Z0-9]{1,20}$",
      "description": "Market ticker filter, e.g. BTC-USD"
    }
  },
  "additionalProperties": false
}

get_funding_status

Where the account's USDC sits: in the WALLET (bank balance — money sent to the account lands here and is NOT collateral) vs in the trading SUBACCOUNT (equity / free collateral). Returns depositableUsdc (wallet minus the $0.95 gas reserve), whether gas is low, and a suggestedAction (deposit_to_subaccount / top_up_gas / null). Call this when the user says they sent funds, when collateral reads 0, or before any funding decision.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_leaderboard

The trader PnL leaderboard for a time span (ONE_DAY, SEVEN_DAYS, THIRTY_DAYS, ONE_YEAR, ALL_TIME): rank, username, address, PnL (USD), ROI (%) and current equity per trader, paginated. Also returns `me` — this account's own row on that board, if it is ranked. Use `search` to find a trader by username or address. For this account's rank across ALL time spans at once, use get_my_rank.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1)
limit	integer	Rows per page (default 20, max 100)
search	string	Filter by username or (substring of) address
sortBy	string	RANK (default), PNL, ROI or CURRENT_EQUITY
timeSpan	string	Time span (default SEVEN_DAYS)
sortDirection	string	Sort direction (default: best first)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number, 1-based (default 1)"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Rows per page (default 20, max 100)"
    },
    "search": {
      "type": "string",
      "maxLength": 256,
      "description": "Filter by username or (substring of) address"
    },
    "sortBy": {
      "enum": [
        "RANK",
        "PNL",
        "ROI",
        "CURRENT_EQUITY"
      ],
      "type": "string",
      "description": "RANK (default), PNL, ROI or CURRENT_EQUITY"
    },
    "timeSpan": {
      "enum": [
        "ONE_DAY",
        "SEVEN_DAYS",
        "THIRTY_DAYS",
        "ONE_YEAR",
        "ALL_TIME"
      ],
      "type": "string",
      "description": "Time span (default SEVEN_DAYS)"
    },
    "sortDirection": {
      "enum": [
        "ASC",
        "DESC"
      ],
      "type": "string",
      "description": "Sort direction (default: best first)"
    }
  },
  "additionalProperties": false
}

get_market

Get details for one perpetual market (clobPairId, atomicResolution, quantumConversionExponent, tick/step sizes, oracle price, status).

read-only

Argument	Type	Description
market*	string	Market ticker, e.g. BTC-USD

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "market"
  ],
  "properties": {
    "market": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,20}-[A-Z0-9]{1,20}$",
      "description": "Market ticker, e.g. BTC-USD"
    }
  },
  "additionalProperties": false
}

get_my_rank

Where THIS account ranks on the PnL leaderboard: rank, board size ("21 of 66"), PnL, ROI and equity — for one time span, or for every time span (ONE_DAY … ALL_TIME) when none is given. A null entry means the account is not ranked on that board (no qualifying activity in the window).

read-only

Argument	Type	Description
timeSpan	string	One time span; omit for all five

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "timeSpan": {
      "enum": [
        "ONE_DAY",
        "SEVEN_DAYS",
        "THIRTY_DAYS",
        "ONE_YEAR",
        "ALL_TIME"
      ],
      "type": "string",
      "description": "One time span; omit for all five"
    }
  },
  "additionalProperties": false
}

get_news

Fetch the latest headlines from the ritbit news feed (curated crypto / markets / business channels, newest first). Filter by `category` (crypto|markets|business) or explicit `channels`, and/or a free-text `query` (a ticker or keyword, matched in the post text and hashtags, e.g. BTC). Each item returns { source, url, publishedAt, tags (hashtags — where tickers appear), text }. There is NO importance field: judge impact yourself from the content (hacks, regulation, large moves, ⚠️ warnings). Use this to factor sentiment/catalysts into an assessment, or to answer "what's the latest?". Headlines are ru/en.

read-only

Argument	Type	Description
limit	integer	Max items (default 30).
query	string	Case-insensitive keyword/ticker to match in text or hashtags, e.g. BTC.
category	string	Restrict to one channel category.
channels	array	Explicit hub channel ids (overrides category), e.g. ["forklog","incrypted"].
sinceHours	number	Only items newer than this many hours.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "description": "Max items (default 30).",
      "exclusiveMinimum": 0
    },
    "query": {
      "type": "string",
      "description": "Case-insensitive keyword/ticker to match in text or hashtags, e.g. BTC."
    },
    "category": {
      "enum": [
        "crypto",
        "markets",
        "business"
      ],
      "type": "string",
      "description": "Restrict to one channel category."
    },
    "channels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "Explicit hub channel ids (overrides category), e.g. [\"forklog\",\"incrypted\"]."
    },
    "sinceHours": {
      "type": "number",
      "maximum": 168,
      "description": "Only items newer than this many hours.",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

get_open_orders

Get currently active ORDERS for the subaccount, optionally filtered by market and side. Includes OPEN resting orders and UNTRIGGERED conditional orders (TP/SL accepted on-chain but not yet triggered). Returns { orders: [...] }. This does NOT include filled positions — a filled market/limit order leaves NO open order, it becomes a POSITION (see get_positions). When there are 0 orders but open positions exist, the result carries a `note` pointing you there.

read-only

Argument	Type	Description
side	string
limit	integer
market	string	Market ticker filter, e.g. BTC-USD

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "side": {
      "enum": [
        "BUY",
        "SELL"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "exclusiveMinimum": 0
    },
    "market": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,20}-[A-Z0-9]{1,20}$",
      "description": "Market ticker filter, e.g. BTC-USD"
    }
  },
  "additionalProperties": false
}

get_orderbook

Get the live orderbook (bids/asks) for a market, optionally truncated to a depth.

read-only

Argument	Type	Description
depth	integer	Max levels per side
market*	string	Market ticker, e.g. BTC-USD

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "market"
  ],
  "properties": {
    "depth": {
      "type": "integer",
      "maximum": 100,
      "description": "Max levels per side",
      "exclusiveMinimum": 0
    },
    "market": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,20}-[A-Z0-9]{1,20}$",
      "description": "Market ticker, e.g. BTC-USD"
    }
  },
  "additionalProperties": false
}

get_pnl

Get historical PnL ticks for the subaccount (equity, totalPnl, netTransfers over time). Use createdOnOrAfter to bound the range.

read-only

Argument	Type	Description
page	integer
limit	integer
createdOnOrAfter	string	ISO 8601 lower bound

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "exclusiveMinimum": 0
    },
    "createdOnOrAfter": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?)?(Z|[+-]\\d{2}:?\\d{2})?$",
      "description": "ISO 8601 lower bound"
    }
  },
  "additionalProperties": false
}

get_portfolio

One-call snapshot of everything the account has "open": equity & freeCollateral, every open POSITION (with notional, unrealized PnL and estimated liquidation price), every active ORDER (resting + untriggered TP/SL), and account margin risk. Use this to answer "what do I have open?" or "how am I doing?" without worrying whether the user means orders or positions — it returns both.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_position_risk

Margin health for the subaccount: equity, freeCollateral, total maintenance/initial margin, maintenanceMarginBufferUsd (the EXACT liquidation guard — liquidatable when < 0), marginUsageRatio (1.0 = at liquidation), account leverage, and per-position estimated liquidation price + distance to it. Use before adding risk or to decide whether to protect/close a position.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_positions

Get perpetual POSITIONS with size, side, entryPrice, unrealizedPnl, realizedPnl and netFunding. Defaults to OPEN positions. NOTE: a position is what you HOLD after an order fills — it is NOT an open order. When the user asks loosely "what is open?", check BOTH this and get_open_orders (or call get_portfolio for both at once).

read-only

Argument	Type	Description
status	string	Position status filter

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "status": {
      "enum": [
        "OPEN",
        "CLOSED",
        "LIQUIDATED"
      ],
      "type": "string",
      "description": "Position status filter"
    }
  },
  "additionalProperties": false
}

get_referral_program

This account's referral / affiliate program status: referral code and link, whether the link is unlocked (lifetime volume threshold, or already an affiliate), current affiliate tier and taker-fee share, referred volume (30d / all-time), earnings and referred-user stats, who referred this account, the full affiliate tier table and the program parameters (referee starting fee tier, 30d caps).

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_markets

List all perpetual markets with ticker, status and oracle price. Use this first to discover valid market tickers (e.g. BTC-USD) before placing orders.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

open_position

Enter a NEW position with a MARKET order, sized by base `size` OR quote `notionalUsd` (exactly one required; notionalUsd converts at the oracle price and is floored to the step size). Optionally attach a reduce-only stopLossPrice and/or takeProfitPrice as conditional orders in the SAME call (the bracket, placed with the opposite/closing side and a 500 bps execution bound past the trigger). slippageBps caps the entry fill vs oracle (default 500). Returns the entry `confirmation` plus any bracket order ids. Bracket legs are placed only if the entry broadcast succeeds; each is reduce-only so it can only close, never flip.

Argument	Type	Description
side*	string
size	number	Position size in base units.
market*	string	Market ticker, e.g. BTC-USD
confirm	boolean
notionalUsd	number	Position size in quote USD (converted at oracle). Use instead of size.
slippageBps	number	Max slippage vs oracle for the entry, in bps (default 500).
stopLossPrice	number	Attach a reduce-only stop-loss trigger at this price.
takeProfitPrice	number

place_limit_order

Place a limit order. Default timeInForce=GTT (long-term, durable, broadcast-commit so errors return synchronously). Use SHORT_TERM only for latency-sensitive orders (expire within ~20 blocks, broadcast async). NOTE: stateful (GTT) orders are rate-limited to 2/block and 20 per 100 blocks — pace placements. Returns `confirmation` with the REAL outcome verified via the indexer (filled / partially_filled / resting / unfilled / pending) — broadcast `code: 0` only means the tx was accepted, NOT that it filled. Report from `confirmation.outcome`; if it is `pending`, the indexer is lagging — re-check shortly.

Argument	Type	Description
side*	string
size*	number	Size in base units
price*	number
market*	string	Market ticker, e.g. BTC-USD
confirm	boolean	Verify the real outcome via the indexer after broadcast (default true).
clientId	integer
postOnly	boolean	Reject if it would cross (maker-only). Defaults to server config.
reduceOnly	boolean

place_market_order

Place an IOC market order. It executes as an IOC limit at a worst-acceptable price mirrored around the oracle by side — BUY caps ABOVE the oracle, SELL below — at slippageBps distance (default 500 = 5%). Fills happen at book prices; the cap only limits how deep the sweep goes. reduceOnly closes an existing position. Returns `confirmation` with the REAL outcome verified via the indexer (filled / partially_filled / unfilled / pending): broadcast `code: 0` only means the tx was accepted — an IOC order cancels UNFILLED when the book is entirely beyond the slippage cap (thin/spread market). Always report from `confirmation.outcome`, not `code`; if `unfilled` or `partially_filled`, retry with a larger slippageBps to sweep deeper; if `pending`, the indexer is lagging — wait a few seconds and re-check before concluding.

Argument	Type	Description
side*	string
size*	number	Size in base units
market*	string	Market ticker, e.g. BTC-USD
confirm	boolean	Verify the real fill via the indexer after broadcast (default true).
clientId	integer
reduceOnly	boolean
slippageBps	number	Max slippage vs oracle, in bps (default 500). BUY bounds above the oracle, SELL below; raise to sweep a thin book.

place_stop_loss

Place a reduce-only Stop loss (conditional market order) that triggers at triggerPrice. Side must be the CLOSING side of the position: SELL closes a LONG, BUY closes a SHORT. Once triggered it executes as an IOC limit bounded at triggerPrice ± slippageBps in the direction of execution (BUY above the trigger, SELL below; default 500 bps) so the close can cross the book.

Argument	Type	Description
side*	string
size*	number
market*	string
clientId	integer
slippageBps	number	Execution bound past the trigger, in bps (default 500). Raise for thin books.
triggerPrice*	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "market",
    "side",
    "triggerPrice",
    "size"
  ],
  "properties": {
    "side": {
      "enum": [
        "BUY",
        "SELL"
      ],
      "type": "string"
    },
    "size": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "market": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,20}-[A-Z0-9]{1,20}$"
    },
    "clientId": {
      "type": "integer",
      "minimum": 0
    },
    "slippageBps": {
      "type": "number",
      "maximum": 10000,
      "minimum": 0,
      "description": "Execution bound past the trigger, in bps (default 500). Raise for thin books."
    },
    "triggerPrice": {
      "type": "number",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

place_take_profit

Place a reduce-only Take profit (conditional market order) that triggers at triggerPrice. Side must be the CLOSING side of the position: SELL closes a LONG, BUY closes a SHORT. Once triggered it executes as an IOC limit bounded at triggerPrice ± slippageBps in the direction of execution (BUY above the trigger, SELL below; default 500 bps) so the close can cross the book.

Argument	Type	Description
side*	string
size*	number
market*	string
clientId	integer
slippageBps	number	Execution bound past the trigger, in bps (default 500). Raise for thin books.
triggerPrice*	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "market",
    "side",
    "triggerPrice",
    "size"
  ],
  "properties": {
    "side": {
      "enum": [
        "BUY",
        "SELL"
      ],
      "type": "string"
    },
    "size": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "market": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,20}-[A-Z0-9]{1,20}$"
    },
    "clientId": {
      "type": "integer",
      "minimum": 0
    },
    "slippageBps": {
      "type": "number",
      "maximum": 10000,
      "minimum": 0,
      "description": "Execution bound past the trigger, in bps (default 500). Raise for thin books."
    },
    "triggerPrice": {
      "type": "number",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

top_up_gas

Move a little USDC from the trading subaccount back to the WALLET when the wallet is at or below $0.55 — just enough to restore the $0.95 gas reserve that deposit/withdraw transactions need. Only the gas reserve, only to the account's own wallet; it cannot send funds anywhere else. Use after a transaction fails for lack of gas.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

whoami

Report what this session controls: the master account (its address in BOTH forms — cosmos rit1… and EVM 0x…, the same 20 bytes), the subaccount, whether it can trade or is read-only, and the exact on-chain authorization scope (which messages, which subaccount, and that it CANNOT withdraw/transfer). Also states what this session can NOT do: create wallets, reveal keys/mnemonics, or switch accounts. Call this first, and use it to answer "what is my address?".

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}