Nobitex MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NOBITEX_ENV | No | Target environment: `mainnet` or `testnet`. | mainnet |
| NOBITEX_HOST | No | Host binding for HTTP transport. | 127.0.0.1 |
| NOBITEX_PORT | No | Port binding for HTTP transport. | 8000 |
| NOBITEX_TOKEN | No | User token used for `Authorization: Token <token>` authentication. | |
| NOBITEX_DRY_RUN | No | Paper-trading mode: when `true`, simulates account and trading calls locally. | false |
| NOBITEX_TIMEOUT | No | HTTP timeout in seconds. | 30 |
| NOBITEX_BASE_URL | No | Explicit API base URL. Overrides `NOBITEX_ENV`. | |
| NOBITEX_AUTH_MODE | No | Authentication mode when both credential types are set: `token` or `key`. | auto |
| NOBITEX_READ_ONLY | No | When `true`, blocks all mutating operations. | false |
| NOBITEX_TRANSPORT | No | Transport mode: `stdio`, `sse`, or `streamable-http`. | stdio |
| NOBITEX_PUBLIC_KEY | No | Ed25519 public key, corresponding to the `key` field of an API key. | |
| NOBITEX_USER_AGENT | No | User-Agent sent on every request. | TraderBot/nobitex-mcp-1.0.0 |
| NOBITEX_PRIVATE_KEY | No | Ed25519 private key, URL-safe base64 encoded. | |
| NOBITEX_PAPER_BALANCES | No | Starting paper balances as a JSON object. | {"usdt":"10000","rls":"100000000","btc":"0.5","eth":"5"} |
| NOBITEX_PAPER_FEE_RATE | No | Paper trading fee rate. | 0.001 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Tools for the Nobitex cryptocurrency exchange (Iranian market). Public market-data tools work without credentials. Trading, wallet, withdrawal, address-book, security and API-key tools require NOBITEX_TOKEN or an Ed25519 API key. Use NOBITEX_ENV=testnet (https://testnetapiv2.nobitex.ir) to exercise the agent safely. Monetary values are strings; send amounts and prices as decimal strings. Always confirm the active environment with nobitex_server_info before trading.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| nobitex_server_infoA | Report the active Nobitex environment, base URL and credential status. Call this first to confirm whether the server is pointed at mainnet or testnet and whether trading credentials are configured. |
| nobitex_get_orderbookB | Get the level-2 order book for one market or all markets. Args: symbol: Market symbol such as BTCIRT or BTCUSDT, or "all". |
| nobitex_get_market_depthB | Get aggregated market depth for a single market. Args: symbol: Market symbol such as BTCIRT or BTCUSDT ("all" is not supported). |
| nobitex_get_recent_tradesB | Get the most recent public trades for a single market. Args: symbol: Market symbol such as BTCIRT or BTCUSDT ("all" is not supported). |
| nobitex_get_market_statsB | Get 24h market statistics (price, volume, change) for markets. Args: src_currency: Source currency or comma-separated list, e.g. "btc,eth". dst_currency: Destination currency or comma-separated list, e.g. "rls,usdt". |
| nobitex_get_ohlc_historyB | Get OHLC candle history for a market. Args:
symbol: Market symbol such as BTCIRT or BTCUSDT.
resolution: Candle timeframe: minutes (1,5,15,30,60,180,240,360,720) or days (D,1D,2D,3D).
to: End time as a Unix timestamp in seconds.
from_ts: Start time as a Unix timestamp in seconds.
countback: Number of candles before |
| nobitex_get_system_optionsA | Get exchange system options: currencies, networks, tags and withdrawal limits. |
| nobitex_get_profileA | Get the authenticated user's profile (KYC level, bank accounts, cards). |
| nobitex_get_walletsC | List the user's wallets and balances. Args: type: Optional wallet type filter. |
| nobitex_get_selected_walletsC | List selected wallets, optionally filtered by currencies. Args: currencies: Comma-separated currency list, e.g. "btc,usdt". type: Optional wallet type filter. |
| nobitex_get_wallet_balanceB | Get the balance of one currency wallet. Args: currency: Currency symbol, e.g. "btc" or "rls". |
| nobitex_list_wallet_transactionsC | List transactions for a single wallet. Args: wallet: Wallet id. page: Page number. page_size: Items per page. details: Detail level. |
| nobitex_get_transactions_historyC | Get the user's transaction history across wallets. Args: currency: Optional currency filter. tp: Transaction type list (API-specific string). from_ts: Start time as Unix timestamp (seconds). to_ts: End time as Unix timestamp (seconds). from_id: Minimum transaction id. page: Page number. page_size: Items per page. details: Detail level. download: Request a downloadable export when supported. |
| nobitex_list_depositsC | List crypto deposits. Args: wallet: Optional wallet id; all wallets when omitted. page: Page number. page_size: Items per page. |
| nobitex_get_limitationsB | Get the user's account limitations and verification limits. |
| nobitex_generate_deposit_addressB | Generate a blockchain deposit address. Args: wallet: Spot wallet id. currency: Currency code when wallet is omitted. network: Network name. address_type: Address type, "default" or "legacy". |
| nobitex_add_bank_cardC | Add a bank card to the user's profile. Args: number: Card number. bank: Bank name; defaults to "سایر" on the server. |
| nobitex_add_bank_accountB | Add a bank account (IBAN/SHABA) to the user's profile. Args: shaba: SHABA/IBAN number. number: Optional account number. |
| nobitex_delete_bank_cardC | Delete a bank card by id. |
| nobitex_delete_bank_accountC | Delete a bank account by id. |
| nobitex_list_deposit_addressesA | List generated deposit addresses for a coin/network. Args: network: Network name, e.g. "ETH". coin: Coin symbol, e.g. "eth". ordering: Sort by creation time, newest first by default. is_disabled: true = disabled only, false = active only. search: Substring search on address title. page: Page number. page_size: Items per page. |
| nobitex_generate_deposit_address_v2C | Generate a new deposit address (multi-address API). Args: coin: Coin symbol. network: Network name. title: Optional address title. |
| nobitex_update_deposit_address_titleA | Update the title of a deposit address. Args: address_id: Address id from the list/generate endpoints. title: New title; empty/null clears it. |
| nobitex_place_spot_orderB | Place a spot order. Args: type: Order side, "buy" or "sell". src_currency: Source/base currency, e.g. "btc". dst_currency: Destination/quote currency, e.g. "usdt" or "rls". amount: Order size in src_currency, as a decimal string. execution: "limit" (default), "market", "stop_limit" or "stop_market". price: Unit price; required for limit/stop_limit. Decimal string. client_order_id: Optional unique client id (max 32 chars). pro: Disable the 10-second duplicate-order check. mode: Set "oco" for an OCO order. stop_price: Trigger price for stop orders / OCO. stop_limit_price: Paired stop-limit price for OCO. |
| nobitex_get_order_statusC | Get the status of one order by id or client order id. Args: id: Server order id. client_order_id: Client order id. |
| nobitex_list_ordersB | List the user's orders with optional filters. Args: status: all, open, done or close. type: buy or sell. execution: Order execution type. trade_type: spot or margin. src_currency: Source currency, e.g. "btc". dst_currency: Destination currency, e.g. "rls". details: Detail level, 1 or 2. from_id: Only orders with id >= from_id (do not combine with page). order: Sort order. page: Page number. page_size: Items per page. |
| nobitex_cancel_orderB | Cancel a single open order. Args: order: Server order id. client_order_id: Client order id. |
| nobitex_cancel_old_ordersC | Cancel old open orders in bulk. Args: hours: Cancel orders older than this many hours. execution: Filter by execution type. trade_type: Filter by spot or margin. src_currency: Filter by source currency. dst_currency: Filter by destination currency. |
| nobitex_list_user_tradesB | List the user's executed trades. Args: src_currency: Source currency (must be paired with dst_currency). dst_currency: Destination currency (must be paired with src_currency). from_id: Minimum trade id. trade_type: buy or sell. trade_order: asc or desc (default desc). page: Page number. page_size: Items per page. |
| nobitex_list_margin_marketsB | List margin markets. Args: details: Include extra market details such as delegation limits. |
| nobitex_list_liquidity_poolsB | List active liquidity/delegation pools. |
| nobitex_transfer_between_walletsC | Transfer funds between the spot and margin wallets. Args: currency: Currency name. amount: Amount as a decimal string. src: Source wallet, "spot" or "margin". dst: Destination wallet, "spot" or "margin". |
| nobitex_get_margin_delegation_limitC | Get the delegation limit for a margin market. Args: market: Market symbol, e.g. "BTCIRT". |
| nobitex_place_margin_orderB | Place a margin (leverage) order. Args: type: Order side, "buy" or "sell". src_currency: Base currency, e.g. "btc". dst_currency: Quote currency, e.g. "usdt". amount: Order size as a decimal string. execution: "limit", "market", "stop_limit" or "stop_market". price: Limit price (required for limit/stop_limit). stop_price: Trigger price (required for stop orders / OCO). stop_limit_price: Paired stop-limit price (required for OCO). leverage: Leverage multiplier as a string, e.g. "2". client_order_id: Optional unique client id. mode: Set "oco" for an OCO order. |
| nobitex_list_positionsC | List margin positions. Args: src_currency: Base currency filter. dst_currency: Quote currency filter. status: "active" (open) or "past" (settled/closed/liquidated). page: Page number. page_size: Items per page. |
| nobitex_get_position_statusC | Get one margin position by id. |
| nobitex_close_positionC | Close (settle) a margin position. Args: position_id: Position id. execution: Close execution type; "market" closes at best price. amount: Amount to settle as a decimal string. price: Limit price for limit/stop_limit closes. stop_price: Trigger price for stop closes. stop_limit_price: Paired stop-limit price. client_order_id: Optional client order id. |
| nobitex_edit_position_collateralC | Set the total collateral of an open margin position. Args: position_id: Position id. collateral: New total collateral as a decimal string (not a delta). |
| nobitex_withdraw_cryptoB | Request a crypto withdrawal. Args: wallet: Spot wallet id. amount: Amount as a decimal string (omit for Lightning invoices). address: Destination address (omit for Lightning invoices). network: Network name; required for multi-network assets such as USDT. tag: Destination tag/memo where supported. no_tag: Set true to withdraw without a tag. invoice: Lightning invoice (BTCLN), replaces amount/address. explanations: Optional note. totp: 2FA code when the destination is not whitelisted. |
| nobitex_confirm_withdrawB | Confirm a pending withdrawal. Args: withdraw: Withdrawal id returned by the request step. otp: SMS one-time code when required. |
| nobitex_cancel_withdrawC | Cancel a pending crypto withdrawal. |
| nobitex_list_withdrawalsB | List crypto withdrawals. Args: wallet: Wallet id or "all". from_date: Start date, YYYY-MM-DD. to_date: End date, YYYY-MM-DD. page: Page number. page_size: Items per page. |
| nobitex_get_withdrawalC | Get details of one withdrawal by id. |
| nobitex_request_rial_withdrawalC | Request a rial withdrawal to a verified bank account. Args: destination_bank_account_id: Verified bank account id. amount: Total amount in rial as a decimal string (fee is deducted). |
| nobitex_get_rial_withdrawalA | Get details of one rial withdrawal (id prefixed CW/WJ/W). |
| nobitex_list_rial_withdraw_banksA | List banks supported for instant rial withdrawal. |
| nobitex_cancel_rial_withdrawalC | Cancel a pending rial withdrawal. |
| nobitex_validate_address_networkB | Validate a destination address (and optional tag) for a network. Args: network: Network name, e.g. "BSC". address: Destination wallet address. tag: Optional tag/memo. Requires a user token; Nobitex does not accept API-key auth for this endpoint. |
| nobitex_create_address_book_itemB | Create an inactive address-book item (step 1 of 2). Args: title: Address title. network: Network name. address: Destination address. tfa_code: TOTP two-factor code. tag: Optional tag/memo. |
| nobitex_confirm_address_book_itemA | Confirm an address-book item (step 2 of 2). Args: id: address_book_item_id from the create step. otp_code: OTP obtained from /v2/otp/request with usage=address_book. |
| nobitex_list_address_bookB | List address-book entries, optionally filtered by network. |
| nobitex_add_address_bookC | Add an address-book entry in one step (legacy flow). Args: title: Address title. network: Network name. address: Destination address. otp_code: SMS/email one-time code. tfa_code: TOTP two-factor code. tag: Optional tag/memo. |
| nobitex_delete_address_bookC | Delete an address-book entry by id. |
| nobitex_activate_whitelistB | Enable secure-withdrawal (whitelist) mode. |
| nobitex_deactivate_whitelistB | Disable secure-withdrawal (whitelist) mode. Args: otp_code: SMS/email one-time code. tfa_code: TOTP two-factor code. |
| nobitex_get_login_attemptsA | Get the user's login attempt history. Requires a user token; Nobitex does not accept API-key auth for this endpoint. |
| nobitex_get_emergency_cancel_codeC | Get an emergency withdrawal-cancel code. |
| nobitex_activate_emergency_cancelC | Activate emergency withdrawal cancellation. |
| nobitex_get_anti_phishingA | Get the account anti-phishing code. Requires a user token; Nobitex does not accept API-key auth for this endpoint. |
| nobitex_set_anti_phishingB | Create or change the anti-phishing code. Args: code: New anti-phishing code. otp_code: One-time code sent to the user. Requires a user token; Nobitex does not accept API-key auth for this endpoint. |
| nobitex_list_referral_linksA | List the user's referral links. Requires a user token; Nobitex does not accept API-key auth for this endpoint. |
| nobitex_create_referral_linkB | Create a referral link. Args: friend_share: Commission share granted to the invited friend. agenda: Referral program/scenario identifier. Requires a user token; Nobitex does not accept API-key auth for this endpoint. |
| nobitex_get_referral_statusB | Get the user's referrer status. Requires a user token; Nobitex does not accept API-key auth for this endpoint. |
| nobitex_set_referrerB | Register a referrer code for the user. Requires a user token; Nobitex does not accept API-key auth for this endpoint. |
| nobitex_loginA | Log in and obtain a user token (handles MFA second step). Args: username: Username/email. password: Password (first step). captcha: Captcha value; "api" for bots. remember: "yes" to issue a persistent token. mfa_token: Temporary token from the first step (MFA step). device: Device id from the first step (MFA step). otp: OTP for MFA methods 3/4. |
| nobitex_resend_login_otpB | Resend the MFA OTP for a pending login. Args: username: Username/email. mfa_token: Temporary token from the first step. device: Device id from the first step. |
| nobitex_legacy_loginB | Log in through the legacy endpoint. Args: username: Username/email. password: Password. captcha: Captcha value; "api" for bots. remember: "yes" to issue a persistent token. |
| nobitex_logoutA | Log out the current user token. Requires a user token; Nobitex does not accept API-key auth for this endpoint. |
| nobitex_create_api_keyA | Create an API key. The private key is returned only once. Args: name: Key name. permissions: Comma-separated permissions: READ,TRADE,WITHDRAW,DEPOSIT,ADDRESS_BOOK,OTP,VIP_CREDIT. description: Optional description. ip_whitelist: Optional list of allowed IPv4/IPv6 addresses (max 15). expiration_date: Optional ISO-8601 expiry in the future. totp: TOTP two-factor code (required, sent as X-TOTP). Requires a user token; Nobitex does not accept API-key auth for this endpoint. |
| nobitex_list_api_keysA | List the user's API keys. Requires a user token; Nobitex does not accept API-key auth for this endpoint. |
| nobitex_delete_api_keyB | Delete an API key. Args: public_key: Public key of the API key. totp: TOTP two-factor code (required, sent as X-TOTP). Requires a user token; Nobitex does not accept API-key auth for this endpoint. |
| nobitex_update_api_keyB | Update an API key's name, description or IP whitelist. Args: public_key: Public key of the API key. totp: TOTP two-factor code (required, sent as X-TOTP). name: New name. description: New description. ip_whitelist: New IP whitelist (max 15). Requires a user token; Nobitex does not accept API-key auth for this endpoint. |
| nobitex_get_last_week_daily_profitB | Get last week's daily profit/loss. Args: monthly: Return the last 30 days instead of one week. |
| nobitex_get_last_week_daily_total_profitB | Get last week's daily total profit/loss. Args: monthly: Return the last 30 days instead of one week. |
| nobitex_get_last_month_total_profitB | Get last month's total profit/loss. |
| nobitex_get_websocket_tokenB | Get a token for a private websocket connection. |
| nobitex_get_websocket_infoA | Describe the Nobitex websocket endpoint and available channels. MCP tools are request/response, so this returns connection details rather than streaming. Use the token tool for private channels. |
| nobitex_paper_resetA | Reset paper-trading balances, orders, trades and positions. Only available when the server runs with NOBITEX_DRY_RUN=true. |
| nobitex_paper_match_open_ordersA | Re-check open paper limit orders against the live order book and fill crossing ones. Only available when the server runs with NOBITEX_DRY_RUN=true. |
| nobitex_requestA | Call any Nobitex API path with correct authentication and signing. Use this for documented endpoints that do not yet have a dedicated tool, for example /v2/otp/request, /users/wallets/convert, /credit/*, /market/orders/batch-add, /market/orders/cancel-batch, /users/preferences. Args: method: HTTP method. path: API path beginning with "/", e.g. "/v2/otp/request". params: Query parameters. body: JSON request body. auth: "auto" (use configured credentials), "none", "token" or "key". totp: Optional X-TOTP code. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 80 tools
Most tools target distinct resources/actions, but several clusters overlap: get_wallet_balance vs get_wallets vs get_selected_wallets, generate_deposit_address vs _v2, add_address_book vs create/confirm_address_book_item, and login vs legacy_login. Descriptions help, but an agent can still misselect among these similar-looking operations.
Nearly all tools use a consistent nobitex_ prefix with snake_case and verb_noun structure. Minor deviations such as server_info, request, paper_reset, and get_websocket_info keep it from being perfect.
80 tools is far beyond a typical well-scoped MCP surface and creates a heavy selection burden. The broad exchange domain justifies many operations, but the set is still over-scoped and would benefit from consolidation.
The surface covers market data, spot and margin trading, wallets, deposits, withdrawals, bank/address book, security settings, API keys, referrals, websocket info, paper trading, and a generic request escape hatch. No obvious lifecycle gaps remain for the stated exchange domain.