MCP Server

Rubin Exchange

trade.rubin/exchange
Crypto & Web3 Finance & Investing Public & reachable MCP 2025-11-25

What this MCP does

Provides self-custody crypto spot and perpetual trading on Rubin, including market data, balances, positions, orders, risk, portfolio, and trade execution.

batch_cancel
Batch cancel short-term orders
Cancel multiple SHORT_TERM orders in one tx. SHORT_TERM only (chain limitation) — for stateful/mixed use cancel_all_orders.
Destructive Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['market', 'clientIds'], 'properties': {'market': {'type': 'string'}, 'clientIds': {'type': 'array', 'items': {'type': 'integer', 'minimum': 0}, 'maxItems': 100, 'minItems': 1}}, 'additionalProperties': False}
cancel_all_orders
Cancel all orders in a market
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 Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['market'], 'properties': {'market': {'type': 'string'}, 'confirm': {'type': 'boolean', 'description': 'After canceling, verify no orders remain OPEN via the indexer (default true).'}}, 'additionalProperties': False}
cancel_order
Cancel an 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 Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['market', 'clientId', 'orderFlags'], 'properties': {'market': {'type': 'string'}, '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
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.
Input schema
{'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 a 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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['market'], 'properties': {'market': {'type': 'string', '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
Move wallet USDC into the trading account
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.
Input schema
{'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 balances
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
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_block_height
Get latest block height
Return the latest chain block height. Useful for SHORT_TERM order goodTilBlock math.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_candles
Get candles (OHLCV)
Get OHLCV candles for a market at a given resolution. Useful for trend/volatility analysis.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['market', 'resolution'], 'properties': {'limit': {'type': 'integer', 'maximum': 1000, 'exclusiveMinimum': 0}, 'toISO': {'type': 'string', 'description': 'ISO 8601 end time'}, 'market': {'type': 'string', 'description': 'Market ticker, e.g. BTC-USD'}, 'fromISO': {'type': 'string', '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 multi-timeframe candles
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
Input schema
{'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', '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 account summary
Get the subaccount summary: equity, freeCollateral, marginEnabled, open perpetual positions and asset positions.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_fee_tier
My 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
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_fills
Get fills (trade history)
Get executed fills for the subaccount, including price, size, fee and maker/taker liquidity.
Read only
Input schema
{'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', 'description': 'Market ticker filter, e.g. BTC-USD'}}, 'additionalProperties': False}
get_funding_status
Wallet vs trading-account funds
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
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_leaderboard
PnL 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
Input schema
{'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 a perpetual market
Get details for one perpetual market (clobPairId, atomicResolution, quantumConversionExponent, tick/step sizes, oracle price, status).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['market'], 'properties': {'market': {'type': 'string', 'description': 'Market ticker, e.g. BTC-USD'}}, 'additionalProperties': False}
get_my_rank
My leaderboard 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
Input schema
{'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
Get latest 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
Input schema
{'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 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
Input schema
{'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', 'description': 'Market ticker filter, e.g. BTC-USD'}}, 'additionalProperties': False}
get_orderbook
Get orderbook
Get the live orderbook (bids/asks) for a market, optionally truncated to a depth.
Read only
Input schema
{'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', 'description': 'Market ticker, e.g. BTC-USD'}}, 'additionalProperties': False}
get_pnl
Get historical PnL
Get historical PnL ticks for the subaccount (equity, totalPnl, netTransfers over time). Use createdOnOrAfter to bound the range.
Read only
Input schema
{'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', 'description': 'ISO 8601 lower bound'}}, 'additionalProperties': False}
get_portfolio
Get full 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
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_position_risk
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
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_positions
Get perpetual 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
Input schema
{'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
My referral (affiliate) 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
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
list_markets
List perpetual 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
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
open_position
Open a position (market entry + optional bracket)
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['market', 'side'], 'properties': {'side': {'enum': ['BUY', 'SELL'], 'type': 'string'}, 'size': {'type': 'number', 'description': 'Position size in base units.', 'exclusiveMinimum': 0}, 'market': {'type': 'string', 'description': 'Market ticker, e.g. BTC-USD'}, 'confirm': {'type': 'boolean'}, 'notionalUsd': {'type': 'number', 'description': 'Position size in quote USD (converted at oracle). Use instead of size.', 'exclusiveMinimum': 0}, 'slippageBps': {'type': 'number', 'maximum': 10000, 'minimum': 0, 'description': 'Max slippage vs oracle for the entry, in bps (default 500).'}, 'stopLossPrice': {'type': 'number', 'description': 'Attach a reduce-only stop-loss trigger at this price.', 'exclusiveMinimum': 0}, 'takeProfitPrice': {'type': 'number', 'description': 'Attach a reduce-only take-profit trigger at this price.', 'exclusiveMinimum': 0}}, 'additionalProperties': False}
place_limit_order
Place a 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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['market', 'side', 'price', 'size'], 'properties': {'side': {'enum': ['BUY', 'SELL'], 'type': 'string'}, 'size': {'type': 'number', 'description': 'Size in base units', 'exclusiveMinimum': 0}, 'price': {'type': 'number', 'exclusiveMinimum': 0}, 'market': {'type': 'string', 'description': 'Market ticker, e.g. BTC-USD'}, 'confirm': {'type': 'boolean', 'description': 'Verify the real outcome via the indexer after broadcast (default true).'}, 'clientId': {'type': 'integer', 'minimum': 0}, 'postOnly': {'type': 'boolean', 'description': 'Reject if it would cross (maker-only). Defaults to server config.'}, 'reduceOnly': {'type': 'boolean'}, 'timeInForce': {'enum': ['GTT', 'SHORT_TERM'], 'type': 'string', 'default': 'GTT'}, 'goodTilBlockOffset': {'type': 'integer', 'maximum': 19, 'minimum': 1, 'description': 'SHORT_TERM blocks ahead (default 10)'}, 'goodTilTimeSeconds': {'type': 'integer', 'maximum': 7776000, 'description': 'GTT lifetime (default 3600)', 'exclusiveMinimum': 0}}, 'additionalProperties': False}
place_market_order
Place a 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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['market', 'side', 'size'], 'properties': {'side': {'enum': ['BUY', 'SELL'], 'type': 'string'}, 'size': {'type': 'number', 'description': 'Size in base units', 'exclusiveMinimum': 0}, 'market': {'type': 'string', 'description': 'Market ticker, e.g. BTC-USD'}, 'confirm': {'type': 'boolean', 'description': 'Verify the real fill via the indexer after broadcast (default true).'}, 'clientId': {'type': 'integer', 'minimum': 0}, 'reduceOnly': {'type': 'boolean'}, 'slippageBps': {'type': 'number', 'maximum': 10000, 'minimum': 0, 'description': 'Max slippage vs oracle, in bps (default 500). BUY bounds above the oracle, SELL below; raise to sweep a thin book.'}}, 'additionalProperties': False}
place_stop_loss
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.
Input schema
{'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'}, '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
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.
Input schema
{'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'}, '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
Restore the wallet gas reserve
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
whoami
Describe this session
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
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Added
get_referral_program
Sept. 17, 2026, 12:55 p.m.
Added
get_fee_tier
Sept. 17, 2026, 12:55 p.m.
Added
get_my_rank
Sept. 17, 2026, 12:55 p.m.
Added
get_leaderboard
Sept. 17, 2026, 12:55 p.m.
Added
get_news
Sept. 17, 2026, 12:55 p.m.
Added
open_position
Sept. 17, 2026, 12:55 p.m.
Added
close_all_positions
Sept. 17, 2026, 12:55 p.m.
Added
close_position
Sept. 17, 2026, 12:55 p.m.
Added
place_take_profit
Sept. 17, 2026, 12:55 p.m.
Added
place_stop_loss
Sept. 17, 2026, 12:55 p.m.
Added
batch_cancel
Sept. 17, 2026, 12:55 p.m.
Added
cancel_all_orders
Sept. 17, 2026, 12:55 p.m.
Added
cancel_order
Sept. 17, 2026, 12:55 p.m.
Added
place_market_order
Sept. 17, 2026, 12:55 p.m.
Added
place_limit_order
Sept. 17, 2026, 12:55 p.m.
Added
top_up_gas
Sept. 17, 2026, 12:55 p.m.
Added
deposit_to_subaccount
Sept. 17, 2026, 12:55 p.m.
Added
get_funding_status
Sept. 17, 2026, 12:55 p.m.
Added
get_pnl
Sept. 17, 2026, 12:55 p.m.
Added
get_fills
Sept. 17, 2026, 12:55 p.m.
Added
get_position_risk
Sept. 17, 2026, 12:55 p.m.
Added
get_portfolio
Sept. 17, 2026, 12:55 p.m.
Added
get_open_orders
Sept. 17, 2026, 12:55 p.m.
Added
get_positions
Sept. 17, 2026, 12:55 p.m.
Added
get_equity
Sept. 17, 2026, 12:55 p.m.
Added
get_balance
Sept. 17, 2026, 12:55 p.m.
Added
get_candles_multi
Sept. 17, 2026, 12:55 p.m.
Added
get_candles
Sept. 17, 2026, 12:55 p.m.
Added
get_orderbook
Sept. 17, 2026, 12:55 p.m.
Added
get_market
Sept. 17, 2026, 12:55 p.m.