{"id":"trade.rubin/exchange","slug":"trade-rubin-exchange","title":"Rubin Exchange","description":"Rubin: self-custody DEX for crypto perpetuals & spot - trade, read positions, orders, balances.","version":"1.0.2","publisher":{"kind":"domain","id":"rubin.trade","label":"rubin.trade","url":"https://rubin.trade"},"website":"https://code.rubin.trade/ai","repository":"https://github.com/rubin-trade/rubin-mainnet-mcp","remotes":[{"type":"streamable-http","url":"https://mcp.mainnet.rubin.trade/mcp","headers":[{"description":"Bearer MCP token - mint one on the Rubin exchange at rubin.trade (Trading Keys -> MCP Token).","isRequired":true,"isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-06-22","updated":"2026-06-22","status":"online","auth":"","latency_ms":1240,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"whoami","title":"Describe this session","description":"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.","read_only":true},{"name":"get_block_height","title":"Get latest block height","description":"Return the latest chain block height. Useful for SHORT_TERM order goodTilBlock math.","read_only":true},{"name":"list_markets","title":"List perpetual markets","description":"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":true},{"name":"get_market","title":"Get a perpetual market","description":"Get details for one perpetual market (clobPairId, atomicResolution, quantumConversionExponent, tick/step sizes, oracle price, status).","read_only":true},{"name":"get_orderbook","title":"Get orderbook","description":"Get the live orderbook (bids/asks) for a market, optionally truncated to a depth.","read_only":true},{"name":"get_candles","title":"Get candles (OHLCV)","description":"Get OHLCV candles for a market at a given resolution. Useful for trend/volatility analysis.","read_only":true},{"name":"get_candles_multi","title":"Get multi-timeframe candles","description":"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":true},{"name":"get_balance","title":"Get balances","description":"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 ga","read_only":true},{"name":"get_equity","title":"Get account summary","description":"Get the subaccount summary: equity, freeCollateral, marginEnabled, open perpetual positions and asset positions.","read_only":true},{"name":"get_positions","title":"Get perpetual positions","description":"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":true},{"name":"get_open_orders","title":"Get open orders","description":"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 posit","read_only":true},{"name":"get_portfolio","title":"Get full portfolio","description":"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":true},{"name":"get_position_risk","title":"Get position risk","description":"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":true},{"name":"get_fills","title":"Get fills (trade history)","description":"Get executed fills for the subaccount, including price, size, fee and maker/taker liquidity.","read_only":true},{"name":"get_pnl","title":"Get historical PnL","description":"Get historical PnL ticks for the subaccount (equity, totalPnl, netTransfers over time). Use createdOnOrAfter to bound the range.","read_only":true},{"name":"get_funding_status","title":"Wallet vs trading-account funds","description":"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","read_only":true},{"name":"deposit_to_subaccount","title":"Move wallet USDC into the trading account","description":"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","read_only":false},{"name":"top_up_gas","title":"Restore the wallet gas reserve","description":"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.","read_only":false},{"name":"place_limit_order","title":"Place a limit order","description":"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_fil","read_only":false},{"name":"place_market_order","title":"Place a market order","description":"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 / pa","read_only":false},{"name":"cancel_order","title":"Cancel an order","description":"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.","read_only":false},{"name":"cancel_all_orders","title":"Cancel all orders in a market","description":"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.","read_only":false},{"name":"batch_cancel","title":"Batch cancel short-term orders","description":"Cancel multiple SHORT_TERM orders in one tx. SHORT_TERM only (chain limitation) — for stateful/mixed use cancel_all_orders.","read_only":false},{"name":"place_stop_loss","title":"Stop loss","description":"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.","read_only":false},{"name":"place_take_profit","title":"Take profit","description":"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.","read_only":false},{"name":"close_position","title":"Close a position","description":"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 ","read_only":false},{"name":"close_all_positions","title":"Close all positions","description":"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.","read_only":false},{"name":"open_position","title":"Open a position (market entry + optional bracket)","description":"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). slippag","read_only":false},{"name":"get_news","title":"Get latest news","description":"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 importanc","read_only":true},{"name":"get_leaderboard","title":"PnL leaderboard","description":"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":true},{"name":"get_my_rank","title":"My leaderboard rank","description":"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":true},{"name":"get_fee_tier","title":"My fee tier","description":"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":true},{"name":"get_referral_program","title":"My referral (affiliate) program","description":"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":true}],"server_info":{"name":"ritbit-mcp","version":"0.2.0"},"category":"ecommerce","tags":["crypto","news","sales"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-06-22","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/trade-rubin-exchange/"}